Loading...
    • Guida per sviluppatori
    • Riferimento API
    • MCP
    • Risorse
    • Note sulla versione
    Search...
    ⌘K
    Primi passi
    Introduzione a ClaudeAvvio rapido
    Modelli e prezzi
    Panoramica dei modelliScelta di un modelloNovità in Claude 4.5Migrazione a Claude 4.5Deprecazione dei modelliPrezzi
    Crea con Claude
    Panoramica delle funzioniUtilizzo dell'API MessagesFinestre di contestoBest practice per i prompt
    Capacità
    Prompt cachingModifica del contestoExtended thinkingSforzoStreaming dei messaggiElaborazione batchCitazioniSupporto multilingueConteggio dei tokenEmbeddingsVisioneSupporto PDFAPI FilesRisultati di ricercaOutput strutturati
    Strumenti
    PanoramicaCome implementare l'uso degli strumentiStreaming granulare degli strumentiStrumento BashStrumento di esecuzione del codiceChiamata programmatica degli strumentiStrumento Computer useStrumento Editor di testoStrumento Web fetchStrumento Web searchStrumento MemoryStrumento Tool search
    Agent Skills
    PanoramicaAvvio rapidoBest practiceUtilizzo di Skills con l'API
    Agent SDK
    PanoramicaAvvio rapidoTypeScript SDKTypeScript V2 (anteprima)Python SDKGuida alla migrazione
    MCP nell'API
    Connettore MCPServer MCP remoti
    Claude su piattaforme di terze parti
    Amazon BedrockMicrosoft FoundryVertex AI
    Prompt engineering
    PanoramicaGeneratore di promptUsa modelli di promptMiglioratore di promptSii chiaro e direttoUsa esempi (multishot prompting)Lascia pensare Claude (CoT)Usa tag XMLDai a Claude un ruolo (prompt di sistema)Precompila la risposta di ClaudeConcatena prompt complessiSuggerimenti per il contesto lungoSuggerimenti per extended thinking
    Test e valutazione
    Definisci criteri di successoSviluppa casi di testUtilizzo dello strumento di valutazioneRiduzione della latenza
    Rafforza i guardrail
    Riduci le allucinazioniAumenta la coerenza dell'outputMitigare i jailbreakStreaming dei rifiutiRiduci la perdita di promptMantieni Claude nel personaggio
    Amministrazione e monitoraggio
    Panoramica dell'Admin APIAPI di utilizzo e costiAPI Claude Code Analytics
    Console
    Log in
    Loading...
    Loading...
    Loading...
    Loading...
    Loading...
    Loading...
    Loading...
    Loading...
    Loading...
    Loading...
    Loading...
    Loading...
    Loading...
    Loading...
    Loading...
    Loading...

    Solutions

    • AI agents
    • Code modernization
    • Coding
    • Customer support
    • Education
    • Financial services
    • Government
    • Life sciences

    Partners

    • Amazon Bedrock
    • Google Cloud's Vertex AI

    Learn

    • Blog
    • Catalog
    • Courses
    • Use cases
    • Connectors
    • Customer stories
    • Engineering at Anthropic
    • Events
    • Powered by Claude
    • Service partners
    • Startups program

    Company

    • Anthropic
    • Careers
    • Economic Futures
    • Research
    • News
    • Responsible Scaling Policy
    • Security and compliance
    • Transparency

    Learn

    • Blog
    • Catalog
    • Courses
    • Use cases
    • Connectors
    • Customer stories
    • Engineering at Anthropic
    • Events
    • Powered by Claude
    • Service partners
    • Startups program

    Help and security

    • Availability
    • Status
    • Support
    • Discord

    Terms and policies

    • Privacy policy
    • Responsible disclosure policy
    • Terms of service: Commercial
    • Terms of service: Consumer
    • Usage policy
    Strumenti

    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.

    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

    ModelloVersione dello strumento
    Modelli Claude 4.xtext_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 della 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:

    Comandi dello strumento editor di testo

    Lo strumento editor di testo supporta diversi comandi per visualizzare e modificare 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 visualizzare
    • view_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 modificare
    • old_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 file
    • file_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 modificare
    • insert_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

    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_20250728"
    • Claude Sonnet 3.7: type: "text_editor_20250124"

    Quando implementi lo strumento editor di testo, tieni presente:

    1. Sicurezza: Lo strumento ha accesso al tuo file system locale, quindi implementa misure di sicurezza appropriate.
    2. Backup: Crea sempre backup prima di consentire modifiche a file importanti.
    3. Validazione: Valida tutti gli input per prevenire modifiche indesiderate.
    4. Corrispondenza univoca: Assicurati che le sostituzioni corrispondano esattamente a una sola 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:

    ToolAdditional 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, vedi 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

    DataVersioneModifiche
    28 luglio 2025text_editor_20250728Rilascio di uno strumento editor di testo aggiornato che corregge alcuni problemi e aggiunge un parametro max_characters opzionale. È altrimenti identico a text_editor_20250429.
    29 aprile 2025text_editor_20250429Rilascio 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 2025text_editor_20250124Introduzione della documentazione dello strumento editor di testo autonomo. Questa versione è ottimizzata per Claude Sonnet 3.7 ma ha funzionalità identiche alla versione precedente.
    22 ottobre 2024text_editor_20241022Rilascio iniziale dello strumento editor di testo con Claude Sonnet 3.5 (). Fornisce funzionalità per visualizzare, creare e modificare file attraverso i comandi , , , e .

    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: Fai in modo che Claude riveda il tuo codice e apporta miglioramenti
    • Crea un assistente di debug: Crea un sistema in cui Claude può aiutarti a diagnosticare e risolvere 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 sfruttare le capacità di Claude per migliorare il tuo flusso di lavoro di sviluppo e la tua produttività.

    Panoramica dell'utilizzo degli strumenti

    Scopri come implementare flussi di lavoro degli strumenti da utilizzare con Claude.

    • Compatibilità dei modelli
    • Quando utilizzare lo strumento editor di testo
    • Utilizza lo strumento editor di testo
    • Comandi dello strumento editor di testo
    • Esempio: Correzione di un errore di sintassi con lo strumento editor di testo
    • Implementare lo strumento editor di testo
    • Gestisci gli errori
    • Segui le migliori pratiche di implementazione
    • Prezzi e utilizzo dei token
    • Integra lo strumento editor di testo con altri strumenti
    • Registro delle modifiche
    • Passaggi successivi
    1. 1

      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?"
    2. 2

      Claude utilizza lo strumento per esaminare file o directory

      • Claude valuta cosa ha bisogno di esaminare 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 comando view
    3. 3

      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 user contenente un blocco di contenuto tool_result
    4. 4

      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 o insert 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 testo vecchio e il testo nuovo con cui sostituirlo
    5. 5

      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
    6. 6

      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
    1. 1

      Inizializza l'implementazione dell'editor

      Crea funzioni helper per gestire le operazioni sui file come la lettura, la scrittura e la modifica dei file. Considera l'implementazione della funzionalità di backup per recuperare da errori.

    2. 2

      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
        pass
    3. 3

      Implementa misure di sicurezza

      Aggiungi controlli di validazione 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
    4. 4

      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
        }

    ritirato
    view
    create
    str_replace
    insert
    undo_edit
    Strumento Bash

    Esegui comandi shell con Claude.