Nota importante: las cadenas de versión de la herramienta para todas las versiones del modelo se pueden encontrar aquí: https://platform.claude.com/docs/en/agents-and-tools/tool-use/text-editor-tool(se abre en una pestaña nueva)
Claude viene con una herramienta integrada que no necesitas crear desde cero: la herramienta de edición de texto. Esta herramienta le da a Claude la capacidad de trabajar con archivos y directorios tal como lo harías en un editor de texto estándar.
Qué puede hacer la herramienta de edición de texto
La herramienta de edición de texto proporciona a Claude un conjunto completo de capacidades de manipulación de archivos:
- Ver el contenido de un archivo o directorio
- Ver rangos específicos de líneas en un archivo
- Reemplazar texto en un archivo
- Crear archivos nuevos
- Insertar texto en líneas específicas de un archivo

Esto amplía enormemente las capacidades de Claude y, en esencia, le da el poder de actuar como ingeniero de software desde el primer momento.
Entendiendo los requisitos de implementación
Aquí es donde las cosas se vuelven un poco confusas: aunque el esquema de la herramienta está integrado en Claude, de todos modos necesitas proporcionar la implementación real. Piénsalo así: Claude sabe cómo solicitar operaciones de archivos, pero tú necesitas escribir el código que realmente realiza esas operaciones.

Cuando usas otras herramientas, escribes tanto el esquema JSON como la implementación de la función. Con la herramienta de edición de texto, Claude proporciona el conocimiento del esquema, pero tú debes escribir funciones para manejar las solicitudes de Claude de crear archivos, leer directorios, reemplazar texto, etc.
Versiones del esquema
Aunque el esquema principal está integrado en Claude, sí necesitas incluir un pequeño fragmento de esquema al hacer solicitudes. El esquema exacto depende de qué modelo de Claude estés usando:
def get_text_edit_schema(model):
if model.startswith("claude-3"):
return {
"type": "text_editor_20250124",
"name": "str_replace_editor",
}
else:
return {
"type": "text_editor_20250728",
"name": "str_replace_based_edit_tool",
}
Claude ve este pequeño esquema y automáticamente lo expande a la especificación completa de la herramienta de edición de texto detrás de escena.
Ejemplo práctico
Veamos la herramienta de edición de texto en acción. Cuando le pides a Claude que trabaje con archivos, utilizará la herramienta para leer, modificar y crear archivos según sea necesario.
Por ejemplo, si le pides a Claude que "Abra el archivo ./main.py y resuma su contenido", Claude hará lo siguiente:
- Usará la herramienta de edición de texto para ver el archivo
- Leerá el contenido
- Te proporcionará un resumen
Puedes llevar esto más lejos pidiéndole a Claude que modifique archivos. Por ejemplo: "Abre el archivo ./main.py y escribe una función para calcular pi hasta el quinto dígito. Luego crea un archivo ./test.py para probar tu implementación."
Claude hará lo siguiente:
- Verá el archivo main.py existente
- Reemplazará su contenido con una nueva implementación que incluya la función de cálculo de pi
- Creará un nuevo archivo test.py con pruebas unitarias apropiadas
¿Por qué usar la herramienta de edición de texto?
Quizás te preguntes por qué existe esta herramienta cuando los editores de código modernos ya tienen asistentes de IA integrados. La herramienta de edición de texto se vuelve valiosa en escenarios donde:
- Estás creando aplicaciones que necesitan editar archivos de forma programática
- Estás trabajando en entornos sin acceso a editores de código con todas las funciones
- Quieres integrar capacidades de edición de archivos directamente en tus aplicaciones impulsadas por Claude
En esencia, la herramienta de edición de texto te permite replicar gran parte de la funcionalidad de un sofisticado editor de código impulsado por IA dentro de tus propias aplicaciones, dándote un control detallado sobre cómo Claude interactúa con tu sistema de archivos.