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 limitarsi a suggerire modifiche.
Prima di utilizzare lo strumento editor di testo
Utilizza un modello compatibile
Lo strumento editor di testo di Anthropic è disponibile per diversi modelli Claude:
- Claude 4 Opus & Sonnet:
text_editor_20250429
- Claude Sonnet 3.7:
text_editor_20250124
- Claude Sonnet 3.5:
text_editor_20241022
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 a Claude i bug nel tuo codice, dagli errori di sintassi ai problemi logici.
- 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 al tuo codebase.
- 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 ciò che deve esaminare e utilizza il comando
view
per esaminare il contenuto del file o elencare il contenuto della 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 correttamente formattata 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
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
(opzionale): Un array di due numeri interi che specificano i numeri di riga iniziale e finale da visualizzare. I numeri di riga iniziano 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. 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
consente a Claude di creare un nuovo file con 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 e Claude Sonnet 3.5. Non è supportato nei modelli Claude 4 che utilizzano text_editor_20250429
.
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
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:
Numeri di riga
Nell’esempio sopra, il risultato dello strumento view
include il contenuto del file con i numeri di riga anteposti a ciascuna 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 di file e il parametro insert_line
per aggiungere contenuto in posizioni precise.
Claude utilizzerà lo strumento editor di testo prima per visualizzare il file:
La tua applicazione dovrebbe quindi leggere il file e restituire il suo contenuto a Claude:
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:
Numeri di riga
Nell’esempio sopra, il risultato dello strumento view
include il contenuto del file con i numeri di riga anteposti a ciascuna 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 di file e il parametro insert_line
per aggiungere contenuto in posizioni precise.
Claude utilizzerà lo strumento editor di testo prima per visualizzare il file:
La tua applicazione dovrebbe quindi leggere il file e restituire il suo contenuto a Claude:
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 e risposte dello strumento ma con il tipo di strumento text_editor_20250124
e il nome str_replace_editor
.
Implementare lo strumento editor di testo
Lo strumento editor di testo è implementato come uno strumento senza schema. Quando utilizzi 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_20250429"
- Claude Sonnet 3.7:
type: "text_editor_20250124"
- Claude Sonnet 3.5:
type: "text_editor_20241022"
Inizializza l'implementazione del tuo editor
Crea funzioni di supporto per gestire operazioni sui file come lettura, scrittura e modifica. Considera l’implementazione di funzionalità di backup per recuperare da errori.
Gestisci le chiamate allo strumento editor
Crea una funzione che elabora le chiamate allo strumento da Claude in base al tipo di comando:
Implementa misure di sicurezza
Aggiungi controlli di validazione e sicurezza:
- Convalida i percorsi dei file per prevenire l’attraversamento delle directory
- Crea backup prima di apportare modifiche
- Gestisci gli errori con eleganza
- Implementa controlli di autorizzazione
Elabora le risposte di Claude
Estrai e gestisci le chiamate allo 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 adeguate misure di sicurezza.
- Backup: Crea sempre backup prima di consentire modifiche a file importanti.
- Validazione: Convalida tutti gli input per prevenire modifiche non intenzionali.
- Corrispondenza univoca: Assicurati che le sostituzioni corrispondano esattamente a una posizione per evitare modifiche non intenzionali.
Gestire gli errori
Quando si utilizza 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
Lo strumento editor di testo utilizza la stessa struttura di prezzi degli altri strumenti utilizzati con Claude. Segue i prezzi standard dei token di input e output basati sul modello Claude che stai utilizzando.
Oltre ai token di base, sono necessari i seguenti token di input aggiuntivi per lo strumento editor di testo:
Strumento | Token di input aggiuntivi |
---|---|
text_editor_20250429 (Claude 4) | 700 token |
text_editor_20250124 (Claude Sonnet 3.7) | 700 token |
text_editor_20241022 (Claude Sonnet 3.5) | 700 token |
Per informazioni più dettagliate sui prezzi degli strumenti, consulta Prezzi per l’uso degli strumenti.
Integrare lo strumento editor di testo con l’uso del computer
Lo strumento editor di testo può essere utilizzato insieme allo strumento di uso del computer e ad altri strumenti definiti da Anthropic. Quando combini questi strumenti, dovrai:
- Includere l’intestazione beta appropriata (se utilizzato con l’uso del computer)
- 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
Per ulteriori informazioni sull’utilizzo dello strumento editor di testo in un contesto di uso del computer, consulta Uso del computer.
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 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 autonoma dello strumento editor di testo. Questa versione è ottimizzata per Claude Sonnet 3.7 ma ha funzionalità 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 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: Incorpora lo strumento editor di testo nei tuoi strumenti di sviluppo o IDE
- Crea un sistema di revisione del codice: Fai revisionare e migliorare il tuo codice da Claude
- Costruisci un assistente per il debug: Crea un sistema in cui Claude può aiutarti a diagnosticare e risolvere problemi nel tuo codice
- Implementa la conversione di formato file: Lascia che Claude ti aiuti a convertire file da un formato all’altro
- Automatizza la documentazione: Configura flussi di lavoro per far documentare automaticamente il tuo codice da Claude
Mentre costruisci applicazioni con lo strumento editor di testo, siamo entusiasti di vedere come sfrutterai le capacità di Claude per migliorare il tuo flusso di lavoro di sviluppo e la tua produttività.
Panoramica sull'uso degli strumenti
Scopri come implementare flussi di lavoro degli strumenti per l’uso con Claude.
Uso degli strumenti efficiente in termini di token
Riduci la latenza e i costi quando utilizzi gli strumenti con Claude Sonnet 3.7.
Strumenti definiti da Anthropic
Scopri come utilizzare altri strumenti definiti da Anthropic come gli strumenti per computer e bash.