Strumento editor di testo

Claude può utilizzare uno strumento editor di testo definito da Anthropic per visualizzare e modificare file di testo, aiutandoti a eseguire 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 piuttosto che suggerire semplicemente modifiche.

Compatibilità del modello

Modello	Versione dello strumento
Modelli Claude 4.x	`text_editor_20250728`
Claude Sonnet 3.7 (deprecato)	`text_editor_20250124`

Lo strumento text_editor_20250728 per i modelli Claude 4 non include il comando undo_edit. Se hai bisogno di questa funzionalità, dovrai utilizzare Claude Sonnet 3.7 (deprecato).

Le versioni precedenti dello strumento non sono garantite essere retrocompatibili con i modelli più recenti. Utilizza sempre la versione dello strumento che corrisponde alla versione del tuo modello.

Quando utilizzare lo strumento editor di testo

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

Debug del codice: Chiedi a Claude di identificare e correggere i bug nel tuo codice, dagli errori di sintassi ai problemi di logica.
Refactoring del codice: Consenti a Claude di migliorare la struttura del tuo codice, la leggibilità e le prestazioni attraverso modifiche mirate.
Generazione di documentazione: Chiedi a Claude di aggiungere docstring, commenti o file README al tuo codebase.
Creazione di test: Chiedi a Claude di creare unit test per il tuo codice in base alla sua comprensione dell'implementazione.

Utilizza lo strumento editor di testo

Lo strumento editor di testo può essere utilizzato nel seguente modo:

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 specificano i numeri di riga iniziale e finale da visualizzare. I numeri di riga sono indicizzati da 1 e -1 per la riga finale significa leggere fino alla fine del file. Questo parametro si applica solo quando si visualizzano file, non directory.

str_replace

Il comando str_replace consente a Claude di sostituire una stringa specifica in un file con una nuova stringa. Questo viene utilizzato per apportare 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 gli spazi bianchi e l'indentazione)
new_str: Il nuovo testo da inserire al posto del testo vecchio

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 in 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

undo_edit

Il comando undo_edit consente a Claude di annullare l'ultima modifica apportata a un file.

Questo comando è disponibile solo in Claude Sonnet 3.7 (deprecato). Non è supportato nei modelli Claude 4 che utilizzano text_editor_20250728.

Parametri:

command: Deve essere "undo_edit"
path: Il percorso del file la cui ultima modifica deve essere annullata

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

Implementare lo strumento editor di testo

Lo strumento editor di testo è implementato come uno strumento senza schema. Quando si utilizza questo strumento, non è necessario fornire uno schema di input come con altri strumenti; lo schema è integrato nel modello di Claude e non può essere modificato.

Il tipo di strumento dipende dalla versione del modello:

Claude 4: type: "text_editor_20250728"
Claude Sonnet 3.7: type: "text_editor_20250124"

Quando si implementa lo strumento editor di testo, tenere presente:

Sicurezza: Lo strumento ha accesso al file system locale, quindi implementare misure di sicurezza appropriate.
Backup: Creare sempre backup prima di consentire modifiche a file importanti.
Convalida: Convalidare tutti gli input per prevenire modifiche indesiderate.
Corrispondenza univoca: Assicurarsi che le sostituzioni corrispondano esattamente a una posizione per evitare modifiche indesiderate.

Gestire gli errori

Quando si utilizza lo strumento editor di testo, possono verificarsi vari errori. Ecco una guida su come gestirli:

Seguire le best practice di implementazione

Prezzi e utilizzo dei token

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:

Tool	Additional input tokens
`text_editor_20250429` (Claude 4.x)	700 tokens
`text_editor_20250124` (Claude Sonnet 3.7 (deprecated))	700 tokens

Per informazioni più dettagliate sui prezzi degli strumenti, vedere Prezzi dell'utilizzo degli strumenti.

Integrare lo strumento editor di testo con altri strumenti

