Strumento editor di testo

Claude può usare uno strumento editor di testo con schema Anthropic per visualizzare e modificare file di testo, aiutandoti a fare il debug, correggere e migliorare il tuo codice o altri documenti di testo. Questo consente a Claude di interagire direttamente con i tuoi file, fornendo assistenza pratica invece di limitarsi a suggerire modifiche.

Per il supporto dei modelli, consulta il Riferimento degli strumenti.



Quando usare lo strumento editor di testo

Alcuni esempi di quando usare lo strumento editor di testo sono:

• Debug del codice: Fai in modo che Claude identifichi e corregga i bug nel tuo codice, dagli errori di sintassi ai problemi di logica.
• Refactoring del codice: Lascia che Claude migliori la struttura, la leggibilità e le prestazioni del tuo codice attraverso modifiche mirate.
• Generazione di documentazione: Chiedi a Claude di aggiungere docstring, commenti o file README alla tua base di codice.
• Creazione di test: Fai in modo che Claude crei unit test per il tuo codice basandosi sulla sua analisi dell'implementazione.



Usa lo strumento editor di testo

Fornisci lo strumento editor di testo (denominato str_replace_based_edit_tool) a Claude usando la Messages API.

Puoi facoltativamente specificare un parametro max_characters per controllare il troncamento durante la visualizzazione di file di grandi dimensioni.

client = anthropic.Anthropic()

response = client.messages.create(
    model="claude-opus-5",
    max_tokens=1024,
    tools=[
        {
            "type": "text_editor_20250728",
            "name": "str_replace_based_edit_tool",
            "max_characters": 10000,
        }
    ],
    messages=[
        {
            "role": "user",
            "content": "There's a syntax error in my primes.py file. Can you help me fix it?",
        }
    ],
)

print(response)

Usa lo strumento editor di testo nel modo seguente:



Comandi dello strumento editor di testo

Lo strumento editor di testo supporta diversi comandi per visualizzare e modificare i file:



view

Il comando view consente a Claude di esaminare il contenuto di un file o elencare il contenuto di una directory. Può leggere l'intero file o un intervallo specifico di righe.

Parametri:

• command: Deve essere "view"
• path: Il percorso del file o della directory da visualizzare
• view_range (facoltativo): Un array di due interi che specifica i numeri di riga di inizio e fine da visualizzare. I numeri di riga partono da 1, e -1 per la riga finale significa leggere fino alla fine del file. Questo parametro si applica solo alla visualizzazione di file, non di directory.



str_replace

Il comando str_replace consente a Claude di sostituire una stringa specifica in un file con una nuova stringa. Viene usato per effettuare modifiche precise.

Parametri:

• command: Deve essere "str_replace"
• path: Il percorso del file da modificare
• old_str: Il testo da sostituire (deve corrispondere esattamente, inclusi spazi bianchi e indentazione)
• new_str: Il nuovo testo da inserire al posto del vecchio testo



create

Il comando create consente a Claude di creare un nuovo file con il contenuto specificato.

Parametri:

• command: Deve essere "create"
• path: Il percorso in cui deve essere creato il nuovo file
• file_text: Il contenuto da scrivere nel nuovo file



insert

Il comando insert consente a Claude di inserire testo in una posizione specifica di un file.

Parametri:

