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. Esto permite que Claude interactúe 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 solo está disponible para Claude 3.5 Sonnet y Claude 3.7 Sonnet:

• Claude 3.7 Sonnet: text_editor_20250124
• Claude 3.5 Sonnet: text_editor_20241022

Ambas versiones proporcionan capacidades idénticas - la versión que uses debe coincidir con el modelo con el que estés trabajando.

​

Evalúa si se ajusta a tu caso de uso

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 específicas.
• 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.

​

Usa la herramienta de editor de texto

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:

​

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 el archivo completo o un rango específico de líneas.

Parámetros:

• command: Debe ser “view”
• path: La ruta al archivo o directorio para ver
• view_range (opcional): Un array de dos enteros que especifica los números de línea inicial y final para ver. Los números de línea comienzan 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.

// Ejemplo para ver un archivo
{
  "type": "tool_use",
  "id": "toolu_01A09q90qw90lq917835lq9",
  "name": "str_replace_editor",
  "input": {
    "command": "view",
    "path": "primes.py"
  }
}

// Ejemplo para ver un directorio
{
  "type": "tool_use",
  "id": "toolu_02B19r91rw91mr917835mr9",
  "name": "str_replace_editor",
  "input": {
    "command": "view",
    "path": "src/"
  }
}

​

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 modificar
• old_str: El texto a reemplazar (debe coincidir exactamente, incluyendo espacios en blanco y sangría)
• new_str: El nuevo texto a insertar en lugar del texto antiguo

{
  "type": "tool_use",
  "id": "toolu_01A09q90qw90lq917835lq9",
  "name": "str_replace_editor",
  "input": {
    "command": "str_replace",
    "path": "primes.py",
    "old_str": "for num in range(2, limit + 1)",
    "new_str": "for num in range(2, limit + 1):"
  }
}

​

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 archivo
• file_text: El contenido a escribir en el nuevo archivo

{
  "type": "tool_use",
  "id": "toolu_01A09q90qw90lq917835lq9",
  "name": "str_replace_editor",
  "input": {
    "command": "create",
    "path": "test_primes.py",
    "file_text": "import unittest\nimport primes\n\nclass TestPrimes(unittest.TestCase):\n    def test_is_prime(self):\n        self.assertTrue(primes.is_prime(2))\n        self.assertTrue(primes.is_prime(3))\n        self.assertFalse(primes.is_prime(4))\n\nif __name__ == '__main__':\n    unittest.main()"
  }
}

​

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 modificar
• insert_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

{
  "type": "tool_use",
  "id": "toolu_01A09q90qw90lq917835lq9",
  "name": "str_replace_editor",
  "input": {
    "command": "insert",
    "path": "primes.py",
    "insert_line": 0,
    "new_str": "\"\"\"Módulo para trabajar con números primos.\n\nEste módulo proporciona funciones para verificar si un número es primo\ny para generar una lista de números primos hasta un límite dado.\n\"\"\"\n"
  }
}

​

undo_edit

El comando undo_edit permite a Claude deshacer la última edición realizada en un archivo.

Parámetros:

• command: Debe ser “undo_edit”
• path: La ruta al archivo cuya última edición debe deshacerse

{
  "type": "tool_use",
  "id": "toolu_01A09q90qw90lq917835lq9",
  "name": "str_replace_editor",
  "input": {
    "command": "undo_edit",
    "path": "primes.py"
  }
}

​

Ejemplo: Corregir un error de sintaxis con la herramienta de editor de texto

Este ejemplo demuestra cómo Claude 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 mensaje para corregir un error de sintaxis:

Claude usará la herramienta de editor de texto primero para ver el archivo:

{
  "id": "msg_01XAbCDeFgHiJkLmNoPQrStU",
  "model": "claude-3-7-sonnet-20250219",
  "stop_reason": "tool_use",
  "role": "assistant",
  "content": [
    {
      "type": "text",
      "text": "Te ayudaré a corregir el error de sintaxis en tu archivo primes.py. Primero, déjame echar un vistazo al archivo para identificar el problema."
    },
    {
      "type": "tool_use",
      "id": "toolu_01AbCdEfGhIjKlMnOpQrStU",
      "name": "str_replace_editor",
      "input": {
        "command": "view",
        "path": "primes.py"
      }
    }
  ]
}

Tu aplicación debe entonces leer el archivo y devolver su contenido a Claude:

Claude identificará el error de sintaxis y usará el comando str_replace para corregirlo:

{
  "id": "msg_01VwXyZAbCdEfGhIjKlMnO",
  "model": "claude-3-7-sonnet-20250219",
  "stop_reason": "tool_use",
  "role": "assistant",
  "content": [
    {
      "type": "text",
      "text": "Encontré el error de sintaxis en tu archivo primes.py. En la función `get_primes`, falta dos puntos (:) al final de la línea del bucle for. Déjame corregir eso por ti."
    },
    {
      "type": "tool_use",
      "id": "toolu_01PqRsTuVwXyZAbCdEfGh",
      "name": "str_replace_editor",
      "input": {
        "command": "str_replace",
        "path": "primes.py",
        "old_str": "    for num in range(2, limit + 1)",
        "new_str": "    for num in range(2, limit + 1):"
      }
    }
  ]
}

Tu aplicación debe entonces hacer la edición y devolver el resultado:

Finalmente, Claude proporcionará una explicación completa de la corrección:

