Claude Academy
Cargando

La herramienta de edición de texto

Lección 325 min

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

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 nuevos archivos
  • Insertar texto en líneas específicas de un archivo

La herramienta de edición de texto está integrada en Claude, pero solo su esquema, así que tú proporcionas la implementación de la herramienta real.

Esto expande drásticamente las capacidades de Claude y esencialmente le da el poder de actuar como ingeniero de software desde el principio.

Comprendiendo los requisitos de implementación

Aquí es donde las cosas se ponen un poco confusas: aunque el esquema de la herramienta está integrado en Claude, aún necesitas proporcionar la implementación real. Piénsalo de esta manera: Claude sabe cómo pedir operaciones de archivos, pero tú necesitas escribir el código que realmente realiza esas operaciones.

El esquema JSON text_editor_tool_schema y un cuadro de "Función" que muestra tres signos de interrogación, la función que debes escribir.

Cuando usas herramientas personalizadas, normalmente 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 para crear archivos, leer directorios, reemplazar texto, etc.

Versiones del esquema

Sí necesitas incluir un pequeño fragmento de esquema cuando usas la herramienta de edición de texto, y el esquema exacto depende del modelo de Claude que estés usando:

python
def get_text_edit_schema(model):
    if model.startswith("claude-haiku-4-5"):
        return {
            "type": "text_editor_20250728",
            "name": "str_replace_based_edit_tool",
        }

Claude expande el pequeño fragmento de esquema en uno mucho más largo con "command", "path", view_range, old_str, new_str y file_text.

Claude expande automáticamente este pequeño esquema en una especificación mucho más grande y detallada que incluye todos los parámetros y operaciones disponibles.

Ejemplo práctico

Veamos la herramienta de edición de texto en acción. Cuando le pides a Claude que trabaje con archivos, usará 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:

  1. Usar la herramienta de edición de texto para ver el archivo
  2. Leer el contenido
  3. Proporcionarte un resumen

Puedes llevar esto más lejos y pedirle a Claude que modifique archivos. Por ejemplo: "Abre el archivo ./main.py y escribe una función para calcular pi hasta el 5.º dígito. Luego crea un archivo ./test.py para probar tu implementación".

Claude hará lo siguiente:

  1. Ver el archivo main.py existente
  2. Reemplazar su contenido con una nueva implementación que incluya la función de cálculo de pi
  3. Crear un nuevo archivo test.py con las pruebas unitarias apropiadas

¿Por qué usar la herramienta de edición de texto?

Puede que 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 construyendo 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 con IA dentro de tus propias aplicaciones, dándole a Claude la capacidad de ser un verdadero asistente de programación que puede leer, escribir y modificar archivos en tu sistema de archivos.