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 solo suggerire modifiche.
Compatibilità dei modelli
| 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:
Fornisci a Claude lo strumento editor di testo e un prompt dell'utente
- Includi lo strumento editor di testo nella tua richiesta API
- Fornisci un prompt dell'utente che potrebbe richiedere l'esame o la modifica di file, come "Puoi correggere l'errore di sintassi nel mio codice?"
Claude utilizza lo strumento per esaminare file o directory
- Claude valuta cosa ha bisogno di esaminare e utilizza il comando
viewper esaminare il contenuto dei file o elencare il contenuto della directory - La risposta dell'API conterrà un blocco di contenuto
tool_usecon il comandoview
- Claude valuta cosa ha bisogno di esaminare e utilizza il comando
Esegui il comando view e restituisci i risultati
- Estrai il percorso del file o della directory dalla richiesta di utilizzo dello strumento di Claude
- Leggi il contenuto del file o elenca il contenuto della directory
- Se un parametro
max_charactersè stato specificato nella configurazione dello strumento, tronca il contenuto del file a quella lunghezza - Restituisci i risultati a Claude continuando la conversazione con un nuovo messaggio
usercontenente un blocco di contenutotool_result
Claude utilizza lo strumento per modificare i file
- Dopo aver esaminato il file o la directory, Claude potrebbe utilizzare un comando come
str_replaceper apportare modifiche oinsertper aggiungere testo a un numero di riga specifico. - Se Claude utilizza il comando
str_replace, Claude costruisce una richiesta di utilizzo dello strumento correttamente formattata con il testo vecchio e il testo nuovo con cui sostituirlo
- Dopo aver esaminato il file o la directory, Claude potrebbe utilizzare un comando come
Esegui la modifica e restituisci i risultati
- Estrai il percorso del file, il testo vecchio e il testo nuovo dalla richiesta di utilizzo dello strumento di Claude
- Esegui la sostituzione del testo nel file
- Restituisci i risultati a Claude
Claude fornisce la sua analisi e spiegazione
- Dopo aver esaminato e possibilmente modificato i file, Claude fornisce una spiegazione completa di ciò che ha trovato e quali modifiche ha apportato
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 visualizzareview_range(facoltativo): Un array di due interi che specifica 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 modificareold_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 filefile_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 modificareinsert_line: Il numero di riga dopo il quale inserire il testo (0 per l'inizio del file)new_str: 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
Implementa lo strumento editor di testo
Lo strumento editor di testo è implementato come uno strumento senza schema. Quando utilizzi questo strumento, non hai bisogno di 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"
Inizializza la tua implementazione dell'editor
Crea funzioni helper per gestire operazioni su file come lettura, scrittura e modifica di file. Considera l'implementazione della funzionalità di backup per recuperare da errori.
Gestisci le chiamate dello strumento editor
Crea una funzione che elabora 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 passImplementa misure di sicurezza
Aggiungi controlli di convalida e sicurezza:
- Valida i percorsi dei file per prevenire l'attraversamento di directory
- Crea backup prima di apportare modifiche
- Gestisci gli errori con eleganza
- Implementa controlli delle autorizzazioni
Elabora le risposte di Claude
Estrai e gestisci 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 }
Quando implementi lo strumento editor di testo, tieni presente:
- Sicurezza: Lo strumento ha accesso al tuo file system locale, quindi implementa misure di sicurezza appropriate.
- Backup: Crea sempre backup prima di consentire modifiche a file importanti.
- Convalida: Valida tutti gli input per prevenire modifiche indesiderate.
- Corrispondenza univoca: Assicurati che le sostituzioni corrispondano esattamente a una posizione per evitare modifiche indesiderate.
Gestisci gli errori
Quando utilizzi lo strumento editor di testo, possono verificarsi vari errori. Ecco una guida su come gestirli:
Segui le migliori pratiche 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, consulta Prezzi dell'utilizzo degli strumenti.
Integra lo strumento editor di testo con altri strumenti
Lo strumento editor di testo può essere utilizzato insieme ad altri strumenti Claude. Quando combini gli strumenti, assicurati di:
- Abbinare la versione dello strumento al modello che stai utilizzando
- Tenere conto dell'utilizzo aggiuntivo dei token per tutti gli strumenti inclusi nella tua 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 facoltativo. È 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 capacità. 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 (ritirato). Fornisce capacità per visualizzare, creare e modificare file attraverso i comandi view, create, str_replace, insert e undo_edit. |
Passaggi successivi
Ecco alcune idee su come utilizzare lo strumento editor di testo in modi più convenienti 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: Chiedi a Claude di rivedere il tuo codice e apportare miglioramenti
- Costruisci un assistente di debug: Crea un sistema in cui Claude può aiutarti a diagnosticare e correggere i problemi nel tuo codice
- Implementa la conversione del formato di file: Consenti a Claude di aiutarti a convertire file da un formato a un altro
- Automatizza la documentazione: Configura flussi di lavoro affinché Claude documenti automaticamente il tuo codice
Mentre costruisci applicazioni con lo strumento editor di testo, siamo entusiasti di vedere come sfruttate le capacità di Claude per migliorare il vostro flusso di lavoro di sviluppo e la vostra produttività.