• command: Deve essere "insert"
• path: Il percorso del file da modificare
• insert_line: Il numero di riga dopo il quale inserire il testo (0 per l'inizio del file)
• insert_text: Il testo da inserire



Esempio: Correggere un errore di sintassi con lo strumento editor di testo

Questo esempio dimostra come Claude usa lo strumento editor di testo per correggere un errore di sintassi in un file Python.

Innanzitutto, la tua applicazione fornisce a Claude lo strumento editor di testo e un prompt per correggere un errore di sintassi:

client = anthropic.Anthropic()

response = client.messages.create(
    model="claude-opus-5",
    max_tokens=1024,
    tools=[{"type": "text_editor_20250728", "name": "str_replace_based_edit_tool"}],
    messages=[
        {
            "role": "user",
            "content": "There's a syntax error in my primes.py file. Can you help me fix it?",
        }
    ],
)

print(response)

Claude usa prima lo strumento editor di testo per visualizzare il file:

{
  "id": "msg_01XAbCDeFgHiJkLmNoPQrStU",
  "model": "claude-opus-5",
  "stop_reason": "tool_use",
  "role": "assistant",
  "content": [
    {
      "type": "text",
      "text": "I'll help you fix the syntax error in your primes.py file. First, let me take a look at the file to identify the issue."
    },
    {
      "type": "tool_use",
      "id": "toolu_01AbCdEfGhIjKlMnOpQrStU",
      "name": "str_replace_based_edit_tool",
      "input": {
        "command": "view",
        "path": "primes.py"
      }
    }
  ]
}

La tua applicazione dovrebbe quindi leggere il file e restituirne il contenuto a Claude:

response = client.messages.create(
    model="claude-opus-5",
    max_tokens=1024,
    tools=[{"type": "text_editor_20250728", "name": "str_replace_based_edit_tool"}],
    messages=[
        {
            "role": "user",
            "content": "There's a syntax error in my primes.py file. Can you help me fix it?",
        },
        {
            "role": "assistant",
            "content": [
                {
                    "type": "text",
                    "text": "I'll help you fix the syntax error in your primes.py file. First, let me take a look at the file to identify the issue.",
                },
                {
                    "type": "tool_use",
                    "id": "toolu_01AbCdEfGhIjKlMnOpQrStU",
                    "name": "str_replace_based_edit_tool",
                    "input": {"command": "view", "path": "primes.py"},
                },
            ],
        },
        {
            "role": "user",
            "content": [
                {
                    "type": "tool_result",
                    "tool_use_id": "toolu_01AbCdEfGhIjKlMnOpQrStU",
                    "content": '1: def is_prime(n):\n2:     """Check if a number is prime."""\n3:     if n <= 1:\n4:         return False\n5:     if n <= 3:\n6:         return True\n7:     if n % 2 == 0 or n % 3 == 0:\n8:         return False\n9:     i = 5\n10:     while i * i <= n:\n11:         if n % i == 0 or n % (i + 2) == 0:\n12:             return False\n13:         i += 6\n14:     return True\n15: \n16: def get_primes(limit):\n17:     """Generate a list of prime numbers up to the given limit."""\n18:     primes = []\n19:     for num in range(2, limit + 1)\n20:         if is_prime(num):\n21:             primes.append(num)\n22:     return primes\n23: \n24: def main():\n25:     """Main function to demonstrate prime number generation."""\n26:     limit = 100\n27:     prime_list = get_primes(limit)\n28:     print(f"Prime numbers up to {limit}:")\n29:     print(prime_list)\n30:     print(f"Found {len(prime_list)} prime numbers.")\n31: \n32: if __name__ == "__main__":\n33:     main()',
                }
            ],
        },
    ],
)

print(response)

Claude identifica l'errore di sintassi e usa il comando str_replace per correggerlo:

{
  "id": "msg_01VwXyZAbCdEfGhIjKlMnO",
  "model": "claude-opus-5",
  "stop_reason": "tool_use",
  "role": "assistant",
  "content": [
    {
      "type": "text",
      "text": "I found the syntax error in your primes.py file. In the `get_primes` function, there is a missing colon (:) at the end of the for loop line. Let me fix that for you."
    },
    {
      "type": "tool_use",
      "id": "toolu_01PqRsTuVwXyZAbCdEfGh",
      "name": "str_replace_based_edit_tool",
      "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):"
      }
    }
  ]
}

La tua applicazione dovrebbe quindi effettuare la modifica e restituire il risultato:

