Claude può utilizzare uno strumento editor di testo definito da Anthropic per visualizzare e modificare file di testo, aiutandoti a debuggare, correggere e migliorare il tuo codice o altri documenti di testo.
text_editor_20250728
text_editor_20250124
text_editor_20241022
computer-use-2024-10-22
quando si utilizza lo strumento editor di testo.Lo strumento editor di testo è generalmente disponibile nei modelli Claude 4 e Claude Sonnet 3.7.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 o Sonnet 3.5 con le rispettive versioni dello strumento.str_replace_based_edit_tool
) a Claude utilizzando l’API Messages.Puoi opzionalmente 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 utente
Claude utilizza lo strumento per esaminare file o directory
view
per esaminare il contenuto dei file o elencare il contenuto delle directorytool_use
con il comando view
Esegui il comando view e restituisci i risultati
max_characters
nella configurazione dello strumento, tronca il contenuto del file a quella lunghezzauser
contenente un blocco di contenuto tool_result
Claude utilizza lo strumento per modificare i file
str_replace
per apportare modifiche o insert
per aggiungere testo a un numero di riga specifico.str_replace
, Claude costruisce una richiesta di utilizzo dello strumento formattata correttamente con il vecchio testo e il nuovo testo con cui sostituirloEsegui la modifica e restituisci i risultati
Claude fornisce la sua analisi e spiegazione
view
permette 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
(opzionale): Un array di due interi che specificano i numeri di riga di inizio e fine 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
str_replace
permette 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 spazi bianchi e indentazione)new_str
: Il nuovo testo da inserire al posto del vecchio testoEsempio di comando str_replace
create
permette a Claude di creare un nuovo file con contenuto specificato.
Parametri:
command
: Deve essere “create”path
: Il percorso dove deve essere creato il nuovo filefile_text
: Il contenuto da scrivere nel nuovo fileEsempio di comando create
insert
permette 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 inserireEsempio di comando insert
undo_edit
permette 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 annullataEsempio di comando undo_edit
view
include il contenuto del file con numeri di riga anteposti a ogni riga (ad esempio, “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 dei file e il parametro insert_line
per aggiungere contenuto in posizioni precise.str_replace
per correggerlo:type: "text_editor_20250728"
type: "text_editor_20250124"
type: "text_editor_20241022"
Inizializza la tua implementazione dell'editor
Gestisci le chiamate dello strumento editor
Implementa misure di sicurezza
Elabora le risposte di Claude
File non trovato
tool_result
: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
str_replace
di Claude non corrisponde a nessun testo nel file, restituisci un messaggio di errore appropriato:Errori di permessi
Fornisci contesto chiaro
Sii esplicito sui percorsi dei file
Crea backup prima di modificare
Gestisci attentamente la sostituzione di testo unica
str_replace
richiede una corrispondenza esatta per il testo da sostituire. La tua applicazione dovrebbe assicurarsi che ci sia esattamente una corrispondenza per il vecchio testo o fornire messaggi di errore appropriati.Verifica le modifiche
Tool | Additional input tokens |
---|---|
text_editor_20250429 (Claude 4) | 700 tokens |
text_editor_20250124 (Claude Sonnet 3.7) | 700 tokens |
text_editor_20241022 (Claude Sonnet 3.5 (deprecated)) | 700 tokens |
Data | Versione | Modifiche |
---|---|---|
28 luglio 2025 | text_editor_20250728 | Rilascio di uno strumento editor di testo aggiornato che risolve alcuni problemi e aggiunge un parametro opzionale max_characters . È 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 autonoma dello strumento editor di testo. 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 (deprecato). Fornisce capacità per visualizzare, creare e modificare file attraverso i comandi view , create , str_replace , insert e undo_edit . |