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.
text_editor_20250728
text_editor_20250124
text_editor_20241022
computer-use-2024-10-22
cuando se usa la herramienta de editor de texto.La herramienta de editor de texto está generalmente disponible en los modelos Claude 4 y Claude Sonnet 3.7.text_editor_20250728
para los modelos Claude 4 no incluye el comando undo_edit
. Si requieres esta funcionalidad, necesitarás usar Claude Sonnet 3.7 o Sonnet 3.5 con sus respectivas versiones de herramientas.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 prompt del usuario
Claude usa la herramienta para examinar archivos o directorios
view
para examinar el contenido de archivos o listar el contenido de directoriostool_use
con el comando view
Ejecuta el comando view y devuelve los resultados
max_characters
en la configuración de la herramienta, trunca el contenido del archivo a esa longituduser
que contenga un bloque de contenido tool_result
Claude usa la herramienta para modificar archivos
str_replace
para hacer cambios o insert
para agregar texto en un número de línea específico.str_replace
, Claude construye una solicitud de uso de herramienta correctamente formateada con el texto antiguo y el nuevo texto para reemplazarloEjecuta la edición y devuelve los resultados
Claude proporciona su análisis y explicación
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.Ejemplos de comandos view
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 antiguoEjemplo de comando str_replace
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 archivoEjemplo de comando create
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 insertarEjemplo de comando insert
undo_edit
permite a Claude revertir la última edición hecha a un archivo.
text_editor_20250728
.command
: Debe ser “undo_edit”path
: La ruta al archivo cuya última edición debe deshacerseEjemplo de comando undo_edit
view
incluye 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 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.str_replace
para corregirlo:type: "text_editor_20250728"
type: "text_editor_20250124"
type: "text_editor_20241022"
Inicializa tu implementación del editor
Maneja las llamadas de herramienta del editor
Implementa medidas de seguridad
Procesa las respuestas de Claude
Archivo no encontrado
tool_result
: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
str_replace
de Claude no coincide con ningún texto en el archivo, devuelve un mensaje de error apropiado:Errores de permisos
Proporcionar contexto claro
Ser explícito sobre rutas de archivos
Crear respaldos antes de editar
Manejar reemplazo de texto único cuidadosamente
str_replace
requiere una coincidencia exacta para el texto a ser reemplazado. Tu aplicación debería asegurar que hay exactamente una coincidencia para el texto antiguo o proporcionar mensajes de error apropiados.Verificar cambios
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 (deprecated)) | 700 tokens |
Fecha | Versión | Cambios |
---|---|---|
28 de julio, 2025 | text_editor_20250728 | Lanzamiento de una herramienta de editor de texto actualizada que corrige algunos problemas y agrega un parámetro opcional max_characters . Por lo demás es idéntica a text_editor_20250429 . |
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 otras 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 (obsoleto). Proporciona capacidades para ver, crear y editar archivos a través de los comandos view , create , str_replace , insert y undo_edit . |