Loading...
    • Guía para desarrolladores
    • Referencia de API
    • MCP
    • Recursos
    • Notas de la versión
    Search...
    ⌘K
    Primeros pasos
    Introducción a ClaudeInicio rápido
    Modelos y precios
    Descripción general de modelosElegir un modeloNovedades en Claude 4.5Migración a Claude 4.5Deprecación de modelosPrecios
    Construir con Claude
    Descripción general de característicasUsar la API de MessagesVentanas de contextoMejores prácticas de prompting
    Capacidades
    Almacenamiento en caché de promptsEdición de contextoPensamiento extendidoEsfuerzoStreaming de MessagesProcesamiento por lotesCitasSoporte multilingüeConteo de tokensEmbeddingsVisiónSoporte de PDFAPI de FilesResultados de búsquedaSalidas estructuradas
    Herramientas
    Descripción generalCómo implementar el uso de herramientasStreaming de herramientas de grano finoHerramienta BashHerramienta de ejecución de códigoLlamada de herramientas programáticaHerramienta de uso de computadoraHerramienta de editor de textoHerramienta de búsqueda webHerramienta de búsqueda webHerramienta de memoriaHerramienta de búsqueda de herramientas
    Agent Skills
    Descripción generalInicio rápidoMejores prácticasUsar Skills con la API
    Agent SDK
    Descripción generalInicio rápidoSDK de TypeScriptTypeScript V2 (vista previa)SDK de PythonGuía de migración
    MCP en la API
    Conector MCPServidores MCP remotos
    Claude en plataformas de terceros
    Amazon BedrockMicrosoft FoundryVertex AI
    Ingeniería de prompts
    Descripción generalGenerador de promptsUsar plantillas de promptsMejorador de promptsSer claro y directoUsar ejemplos (prompting multishot)Dejar que Claude piense (CoT)Usar etiquetas XMLDar un rol a Claude (prompts del sistema)Rellenar la respuesta de ClaudeEncadenar prompts complejosConsejos de contexto largoConsejos de pensamiento extendido
    Probar y evaluar
    Definir criterios de éxitoDesarrollar casos de pruebaUsar la herramienta de evaluaciónReducir latencia
    Fortalecer protecciones
    Reducir alucinacionesAumentar consistencia de salidaMitigar ataques de jailbreakRechazos de streamingReducir fuga de promptsMantener a Claude en personaje
    Administración y monitoreo
    Descripción general de Admin APIAPI de uso y costoAPI de Claude Code Analytics
    Console
    Log in
    Loading...
    Loading...
    Loading...
    Loading...
    Loading...
    Loading...
    Loading...
    Loading...
    Loading...
    Loading...
    Loading...
    Loading...
    Loading...
    Loading...
    Loading...
    Loading...

    Solutions

    • AI agents
    • Code modernization
    • Coding
    • Customer support
    • Education
    • Financial services
    • Government
    • Life sciences

    Partners

    • Amazon Bedrock
    • Google Cloud's Vertex AI

    Learn

    • Blog
    • Catalog
    • Courses
    • Use cases
    • Connectors
    • Customer stories
    • Engineering at Anthropic
    • Events
    • Powered by Claude
    • Service partners
    • Startups program

    Company

    • Anthropic
    • Careers
    • Economic Futures
    • Research
    • News
    • Responsible Scaling Policy
    • Security and compliance
    • Transparency

    Learn

    • Blog
    • Catalog
    • Courses
    • Use cases
    • Connectors
    • Customer stories
    • Engineering at Anthropic
    • Events
    • Powered by Claude
    • Service partners
    • Startups program

    Help and security

    • Availability
    • Status
    • Support
    • Discord

    Terms and policies

    • Privacy policy
    • Responsible disclosure policy
    • Terms of service: Commercial
    • Terms of service: Consumer
    • Usage policy
    Herramientas

    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.

    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.

    Compatibilidad de modelos

    ModeloVersión de herramienta
    Modelos Claude 4.xtext_editor_20250728
    Claude Sonnet 3.7 (deprecated)text_editor_20250124

    La herramienta text_editor_20250728 para modelos Claude 4 no incluye el comando undo_edit. Si requieres esta funcionalidad, necesitarás usar Claude Sonnet 3.7 (deprecated).

    Las versiones antiguas de herramientas no están garantizadas para ser compatibles hacia atrás con modelos más nuevos. Siempre usa la versión de herramienta que corresponda a tu versión de modelo.

    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 de tu código, legibilidad y rendimiento a través de 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

    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 a ver
    • view_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.

    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 e indentación)
    • new_str: El nuevo texto a insertar en lugar del texto antiguo

    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

    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

    undo_edit

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

    Este comando solo está disponible en Claude Sonnet 3.7 (deprecated). No es compatible con modelos Claude 4 que usan text_editor_20250728.

    Parámetros:

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

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

    Implementar la herramienta del editor de texto

    La herramienta del editor de texto se implementa como una herramienta sin esquema. Cuando usas 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"

    Cuando implementes la herramienta del editor de texto, ten en cuenta:

    1. Seguridad: La herramienta tiene acceso a tu sistema de archivos local, así que implementa medidas de seguridad adecuadas.
    2. Copia de seguridad: Siempre crea copias de seguridad antes de permitir ediciones en archivos importantes.
    3. Validación: Valida todas las entradas para prevenir cambios no intencionados.
    4. Coincidencia única: Asegúrate de que los reemplazos coincidan exactamente en una ubicación para evitar ediciones no intencionadas.

    Manejar errores

    Cuando usas la herramienta del editor de texto, pueden ocurrir varios errores. Aquí hay orientación sobre cómo manejarlos:

    Seguir las mejores prácticas de implementación

    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:

    ToolAdditional input tokens
    text_editor_20250429 (Claude 4.x)700 tokens
    text_editor_20250124 (Claude Sonnet 3.7 (deprecated))700 tokens

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

    Integrar la herramienta del editor de texto con otras herramientas

    La herramienta del editor de texto se puede usar junto con otras herramientas de Claude. Cuando combines herramientas, asegúrate de:

    • Coincidir la versión de la 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

    FechaVersiónCambios
    28 de julio de 2025text_editor_20250728Lanzamiento de una herramienta de editor de texto actualizada que corrige algunos problemas y añade un parámetro max_characters opcional. Es idéntica a text_editor_20250429 de otra manera.
    29 de abril de 2025text_editor_20250429Lanzamiento 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 de 2025text_editor_20250124Introducció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 2024text_editor_20241022

    Próximos pasos

    Aquí hay algunas ideas sobre cómo usar la herramienta del editor de texto de formas más convenientes y poderosas:

    • Integrar con tu flujo de trabajo de desarrollo: Construye la herramienta del editor de texto en tus herramientas de desarrollo o IDE
    • Crear un sistema de revisión de código: Haz que Claude revise tu código y haga mejoras
    • Construir un asistente de depuración: Crea un sistema donde Claude pueda ayudarte a diagnosticar y arreglar problemas en tu código
    • Implementar conversión de formato de archivo: Deja que Claude te ayude a convertir archivos de un formato a otro
    • Automatizar documentación: Configura flujos de trabajo para que Claude documente automáticamente tu código

    A medida que construyas aplicaciones con la herramienta del editor de texto, estamos emocionados de ver cómo aprovechas las capacidades de Claude para mejorar tu flujo de trabajo de desarrollo y productividad.

    Descripción general del uso de herramientas

    Aprende cómo implementar flujos de trabajo de herramientas para usar con Claude.

    • Compatibilidad de modelos
    • Cuándo usar la herramienta de editor de texto
    • Usar la herramienta de editor de texto
    • Comandos de la herramienta de editor de texto
    • Ejemplo: Corregir un error de sintaxis con la herramienta de editor de texto
    • Implementar la herramienta del editor de texto
    • Manejar errores
    • Seguir las mejores prácticas de implementación
    • Precios y uso de tokens
    • Integrar la herramienta del editor de texto con otras herramientas
    • Registro de cambios
    • Próximos pasos
    1. 1

      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?"
    2. 2

      Claude usa la herramienta para examinar archivos o directorios

      • Claude evalúa qué necesita examinar y usa el comando view para examinar el contenido de archivos o listar el contenido de directorios
      • La respuesta de la API contendrá un bloque de contenido tool_use con el comando view
    3. 3

      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_characters en 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 user que contiene un bloque de contenido tool_result
    4. 4

      Claude usa la herramienta para modificar archivos

      • Después de examinar el archivo o directorio, Claude puede usar un comando como str_replace para hacer cambios o insert para 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
    5. 5

      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
    6. 6

      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ó
    1. 1

      Inicializar tu implementación del editor

      Crea funciones auxiliares para manejar operaciones de archivos como lectura, escritura y modificación de archivos. Considera implementar funcionalidad de copia de seguridad para recuperarte de errores.

    2. 2

      Manejar llamadas de herramientas del editor

      Crea una función que procese llamadas de herramientas de Claude basadas en el tipo de comando:

      def handle_editor_tool(tool_call, model_version):
    input_params = tool_call.input
    command = input_params.get('command', '')
    file_path = input_params.get('path', '')
    
    if command == 'view':
        # Read and return file contents
        pass
    elif command == 'str_replace':
        # Replace text in file
        pass
    elif command == 'create':
        # Create new file
        pass
    elif command == 'insert':
        # Insert text at location
        pass
    elif command == 'undo_edit':
        # Check if it's a Claude 4 model
        if 'str_replace_based_edit_tool' in model_version:
            return {"error": "undo_edit command is not supported in Claude 4"}
        # Restore from backup for Claude 3.7
        pass
    3. 3

      Implementar medidas de seguridad

      Añade validación y controles de seguridad:

      • Valida rutas de archivos para prevenir traversal de directorios
      • Crea copias de seguridad antes de hacer cambios
      • Maneja errores correctamente
      • Implementa controles de permisos
    4. 4

      Procesar respuestas de Claude

      Extrae y maneja llamadas de herramientas de las respuestas de Claude:

      # Process tool use in Claude's response
for content in response.content:
    if content.type == "tool_use":
        # Execute the tool based on command
        result = handle_editor_tool(content)
        
        # Return result to Claude
        tool_result = {
            "type": "tool_result",
            "tool_use_id": content.id,
            "content": result
        }

    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.
    Herramienta Bash

    Ejecuta comandos de shell con Claude.