response = client.messages.create(
    model="claude-opus-5",
    max_tokens=1024,
    tools=[{"type": "text_editor_20250728", "name": "str_replace_based_edit_tool"}],
    messages=[
        # Messaggi precedenti...
        {
            "role": "assistant",
            "content": [
                {
                    "type": "text",
                    "text": "I found the syntax error in your primes.py file. In the `get_primes` function, there is a missing colon (:) at the end of the for loop line. Let me fix that for you.",
                },
                {
                    "type": "tool_use",
                    "id": "toolu_01PqRsTuVwXyZAbCdEfGh",
                    "name": "str_replace_based_edit_tool",
                    "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):",
                    },
                },
            ],
        },
        {
            "role": "user",
            "content": [
                {
                    "type": "tool_result",
                    "tool_use_id": "toolu_01PqRsTuVwXyZAbCdEfGh",
                    "content": "Successfully replaced text at exactly one location.",
                }
            ],
        },
    ],
)

print(response)

Infine, Claude fornisce una spiegazione completa della correzione:

{
  "id": "msg_01IjKlMnOpQrStUvWxYzAb",
  "model": "claude-opus-5",
  "stop_reason": "end_turn",
  "role": "assistant",
  "content": [
    {
      "type": "text",
      "text": "I've fixed the syntax error in your primes.py file. The issue was in the `get_primes` function at line 19. There was a missing colon (:) at the end of the for loop line.\n\nHere's what I changed:\n\nFrom:\n```python\nfor num in range(2, limit + 1)\n```\n\nTo:\n```python\nfor num in range(2, limit + 1):\n```\n\nIn Python, a colon is required at the end of statements that start a new code block, such as for loops, if statements, function definitions, etc. Without the colon, Python raises a syntax error because it doesn't know where the code block begins.\n\nYour code should now run correctly. The function will properly generate a list of prime numbers up to the specified limit."
    }
  ]
}



Implementa lo strumento editor di testo

Lo strumento editor di testo è implementato come uno strumento senza schema. Quando usi questo strumento, non devi fornire uno schema di input come per gli altri strumenti; lo schema è integrato nel modello di Claude e non può essere modificato.

Il tipo di strumento è type: "text_editor_20250728" per Claude 4 e i modelli successivi.



Gestisci gli errori

Quando usi lo strumento editor di testo, possono verificarsi vari errori. Ecco alcune indicazioni su come gestirli:



Segui le best practice di implementazione



Prezzi e utilizzo dei token

Lo strumento editor di testo utilizza la stessa struttura di prezzi degli altri strumenti usati con Claude. Segue la tariffazione standard basata sui token di input e output in base al modello Claude che stai utilizzando.

Oltre ai token di base, sono necessari i seguenti token di input aggiuntivi per lo strumento editor di testo:

Per informazioni più dettagliate sui prezzi degli strumenti, consulta Prezzi dell'uso degli strumenti.



Integra lo strumento editor di testo con altri strumenti

Puoi usare lo strumento editor di testo insieme ad altri strumenti di Claude. Quando combini gli strumenti, assicurati di:

• Abbinare la versione dello strumento al modello che stai usando
• Tenere conto dell'utilizzo aggiuntivo di token per tutti gli strumenti inclusi nella tua richiesta



Registro delle modifiche



Prossimi passi

Ecco alcune idee su come usare lo strumento editor di testo in modi più comodi e potenti:

• Integra con il tuo flusso di lavoro di sviluppo: Integra lo strumento editor di testo nei tuoi strumenti di sviluppo o IDE
• Crea un sistema di revisione del codice: Fai in modo che Claude riveda il tuo codice e apporti miglioramenti
• Costruisci un assistente di debug: Crea un sistema in cui Claude può aiutarti a diagnosticare e risolvere problemi nel tuo codice
• Implementa la conversione di formati di file: Lascia che Claude ti aiuti a convertire file da un formato all'altro
• Automatizza la documentazione: Configura flussi di lavoro affinché Claude documenti automaticamente il tuo codice

Lo strumento editor di testo consente a Claude di lavorare direttamente con la tua base di codice, supportando flussi di lavoro dal debug alla documentazione automatizzata.