Lo strumento editor di testo può essere utilizzato insieme ad altri strumenti Claude. Quando si combinano gli strumenti, assicurarsi di:

Abbinare la versione dello strumento al modello che si sta utilizzando
Tenere conto dell'utilizzo aggiuntivo dei token per tutti gli strumenti inclusi nella richiesta

Registro delle modifiche

Data	Versione	Modifiche
28 luglio 2025	`text_editor_20250728`	Rilascio di uno strumento editor di testo aggiornato che corregge alcuni problemi e aggiunge un parametro `max_characters` opzionale. È altrimenti identico a `text_editor_20250429`.
29 aprile 2025	`text_editor_20250429`	Rilascio dello strumento editor di testo per Claude 4. Questa versione rimuove il comando `undo_edit` ma mantiene tutte le altre funzionalità. Il nome dello strumento è stato aggiornato per riflettere la sua architettura basata su str_replace.
13 marzo 2025	`text_editor_20250124`	Introduzione della documentazione dello strumento editor di testo autonomo. Questa versione è ottimizzata per Claude Sonnet 3.7 ma ha capacità identiche alla versione precedente.
22 ottobre 2024	`text_editor_20241022`	Rilascio iniziale dello strumento editor di testo con Claude Sonnet 3.5 (). Fornisce funzionalità per visualizzare, creare e modificare file attraverso i comandi , , , e .

Passaggi successivi

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

Integrare con il flusso di lavoro di sviluppo: Integrare lo strumento editor di testo nei tuoi strumenti di sviluppo o IDE
Creare un sistema di revisione del codice: Far rivedere a Claude il tuo codice e apportare miglioramenti
Creare un assistente di debug: Creare un sistema in cui Claude possa aiutarti a diagnosticare e correggere i problemi nel tuo codice
Implementare la conversione del formato di file: Consentire a Claude di aiutarti a convertire file da un formato a un altro
Automatizzare la documentazione: Configurare flussi di lavoro affinché Claude documenti automaticamente il tuo codice

Mentre costruisci applicazioni con lo strumento editor di testo, siamo entusiasti di vedere come sfruttare le capacità di Claude per migliorare il flusso di lavoro di sviluppo e la produttività.

Panoramica dell'utilizzo degli strumenti

Scopri come implementare flussi di lavoro degli strumenti da utilizzare con Claude.

Inizializzare l'implementazione dell'editor
Creare funzioni helper per gestire le operazioni sui file come lettura, scrittura e modifica dei file. Considerare l'implementazione della funzionalità di backup per recuperare da errori.

Gestire le chiamate dello strumento editor

Creare una funzione che elabori le chiamate dello strumento da Claude in base al tipo di 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

Implementare misure di sicurezza
Aggiungere controlli di convalida e sicurezza:
- Convalidare i percorsi dei file per prevenire il traversal delle directory
- Creare backup prima di apportare modifiche
- Gestire gli errori in modo elegante
- Implementare controlli delle autorizzazioni

Elaborare le risposte di Claude

Estrarre e gestire le chiamate dello strumento dalle risposte di 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
        }

view

create

str_replace

insert

undo_edit

Compatibilità del modello

Quando utilizzare lo strumento editor di testo

Utilizza lo strumento editor di testo

Comandi dello strumento editor di testo

view

Esempi di comandi view

str_replace

Esempio di comando str_replace

create

Esempio di comando create

insert

Esempio di comando insert

undo_edit

Esempio di comando undo_edit

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

Implementare lo strumento editor di testo

Gestire gli errori

File non trovato

Corrispondenze multiple per la sostituzione

Seguire le best practice di implementazione

Fornire un contesto chiaro

Essere espliciti sui percorsi dei file

Creare backup prima di modificare

Prezzi e utilizzo dei token

Integrare lo strumento editor di testo con altri strumenti

Registro delle modifiche

Passaggi successivi

Nessuna corrispondenza per la sostituzione

Errori di autorizzazione

Gestire con attenzione la sostituzione di testo univoco

Verificare le modifiche