{
  "id": "msg_01IjKlMnOpQrStUvWxYzAb",
  "model": "claude-3-7-sonnet-20250219",
  "stop_reason": "end_turn",
  "role": "assistant",
  "content": [
    {
      "type": "text",
      "text": "He corregido el error de sintaxis en tu archivo primes.py. El problema estaba en la función `get_primes` en la línea 19. Faltaban los dos puntos (:) al final de la línea del bucle for.\n\nAquí está lo que cambié:\n\nDe:\n```python\nfor num in range(2, limit + 1)\n```\n\nA:\n```python\nfor num in range(2, limit + 1):\n```\n\nEn Python, se requieren dos puntos al final de las declaraciones que inician un nuevo bloque de código, como bucles for, declaraciones if, definiciones de funciones, etc. Sin los dos puntos, Python genera un error de sintaxis porque no sabe dónde comienza el bloque de código.\n\nTu código ahora debería ejecutarse correctamente. La función generará adecuadamente una lista de números primos hasta el límite especificado."
    }
  ]
}

​

Implementar la herramienta de editor de texto

La herramienta de editor de texto se implementa como una herramienta sin esquema, identificada por type: "text_editor_20250124". 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.

def handle_editor_tool(tool_call):
    input_params = tool_call.input
    command = input_params.get('command', '')
    file_path = input_params.get('path', '')
    
    if command == 'view':
        # Lee y devuelve el contenido del archivo
        pass
    elif command == 'str_replace':
        # Reemplaza texto en el archivo
        pass
    elif command == 'create':
        # Crea nuevo archivo
        pass
    elif command == 'insert':
        # Inserta texto en ubicación
        pass
    elif command == 'undo_edit':
        # Restaura desde respaldo
        pass

# Procesa el uso de herramienta en la respuesta de Claude
for content in response.content:
    if content.type == "tool_use":
        # Ejecuta la herramienta según el comando
        result = handle_editor_tool(content)
        
        # Devuelve resultado a Claude
        tool_result = {
            "type": "tool_result",
            "tool_use_id": content.id,
            "content": result
        }

​

Manejo de errores

Al usar la herramienta de editor de texto, pueden ocurrir varios errores. Aquí hay una guía sobre cómo manejarlos:

{
  "role": "user",
  "content": [
    {
      "type": "tool_result",
      "tool_use_id": "toolu_01A09q90qw90lq917835lq9",
      "content": "Error: Archivo no encontrado",
      "is_error": true
    }
  ]
}

{
  "role": "user",
  "content": [
    {
      "type": "tool_result",
      "tool_use_id": "toolu_01A09q90qw90lq917835lq9",
      "content": "Error: Se encontraron 3 coincidencias para el texto de reemplazo. Por favor proporciona más contexto para hacer una coincidencia única.",
      "is_error": true
    }
  ]
}

{
  "role": "user",
  "content": [
    {
      "type": "tool_result",
      "tool_use_id": "toolu_01A09q90qw90lq917835lq9",
      "content": "Error: No se encontró coincidencia para el reemplazo. Por favor verifica tu texto e intenta de nuevo.",
      "is_error": true
    }
  ]
}

{
  "role": "user",
  "content": [
    {
      "type": "tool_result",
      "tool_use_id": "toolu_01A09q90qw90lq917835lq9",
      "content": "Error: Permiso denegado. No se puede escribir en el archivo.",
      "is_error": true
    }
  ]
}

​

Sigue las mejores prácticas de implementación

def backup_file(file_path):
    """Crea un respaldo de un archivo antes de editarlo."""
    backup_path = f"{file_path}.backup"
    if os.path.exists(file_path):
        with open(file_path, 'r') as src, open(backup_path, 'w') as dst:
            dst.write(src.read())

def safe_replace(file_path, old_text, new_text):
    """Reemplaza texto solo si hay exactamente una coincidencia."""
    with open(file_path, 'r') as f:
        content = f.read()
    
    count = content.count(old_text)
    if count == 0:
        return "Error: No se encontró coincidencia"
    elif count > 1:
        return f"Error: Se encontraron {count} coincidencias"
    else:
        new_content = content.replace(old_text, new_text)
        with open(file_path, 'w') as f:
            f.write(new_content)
        return "Se reemplazó el texto exitosamente"

def verify_changes(file_path):
    """Ejecuta pruebas o verificaciones después de hacer cambios."""
    try:
        # Para archivos Python, verifica errores de sintaxis
        if file_path.endswith('.py'):
            import ast
            with open(file_path, 'r') as f:
                ast.parse(f.read())
            return "Verificación de sintaxis exitosa"
    except Exception as e:
        return f"La verificación falló: {str(e)}"

​

Precios y uso de tokens

La herramienta de editor de texto usa la misma estructura de precios que otras herramientas usadas con Claude. Sigue el precio estándar de tokens de entrada y salida basado en el modelo de Claude que estés usando.

Además de los tokens base, se necesitan los siguientes tokens de entrada adicionales para la herramienta de editor de texto:

Para información más detallada sobre precios de herramientas, consulta Precios de uso de herramientas.

​

Integra la herramienta de editor de texto con el uso de computadora

La herramienta de editor de texto se puede usar junto con la herramienta de uso de computadora y otras herramientas definidas por Anthropic. Al combinar estas herramientas, necesitarás:

1. Incluir el encabezado beta apropiado (si se usa con uso de computadora)
2. Hacer coincidir la versión de la herramienta con el modelo que estés usando
3. Tener en cuenta el uso adicional de tokens para todas las herramientas incluidas en tu solicitud

Para más información sobre el uso de la herramienta de editor de texto en un contexto de uso de computadora, consulta Uso de computadora.

​

Registro de cambios

​

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: Incorpora 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 formatos de archivo: Permite que Claude te ayude a convertir archivos de un formato a otro
• Automatiza la 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 y productividad de desarrollo.