Compatibilidad de modelos
| Modelo | Versión de herramienta |
|---|---|
| Modelos Claude 4.x | text_editor_20250728 |
| Claude Sonnet 3.7 (deprecado) | text_editor_20250124 |
text_editor_20250728 para modelos Claude 4 no incluye el comando undo_edit. Si requieres esta funcionalidad, necesitarás usar Claude Sonnet 3.7 (deprecado).Cuándo usar la herramienta de editor de texto
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 mediante 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
str_replace_based_edit_tool) a Claude usando la API de Mensajes.Opcionalmente puedes especificar un parámetro max_characters para controlar el truncamiento al ver archivos grandes.max_characters solo es compatible con text_editor_20250728 y versiones posteriores de la herramienta de editor de texto.Proporciona a Claude la herramienta de editor de texto y un mensaje del usuario
- Incluye la herramienta de editor de texto en tu solicitud de API
- Proporciona un mensaje 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 qué necesita examinar y usa el comando
viewpara examinar el contenido de archivos o listar el contenido de directorios - La respuesta de la API contendrá un bloque de contenido
tool_usecon 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
- Si se especificó un parámetro
max_charactersen la configuración de la herramienta, trunca el contenido del archivo a esa longitud - Devuelve los resultados a Claude continuando la conversación con un nuevo mensaje
userque contiene 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_replacepara hacer cambios oinsertpara 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 texto nuevo para reemplazarlo
Ejecuta la edición y devuelve los resultados
- Extrae la ruta del archivo, el texto antiguo y el texto nuevo 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 realizó
Comandos de la herramienta de editor de texto
La herramienta de editor de texto admite varios comandos para ver y modificar archivos:view
El comandoview permite a Claude examinar el contenido de un archivo o listar el contenido de un directorio. Puede leer el archivo completo 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): Una matriz de dos enteros que especifican los números de línea de inicio y fin a ver. Los números de línea son indexados desde 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.
Ejemplos de comandos view
Ejemplos de comandos view
str_replace
El comandostr_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, incluidos espacios en blanco e indentación)new_str: El nuevo texto a insertar en lugar del texto antiguo
Ejemplo de comando str_replace
Ejemplo de comando str_replace
create
El comandocreate 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
Ejemplo de comando create
Ejemplo de comando create
insert
El comandoinsert 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
Ejemplo de comando insert
Ejemplo de comando insert
undo_edit
El comandoundo_edit permite a Claude revertir la última edición realizada en un archivo.
text_editor_20250728.command: Debe ser “undo_edit”path: La ruta al archivo cuya última edición debe deshacerse
Ejemplo de comando undo_edit
Ejemplo de comando undo_edit
Ejemplo: Corregir un error de sintaxis con la herramienta de editor de texto
view incluye el contenido del archivo con números de línea antepuestos a cada línea (por ejemplo, “1: def is_prime(n):”). Los números de línea no son obligatorios, 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.str_replace para corregirlo: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á integrado 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_20250728" - Claude Sonnet 3.7:
type: "text_editor_20250124"
Inicializa tu implementación del editor
Maneja llamadas de herramienta del editor
Implementa medidas de seguridad
- Valida rutas de archivo para prevenir traversal de directorios
- Crea copias de seguridad antes de hacer cambios
- Maneja errores correctamente
- Implementa controles de permisos
Procesa las respuestas de Claude
- Seguridad: La herramienta tiene acceso a tu sistema de archivos local, así que implementa medidas de seguridad adecuadas.
- Copia de seguridad: Siempre crea copias de seguridad antes de permitir ediciones en archivos importantes.
- Validación: Valida todas las entradas para prevenir cambios no intencionados.
- Coincidencia única: Asegúrate de que los reemplazos coincidan exactamente en una ubicación para evitar ediciones no intencionadas.
Maneja errores
Al usar la herramienta de editor de texto, pueden ocurrir varios errores. Aquí hay orientación sobre cómo manejarlos:Archivo no encontrado
Archivo no encontrado
tool_result:Múltiples coincidencias para reemplazo
Múltiples coincidencias para reemplazo
str_replace de Claude coincide con múltiples ubicaciones en el archivo, devuelve un mensaje de error apropiado:Sin coincidencias para reemplazo
Sin coincidencias para reemplazo
str_replace de Claude no coincide con ningún texto en el archivo, devuelve un mensaje de error apropiado:Errores de permisos
Errores de permisos
Sigue las mejores prácticas de implementación
Proporciona contexto claro
Proporciona contexto claro
Sé explícito sobre rutas de archivo
Sé explícito sobre rutas de archivo
Crea copias de seguridad antes de editar
Crea copias de seguridad antes de editar
Maneja el reemplazo de texto único cuidadosamente
Maneja el reemplazo de texto único cuidadosamente
str_replace requiere una coincidencia exacta del texto a reemplazar. Tu aplicación debe asegurar que haya exactamente una coincidencia para el texto antiguo o proporcionar mensajes de error apropiados.Verifica cambios
Verifica cambios
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.x) | 700 tokens |
text_editor_20250124 (Claude Sonnet 3.7 (deprecated)) | 700 tokens |
Integra 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 herramienta con el modelo que estés usando
- Contabilizar el uso de tokens adicional para todas las herramientas incluidas en tu solicitud
Registro de cambios
| Fecha | Versión | Cambios |
|---|---|---|
| 28 de julio de 2025 | text_editor_20250728 | Lanzamiento de una herramienta de editor de texto actualizada que corrige algunos problemas y agrega un parámetro max_characters opcional. Es idéntica a text_editor_20250429 de otra manera. |
| 29 de abril de 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 otras capacidades. El nombre de la herramienta se ha actualizado para reflejar su arquitectura basada en str_replace. |
| 13 de marzo de 2025 | text_editor_20250124 | Introducción de documentación de herramienta de editor de texto independiente. Esta versión está optimizada para Claude Sonnet 3.7 pero tiene capacidades idénticas a la versión anterior. |
| 22 de octubre de 2024 | text_editor_20241022 | Lanzamiento inicial de la herramienta de editor de texto con Claude Sonnet 3.5 (retirado). 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 formas más convenientes y poderosas:- Integra con tu flujo de trabajo de desarrollo: Construye la herramienta de editor de texto en tus herramientas de desarrollo o IDE
- Crea un sistema de revisión de código: Haz que Claude revise tu código y haga mejoras
- Construye un asistente de depuración: Crea un sistema donde Claude pueda ayudarte a diagnosticar y corregir problemas en tu código
- Implementa conversión de formato de archivo: Permite que Claude te ayude a convertir archivos de un formato a otro
- Automatiza documentación: Configura flujos de trabajo para que Claude documente automáticamente tu código