Strumento editor di testo
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.
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. Questo permette a Claude di interagire direttamente con i tuoi file, fornendo assistenza pratica piuttosto che suggerire semplicemente modifiche.
Prima di utilizzare lo strumento editor di testo
Utilizza un modello compatibile
Lo strumento editor di testo di Anthropic è disponibile per più modelli Claude:
- Claude 4 Opus & Sonnet:
text_editor_20250429
- Claude Sonnet 3.7:
text_editor_20250124
- Claude Sonnet 3.5:
text_editor_20241022
Claude Sonnet 3.5 richiede l’header beta computer-use-2024-10-22
quando si utilizza lo strumento editor di testo.
Lo strumento editor di testo è generalmente disponibile in Claude 4 e Sonnet 3.7.
Il più recente text_editor_20250429
per i modelli Claude 4 non include il comando undo_edit
. Se hai bisogno di questa funzionalità, dovrai utilizzare Claude 3.7 o Sonnet 3.5 con le rispettive versioni dello strumento.
Valuta l’adeguatezza del tuo caso d’uso
Alcuni esempi di quando utilizzare lo strumento editor di testo sono:
- Debug del codice: Fai identificare e correggere bug nel tuo codice a Claude, 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 creare a Claude test unitari per il tuo codice basati sulla sua comprensione dell’implementazione.
Utilizza lo strumento editor di testo
Fornisci lo strumento editor di testo (chiamato str_replace_based_edit_tool
) a Claude utilizzando l’API Messages:
Fornisci lo strumento editor di testo (chiamato str_replace_based_edit_tool
) a Claude utilizzando l’API Messages:
Fornisci lo strumento editor di testo (chiamato str_replace_editor
) a Claude utilizzando l’API Messages:
Fornisci lo strumento editor di testo (chiamato str_replace_editor
) a Claude utilizzando l’API Messages:
Lo strumento editor di testo può essere utilizzato nel seguente modo:
Fornisci a Claude lo strumento editor di testo e un prompt utente
- Includi lo strumento editor di testo nella tua richiesta API
- Fornisci un prompt 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 deve guardare e utilizza il comando
view
per esaminare il contenuto dei file o elencare il contenuto delle directory - La risposta API conterrà un blocco di contenuto
tool_use
con 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 e restituiscili a Claude
- Restituisci i risultati a Claude continuando la conversazione con un nuovo messaggio
user
contenente 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_replace
per apportare modifiche oinsert
per aggiungere testo a un numero di riga specifico. - Se Claude utilizza il comando
str_replace
, Claude costruisce una richiesta di utilizzo dello strumento formattata correttamente con il vecchio testo e il nuovo testo con cui sostituirlo
Esegui la modifica e restituisci i risultati
- Estrai il percorso del file, il vecchio testo e il nuovo testo 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 delle modifiche che 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
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 a 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
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 testo
create
Il comando create
permette a Claude di creare un nuovo file con contenuto specificato.
Parametri:
command
: Deve essere “create”path
: Il percorso dove dovrebbe essere creato il nuovo filefile_text
: Il contenuto da scrivere nel nuovo file
insert
Il comando 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 inserire
undo_edit
Il comando undo_edit
permette a Claude di annullare l’ultima modifica apportata a un file.
Questo comando è disponibile solo in Claude Sonnet 3.7 e Claude Sonnet 3.5. Non è supportato nei modelli Claude 4 che utilizzano il text_editor_20250429
.
Parametri:
command
: Deve essere “undo_edit”path
: Il percorso del file la cui ultima modifica dovrebbe essere annullata
Esempio: Correggere un errore di sintassi con lo strumento editor di testo
Questo esempio dimostra come Claude 4 utilizza lo strumento editor di testo per correggere un errore di sintassi in un file Python.
Prima, la tua applicazione fornisce a Claude lo strumento editor di testo e un prompt per correggere un errore di sintassi:
Claude utilizzerà prima lo strumento editor di testo per visualizzare il file:
La tua applicazione dovrebbe quindi leggere il file e restituire il suo contenuto a Claude:
Numeri di riga
Nell’esempio sopra, il risultato dello strumento 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.
Claude identificherà l’errore di sintassi e utilizzerà il comando str_replace
per correggerlo:
La tua applicazione dovrebbe quindi apportare la modifica e restituire il risultato:
Infine, Claude fornirà una spiegazione completa della correzione:
Questo esempio dimostra come Claude 4 utilizza lo strumento editor di testo per correggere un errore di sintassi in un file Python.
Prima, la tua applicazione fornisce a Claude lo strumento editor di testo e un prompt per correggere un errore di sintassi:
Claude utilizzerà prima lo strumento editor di testo per visualizzare il file:
La tua applicazione dovrebbe quindi leggere il file e restituire il suo contenuto a Claude:
Numeri di riga
Nell’esempio sopra, il risultato dello strumento 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.
Claude identificherà l’errore di sintassi e utilizzerà il comando str_replace
per correggerlo:
La tua applicazione dovrebbe quindi apportare la modifica e restituire il risultato:
Infine, Claude fornirà una spiegazione completa della correzione:
Questo esempio dimostra come Claude Sonnet 3.7 utilizza lo strumento editor di testo per correggere un errore di sintassi in un file Python.
Prima, la tua applicazione fornisce a Claude lo strumento editor di testo e un prompt per correggere un errore di sintassi:
Gli esempi di Claude Sonnet 3.7 seguono lo stesso formato degli esempi di Claude 4 sopra, utilizzando le stesse chiamate di strumento e risposte ma con il tipo di strumento text_editor_20250124
e il nome str_replace_editor
.
Implementa lo strumento editor di testo
Lo strumento editor di testo è implementato come uno strumento senza schema. Quando utilizzi questo strumento, non devi 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_20250429"
- Claude Sonnet 3.7:
type: "text_editor_20250124"
- Claude Sonnet 3.5:
type: "text_editor_20241022"
Inizializza la tua implementazione dell'editor
Crea funzioni di supporto per gestire operazioni sui file come leggere, scrivere e modificare file. Considera l’implementazione di funzionalità di backup per recuperare dagli errori.
Gestisci le chiamate dello strumento editor
Crea una funzione che elabora le chiamate di strumento da Claude basate sul tipo di comando:
Implementa misure di sicurezza
Aggiungi validazione e controlli di sicurezza:
- Valida i percorsi dei file per prevenire l’attraversamento delle directory
- Crea backup prima di apportare modifiche
- Gestisci gli errori con grazia
- Implementa controlli dei permessi
Elabora le risposte di Claude
Estrai e gestisci le chiamate di strumento dalle risposte di Claude:
Quando implementi lo strumento editor di testo, tieni presente:
- Sicurezza: Lo strumento ha accesso al tuo filesystem locale, quindi implementa misure di sicurezza appropriate.
- Backup: Crea sempre backup prima di permettere modifiche a file importanti.
- Validazione: Valida tutti gli input per prevenire modifiche non intenzionali.
- Corrispondenza unica: Assicurati che le sostituzioni corrispondano esattamente a una posizione per evitare modifiche non intenzionali.
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) | 700 tokens |
text_editor_20250124 (Claude Sonnet 3.7) | 700 tokens |
text_editor_20241022 (Claude Sonnet 3.5) | 700 tokens |
Per informazioni più dettagliate sui prezzi degli strumenti, vedi Prezzi dell’uso 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 strumenti, assicurati di:
- Abbinare la versione dello strumento con il modello che stai utilizzando
- Tenere conto dell’utilizzo aggiuntivo di token per tutti gli strumenti inclusi nella tua richiesta
Registro delle modifiche
Data | Versione | Modifiche |
---|---|---|
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. Fornisce capacità per visualizzare, creare e modificare file attraverso i comandi view , create , str_replace , insert e undo_edit . |
Prossimi passi
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: Costruisci lo strumento editor di testo nei tuoi strumenti di sviluppo o IDE
- Crea un sistema di revisione del codice: Fai rivedere il tuo codice a Claude e apportare miglioramenti
- Costruisci un assistente di debug: Crea un sistema dove Claude può aiutarti a diagnosticare e correggere 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 per Claude per documentare automaticamente il tuo codice
Mentre costruisci applicazioni con lo strumento editor di testo, siamo entusiasti di vedere come sfrutti le capacità di Claude per migliorare il tuo flusso di lavoro di sviluppo e la produttività.