Herramienta de editor de texto
Claude puede usar una herramienta de editor de texto definida por Anthropic para ver y modificar archivos de texto, ayudándote a depurar, corregir y mejorar tu código u otros documentos de texto.
Claude puede usar una herramienta de editor de texto definida por Anthropic para ver y modificar archivos de texto, ayudándote a depurar, corregir y mejorar tu código u otros documentos de texto. Esto permite a Claude interactuar directamente con tus archivos, proporcionando asistencia práctica en lugar de solo sugerir cambios.
Antes de usar la herramienta de editor de texto
Usa un modelo compatible
La herramienta de editor de texto de Anthropic está disponible para múltiples modelos de Claude:
- Claude 4 Opus & Sonnet:
text_editor_20250429
- Claude Sonnet 3.7:
text_editor_20250124
- Claude Sonnet 3.5:
text_editor_20241022
Claude Sonnet 3.5 requiere el encabezado beta computer-use-2024-10-22
al usar la herramienta de editor de texto.
La herramienta de editor de texto está generalmente disponible en Claude 4 y Sonnet 3.7.
El más nuevo text_editor_20250429
para modelos Claude 4 no incluye el comando undo_edit
. Si requieres esta funcionalidad, necesitarás usar Claude 3.7 o Sonnet 3.5 con sus respectivas versiones de herramientas.
Evalúa si tu caso de uso es adecuado
Algunos ejemplos de cuándo usar la herramienta de editor de texto son:
- Depuración de código: Haz que Claude identifique y corrija errores en tu código, desde errores de sintaxis hasta problemas de lógica.
- Refactorización de código: Permite que Claude mejore la estructura, legibilidad y rendimiento de tu código a través de ediciones dirigidas.
- Generación de documentación: Pide a Claude que agregue docstrings, comentarios o archivos README a tu base de código.
- Creación de pruebas: Haz que Claude cree pruebas unitarias para tu código basándose en su comprensión de la implementación.
Usar la herramienta de editor de texto
Proporciona la herramienta de editor de texto (llamada str_replace_based_edit_tool
) a Claude usando la API de Messages:
Proporciona la herramienta de editor de texto (llamada str_replace_based_edit_tool
) a Claude usando la API de Messages:
Proporciona la herramienta de editor de texto (llamada str_replace_editor
) a Claude usando la API de Messages:
Proporciona la herramienta de editor de texto (llamada str_replace_editor
) a Claude usando la API de Messages:
La herramienta de editor de texto se puede usar de la siguiente manera:
Proporciona a Claude la herramienta de editor de texto y un prompt del usuario
- Incluye la herramienta de editor de texto en tu solicitud de API
- Proporciona un prompt del usuario que pueda requerir examinar o modificar archivos, como “¿Puedes corregir el error de sintaxis en mi código?”
Claude usa la herramienta para examinar archivos o directorios
- Claude evalúa lo que necesita examinar y usa el comando
view
para examinar el contenido de archivos o listar el contenido de directorios - La respuesta de la API contendrá un bloque de contenido
tool_use
con el comandoview
Ejecuta el comando view y devuelve los resultados
- Extrae la ruta del archivo o directorio de la solicitud de uso de herramienta de Claude
- Lee el contenido del archivo o lista el contenido del directorio y devuélvelos a Claude
- Devuelve los resultados a Claude continuando la conversación con un nuevo mensaje
user
que contenga un bloque de contenidotool_result
Claude usa la herramienta para modificar archivos
- Después de examinar el archivo o directorio, Claude puede usar un comando como
str_replace
para hacer cambios oinsert
para agregar texto en un número de línea específico. - Si Claude usa el comando
str_replace
, Claude construye una solicitud de uso de herramienta correctamente formateada con el texto antiguo y el nuevo texto para reemplazarlo
Ejecuta la edición y devuelve los resultados
- Extrae la ruta del archivo, el texto antiguo y el nuevo texto de la solicitud de uso de herramienta de Claude
- Realiza el reemplazo de texto en el archivo
- Devuelve los resultados a Claude
Claude proporciona su análisis y explicación
- Después de examinar y posiblemente editar los archivos, Claude proporciona una explicación completa de lo que encontró y qué cambios hizo
Comandos de la herramienta de editor de texto
La herramienta de editor de texto admite varios comandos para ver y modificar archivos:
view
El comando view
permite a Claude examinar el contenido de un archivo o listar el contenido de un directorio. Puede leer todo el archivo o un rango específico de líneas.
Parámetros:
command
: Debe ser “view”path
: La ruta al archivo o directorio a verview_range
(opcional): Un array de dos enteros especificando los números de línea de inicio y fin a ver. Los números de línea están indexados en 1, y -1 para la línea final significa leer hasta el final del archivo. Este parámetro solo se aplica al ver archivos, no directorios.
str_replace
El comando str_replace
permite a Claude reemplazar una cadena específica en un archivo con una nueva cadena. Esto se usa para hacer ediciones precisas.
Parámetros:
command
: Debe ser “str_replace”path
: La ruta al archivo a modificarold_str
: El texto a reemplazar (debe coincidir exactamente, incluyendo espacios en blanco e indentación)new_str
: El nuevo texto a insertar en lugar del texto antiguo
create
El comando create
permite a Claude crear un nuevo archivo con contenido especificado.
Parámetros:
command
: Debe ser “create”path
: La ruta donde se debe crear el nuevo archivofile_text
: El contenido a escribir en el nuevo archivo
insert
El comando insert
permite a Claude insertar texto en una ubicación específica en un archivo.
Parámetros:
command
: Debe ser “insert”path
: La ruta al archivo a modificarinsert_line
: El número de línea después del cual insertar el texto (0 para el inicio del archivo)new_str
: El texto a insertar
undo_edit
El comando undo_edit
permite a Claude revertir la última edición hecha a un archivo.
Este comando solo está disponible en Claude Sonnet 3.7 y Claude Sonnet 3.5. No está soportado en modelos Claude 4 usando el text_editor_20250429
.
Parámetros:
command
: Debe ser “undo_edit”path
: La ruta al archivo cuya última edición debe deshacerse
Ejemplo: Corrigiendo un error de sintaxis con la herramienta de editor de texto
Este ejemplo demuestra cómo Claude 4 usa la herramienta de editor de texto para corregir un error de sintaxis en un archivo Python.
Primero, tu aplicación proporciona a Claude la herramienta de editor de texto y un prompt para corregir un error de sintaxis:
Claude usará la herramienta de editor de texto primero para ver el archivo:
Tu aplicación debería entonces leer el archivo y devolver su contenido a Claude:
Números de línea
En el ejemplo anterior, el resultado de la herramienta view
incluye el contenido del archivo con números de línea antepuestos a cada línea (ej., “1: def is_prime(n):”). Los números de línea no son requeridos, pero son esenciales para usar exitosamente el parámetro view_range
para examinar secciones específicas de archivos y el parámetro insert_line
para agregar contenido en ubicaciones precisas.
Claude identificará el error de sintaxis y usará el comando str_replace
para corregirlo:
Tu aplicación debería entonces hacer la edición y devolver el resultado:
Finalmente, Claude proporcionará una explicación completa de la corrección:
Este ejemplo demuestra cómo Claude 4 usa la herramienta de editor de texto para corregir un error de sintaxis en un archivo Python.
Primero, tu aplicación proporciona a Claude la herramienta de editor de texto y un prompt para corregir un error de sintaxis:
Claude usará la herramienta de editor de texto primero para ver el archivo:
Tu aplicación debería entonces leer el archivo y devolver su contenido a Claude:
Números de línea
En el ejemplo anterior, el resultado de la herramienta view
incluye el contenido del archivo con números de línea antepuestos a cada línea (ej., “1: def is_prime(n):”). Los números de línea no son requeridos, pero son esenciales para usar exitosamente el parámetro view_range
para examinar secciones específicas de archivos y el parámetro insert_line
para agregar contenido en ubicaciones precisas.
Claude identificará el error de sintaxis y usará el comando str_replace
para corregirlo:
Tu aplicación debería entonces hacer la edición y devolver el resultado:
Finalmente, Claude proporcionará una explicación completa de la corrección:
Este ejemplo demuestra cómo Claude Sonnet 3.7 usa la herramienta de editor de texto para corregir un error de sintaxis en un archivo Python.
Primero, tu aplicación proporciona a Claude la herramienta de editor de texto y un prompt para corregir un error de sintaxis:
Los ejemplos de Claude Sonnet 3.7 siguen el mismo formato que los ejemplos de Claude 4 anteriores, usando las mismas llamadas de herramientas y respuestas pero con el tipo de herramienta text_editor_20250124
y el nombre str_replace_editor
.
Implementar la herramienta de editor de texto
La herramienta de editor de texto se implementa como una herramienta sin esquema. Al usar esta herramienta, no necesitas proporcionar un esquema de entrada como con otras herramientas; el esquema está incorporado en el modelo de Claude y no se puede modificar.
El tipo de herramienta depende de la versión del modelo:
- Claude 4:
type: "text_editor_20250429"
- Claude Sonnet 3.7:
type: "text_editor_20250124"
- Claude Sonnet 3.5:
type: "text_editor_20241022"
Inicializa tu implementación del editor
Crea funciones auxiliares para manejar operaciones de archivos como leer, escribir y modificar archivos. Considera implementar funcionalidad de respaldo para recuperarse de errores.
Maneja las llamadas de herramientas del editor
Crea una función que procese las llamadas de herramientas de Claude basándose en el tipo de comando:
Implementa medidas de seguridad
Agrega validación y verificaciones de seguridad:
- Valida rutas de archivos para prevenir traversal de directorios
- Crea respaldos antes de hacer cambios
- Maneja errores con gracia
- Implementa verificaciones de permisos
Procesa las respuestas de Claude
Extrae y maneja las llamadas de herramientas de las respuestas de Claude:
Al implementar la herramienta de editor de texto, ten en cuenta:
- Seguridad: La herramienta tiene acceso a tu sistema de archivos local, así que implementa medidas de seguridad apropiadas.
- Respaldo: Siempre crea respaldos antes de permitir ediciones a archivos importantes.
- Validación: Valida todas las entradas para prevenir cambios no deseados.
- Coincidencia única: Asegúrate de que los reemplazos coincidan exactamente con una ubicación para evitar ediciones no deseadas.
Manejar errores
Al usar la herramienta de editor de texto, pueden ocurrir varios errores. Aquí hay orientación sobre cómo manejarlos:
Sigue las mejores prácticas de implementación
Precios y uso de tokens
The text editor tool uses the same pricing structure as other tools used with Claude. It follows the standard input and output token pricing based on the Claude model you’re using.
In addition to the base tokens, the following additional input tokens are needed for the text editor tool:
Tool | Additional input tokens |
---|---|
text_editor_20250429 (Claude 4) | 700 tokens |
text_editor_20250124 (Claude Sonnet 3.7) | 700 tokens |
text_editor_20241022 (Claude Sonnet 3.5) | 700 tokens |
Para información más detallada sobre precios de herramientas, consulta Precios de uso de herramientas.
Integrar la herramienta de editor de texto con otras herramientas
La herramienta de editor de texto se puede usar junto con otras herramientas de Claude. Al combinar herramientas, asegúrate de:
- Hacer coincidir la versión de la herramienta con el modelo que estás usando
- Considerar el uso adicional de tokens para todas las herramientas incluidas en tu solicitud
Registro de cambios
Fecha | Versión | Cambios |
---|---|---|
29 de abril, 2025 | text_editor_20250429 | Lanzamiento de la Herramienta de editor de texto para Claude 4. Esta versión elimina el comando undo_edit pero mantiene todas las demás capacidades. El nombre de la herramienta ha sido actualizado para reflejar su arquitectura basada en str_replace. |
13 de marzo, 2025 | text_editor_20250124 | Introducción de documentación independiente de la Herramienta de editor de texto. Esta versión está optimizada para Claude Sonnet 3.7 pero tiene capacidades idénticas a la versión anterior. |
22 de octubre, 2024 | text_editor_20241022 | Lanzamiento inicial de la Herramienta de editor de texto con Claude Sonnet 3.5. Proporciona capacidades para ver, crear y editar archivos a través de los comandos view , create , str_replace , insert y undo_edit . |
Próximos pasos
Aquí hay algunas ideas sobre cómo usar la herramienta de editor de texto de maneras más convenientes y poderosas:
- Integrar con tu flujo de trabajo de desarrollo: Incorpora la herramienta de editor de texto en tus herramientas de desarrollo o IDE
- Crear un sistema de revisión de código: Haz que Claude revise tu código y haga mejoras
- Construir un asistente de depuración: Crea un sistema donde Claude pueda ayudarte a diagnosticar y corregir problemas en tu código
- Implementar conversión de formato de archivos: Permite que Claude te ayude a convertir archivos de un formato a otro
- Automatizar documentación: Configura flujos de trabajo para que Claude documente automáticamente tu código
Mientras construyes aplicaciones con la herramienta de editor de texto, estamos emocionados de ver cómo aprovechas las capacidades de Claude para mejorar tu flujo de trabajo de desarrollo y productividad.