Compatibilità dei modelli
| Modello | Versione dello strumento |
|---|---|
| Modelli Claude 4.x | text_editor_20250728 |
| Claude Sonnet 3.7 (deprecato) | text_editor_20250124 |
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).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
str_replace_based_edit_tool) a Claude utilizzando l’API Messages.Puoi facoltativamente specificare un parametro max_characters per controllare il troncamento quando visualizzi file di grandi dimensioni.max_characters è compatibile solo con text_editor_20250728 e versioni successive dello strumento editor di testo.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
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
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 comandoview 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.
Esempi di comandi view
Esempi di comandi view
str_replace
Il comandostr_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
Esempio di comando str_replace
Esempio di comando str_replace
create
Il comandocreate 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
Esempio di comando create
Esempio di comando create
insert
Il comandoinsert 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
Esempio di comando insert
Esempio di comando insert
undo_edit
Il comandoundo_edit consente a Claude di annullare l’ultima modifica apportata a un file.
text_editor_20250728.command: Deve essere “undo_edit”path: Il percorso del file la cui ultima modifica deve essere annullata
Esempio di comando undo_edit
Esempio di comando undo_edit
Esempio: Correzione di un errore di sintassi con lo strumento editor di testo
view include il contenuto del file con i numeri di riga anteposti a ogni riga (ad es. “1: def is_prime(n):”). I numeri di riga non sono obbligatori, ma sono essenziali per utilizzare con successo il parametro view_range per esaminare sezioni specifiche di file e il parametro insert_line per aggiungere contenuto in posizioni precise.str_replace per correggerlo: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
Gestisci le chiamate dello strumento editor
Implementa misure di 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
- 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:File non trovato
File non trovato
tool_result:Corrispondenze multiple per la sostituzione
Corrispondenze multiple per la sostituzione
str_replace di Claude corrisponde a più posizioni nel file, restituisci un messaggio di errore appropriato:Nessuna corrispondenza per la sostituzione
Nessuna corrispondenza per la sostituzione
str_replace di Claude non corrisponde a nessun testo nel file, restituisci un messaggio di errore appropriato:Errori di autorizzazione
Errori di autorizzazione
Segui le migliori pratiche di implementazione
Fornisci un contesto chiaro
Fornisci un contesto chiaro
Sii esplicito sui percorsi dei file
Sii esplicito sui percorsi dei file
Crea backup prima di modificare
Crea backup prima di modificare
Gestisci la sostituzione di testo univoca con attenzione
Gestisci la sostituzione di testo univoca con attenzione
str_replace richiede una corrispondenza esatta per il testo da sostituire. La tua applicazione dovrebbe assicurare che ci sia esattamente una corrispondenza per il testo vecchio o fornire messaggi di errore appropriati.Verifica le modifiche
Verifica le modifiche
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 |
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