Riferimento degli strumenti - Claude Code Docs

Claude Code ha accesso a un set di strumenti integrati che lo aiutano a comprendere e modificare la tua codebase. I nomi degli strumenti sono le stringhe esatte che utilizzi nelle regole di autorizzazione specifiche dello strumento, elenchi di strumenti subagent, e hook matchers. Per disabilitare completamente uno strumento, aggiungi il suo nome all’array deny nelle tue impostazioni di autorizzazione. Per aggiungere strumenti personalizzati, connetti un server MCP. Per estendere Claude con flussi di lavoro basati su prompt riutilizzabili, scrivi una skill, che viene eseguita attraverso lo strumento Skill esistente piuttosto che aggiungere una nuova voce di strumento.

Strumento	Descrizione	Autorizzazione Richiesta
`Agent`	Genera un subagent con la propria finestra di contesto per gestire un’attività. Vedi comportamento dello strumento Agent	No
`AskUserQuestion`	Pone domande a scelta multipla per raccogliere requisiti o chiarire ambiguità	No
`Bash`	Esegue comandi shell nel tuo ambiente. Vedi comportamento dello strumento Bash	Sì
`CronCreate`	Pianifica un prompt ricorrente o una tantum all’interno della sessione corrente. Le attività hanno ambito di sessione e vengono ripristinate su `--resume` o `--continue` se non scadute. Vedi attività pianificate	No
`CronDelete`	Annulla un’attività pianificata per ID	No
`CronList`	Elenca tutte le attività pianificate nella sessione	No
`Edit`	Effettua modifiche mirate a file specifici. Vedi comportamento dello strumento Edit	Sì
`EnterPlanMode`	Passa a Plan Mode per progettare un approccio prima di codificare	No
`EnterWorktree`	Crea un git worktree isolato e vi accede. Passa un `path` per accedere a un worktree esistente del repository corrente invece di crearne uno nuovo. Non disponibile per i subagent	No
`ExitPlanMode`	Presenta un piano per l’approvazione ed esce da Plan Mode	Sì
`ExitWorktree`	Esce da una sessione worktree e ritorna alla directory originale. Non disponibile per i subagent	No
`Glob`	Trova file in base alla corrispondenza di pattern. Vedi comportamento dello strumento Glob	No
`Grep`	Cerca pattern nei contenuti dei file. Vedi comportamento dello strumento Grep	No
`ListMcpResourcesTool`	Elenca le risorse esposte dai server MCP connessi	No
`LSP`	Intelligenza del codice tramite language server: salta alle definizioni, trova riferimenti, segnala errori di tipo e avvisi. Vedi comportamento dello strumento LSP	No
`Monitor`	Esegue un comando in background e restituisce ogni riga di output a Claude, in modo che possa reagire alle voci di log, ai cambiamenti di file, o allo stato sottoposto a polling durante la conversazione. Vedi strumento Monitor	Sì
`NotebookEdit`	Modifica le celle del notebook Jupyter. Vedi comportamento dello strumento NotebookEdit	Sì
`PowerShell`	Esegue comandi PowerShell nativamente. Vedi strumento PowerShell per la disponibilità	Sì
`PushNotification`	Invia una notifica desktop e una push su telefono quando Remote Control è connesso, in modo che un’attività di lunga durata o un’attività pianificata possa raggiungerti quando ti allontani. La consegna push viene eseguita attraverso l’infrastruttura ospitata da Anthropic, che non è accessibile da Amazon Bedrock, Google Vertex AI, o Microsoft Foundry	No
`Read`	Legge il contenuto dei file. Vedi comportamento dello strumento Read	No
`ReadMcpResourceTool`	Legge una risorsa MCP specifica per URI	No
`RemoteTrigger`	Crea, aggiorna, esegue ed elenca Routine su claude.ai. Supporta il comando `/schedule`. Le Routine vivono su claude.ai e richiedono un piano Pro, Max, Team, o Enterprise, quindi questo strumento non è accessibile da Amazon Bedrock, Google Vertex AI, o Microsoft Foundry	No
`SendMessage`	Invia un messaggio a un team di agenti compagno, o riprende un subagent per il suo ID agente. I subagent interrotti si riprendono automaticamente in background. Disponibile solo quando `CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1` è impostato	No
`ShareOnboardingGuide`	Carica `ONBOARDING.md` e restituisce un link di condivisione che i compagni di team possono aprire in Claude Code. Chiamato da `/team-onboarding` dopo che la guida è stata scritta. Disponibile per gli abbonati di claude.ai su piani Pro, Max, Team, ed Enterprise	Sì
`Skill`	Esegue una skill all’interno della conversazione principale	Sì
`TaskCreate`	Crea una nuova attività nell’elenco delle attività	No
`TaskGet`	Recupera i dettagli completi per un’attività specifica	No
`TaskList`	Elenca tutte le attività con il loro stato attuale	No
`TaskOutput`	(Deprecato) Recupera l’output da un’attività in background. Preferisci `Read` sul percorso del file di output dell’attività	No
`TaskStop`	Termina un’attività in background in esecuzione per ID	No
`TaskUpdate`	Aggiorna lo stato dell’attività, le dipendenze, i dettagli, o elimina le attività	No
`TeamCreate`	Crea un team di agenti con più compagni. Disponibile solo quando `CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1` è impostato	No
`TeamDelete`	Scioglie un team di agenti e pulisce i processi dei compagni. Disponibile solo quando `CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1` è impostato	No
`TodoWrite`	Gestisce l’elenco di controllo delle attività della sessione. Disponibile in modalità non interattiva e in Agent SDK; le sessioni interattive utilizzano TaskCreate, TaskGet, TaskList, e TaskUpdate	No
`ToolSearch`	Cerca e carica strumenti differiti quando tool search è abilitato	No
`WebFetch`	Recupera il contenuto da un URL specificato. Vedi comportamento dello strumento WebFetch	Sì
`WebSearch`	Esegue ricerche web. Vedi comportamento dello strumento WebSearch	Sì
`Write`	Crea o sovrascrivi file. Vedi comportamento dello strumento Write	Sì

Configura gli strumenti con regole di autorizzazione e hook

Per la maggior parte, Claude decide quando utilizzare questi strumenti e non è necessario nominarli tu stesso quando interagisci con Claude. Fai riferimento ai nomi degli strumenti direttamente quando definisci autorizzazioni e altre configurazioni:

in permissions.allow e permissions.deny nelle impostazioni, e nell’interfaccia /permissions
nei flag CLI --allowedTools e --disallowedTools
nelle opzioni allowedTools e disallowedTools dell’Agent SDK
nel frontmatter tools o disallowedTools di un subagent
nel frontmatter allowed-tools di una skill
nella condizione if di un hook

Tutti questi accettano lo stesso formato di regola, ToolName(specifier). Lo specifier dipende dallo strumento, e diversi strumenti condividono un formato:

Formato di regola	Si applica a	Dettagli
`Bash(npm run *)`	Bash, Monitor	Corrispondenza di pattern di comando
`PowerShell(Get-ChildItem *)`	PowerShell	Corrispondenza di pattern di comando
`Read(~/secrets/**)`	Read, Grep, Glob, LSP	Corrispondenza di pattern di percorso
`Edit(/src/**)`	Edit, Write, NotebookEdit	Corrispondenza di pattern di percorso
`Skill(deploy *)`	Skill	Corrispondenza di nome skill
`Agent(Explore)`	Agent	Corrispondenza di tipo subagent
`WebFetch(domain:example.com)`	WebFetch	Corrispondenza di dominio
`WebSearch`	WebSearch	Nessuno specifier; consenti o nega lo strumento nel suo insieme

Gli strumenti non elencati qui, come ExitPlanMode o ShareOnboardingGuide, accettano solo il nome dello strumento nudo senza specifier. Una regola di autorizzazione Edit(...) concede anche accesso in lettura allo stesso percorso, quindi non hai bisogno di una regola Read(...) corrispondente. I campi matcher degli hook utilizzano nomi di strumenti nudi, non il formato tra parentesi. Vedi matcher patterns per le regole di corrispondenza. Per i nomi di campo che ogni strumento passa a tool_input negli hook, vedi il riferimento di input PreToolUse.

Comportamento dello strumento Agent

Lo strumento Agent genera un subagent in una finestra di contesto separata. Il subagent lavora attraverso il suo compito autonomamente, quindi restituisce un singolo risultato di testo alla conversazione principale. Il genitore non vede le chiamate di strumento intermedie o gli output del subagent, solo quel risultato finale. Per limitare quanti turni un subagent esegue, imposta maxTurns nella definizione del subagent. Lo stesso strumento Agent avvia anche subagent biforcati quando la modalità fork è abilitata. Un fork eredita la conversazione principale completa invece di iniziare da zero, viene sempre eseguito in background, e comunque fa emergere i prompt di autorizzazione nel tuo terminale. Il resto di questa sezione descrive i subagent denominati. Quali strumenti un subagent denominato può utilizzare dipende dai campi tools e disallowedTools nella definizione del subagent:

Nessun campo impostato: il subagent eredita ogni strumento disponibile al genitore.
Solo tools: il subagent ottiene solo gli strumenti elencati.
Solo disallowedTools: il subagent ottiene ogni strumento del genitore tranne quelli elencati.
Entrambi impostati: disallowedTools ha la precedenza. Uno strumento elencato in entrambi viene rimosso.

L’avvio del subagent non richiede di per sé l’autorizzazione. Le chiamate di strumento del subagent vengono controllate rispetto alle tue regole di autorizzazione mentre viene eseguito:

Subagent in primo piano mostrano gli stessi prompt di autorizzazione che vedresti nella conversazione principale, nel momento in cui ogni chiamata di strumento accade.
Subagent in background non mostrano prompt. Vengono eseguiti con le autorizzazioni già concesse nella sessione e negano automaticamente qualsiasi chiamata di strumento che altrimenti richiederebbe un prompt. Dopo un rifiuto, il subagent continua senza quello strumento.

Per limitare cosa un subagent può raggiungere in primo luogo, restringi il suo campo tools, lascia Bash fuori dall’elenco, o imposta regole di negazione nelle tue impostazioni, come descritto in Controlla le capacità del subagent. Per ulteriori informazioni sulla scelta tra primo piano e background, vedi Esegui subagent in primo piano o background.

Comportamento dello strumento Bash

Lo strumento Bash esegue ogni comando in un processo separato con il seguente comportamento di persistenza:

Quando Claude esegue cd nella sessione principale, la nuova directory di lavoro viene mantenuta nei comandi Bash successivi finché rimane all’interno della directory del progetto o di una directory di lavoro aggiuntiva che hai aggiunto con --add-dir, /add-dir, o additionalDirectories nelle impostazioni. Le sessioni subagent non mantengono mai i cambiamenti della directory di lavoro.
- Se cd finisce al di fuori di quelle directory, Claude Code ripristina la directory del progetto e aggiunge Shell cwd was reset to <dir> al risultato dello strumento.
- Per disabilitare questo mantenimento in modo che ogni comando Bash inizi nella directory del progetto, imposta CLAUDE_BASH_MAINTAIN_PROJECT_WORKING_DIR=1.
Le variabili di ambiente non persistono. Un export in un comando non sarà disponibile nel successivo.

Attiva il tuo virtualenv o ambiente conda prima di avviare Claude Code. Per fare in modo che le variabili di ambiente persistano tra i comandi Bash, imposta CLAUDE_ENV_FILE su uno script shell prima di avviare Claude Code, oppure utilizza un hook SessionStart per popolarlo dinamicamente. Due limiti vincolano ogni comando:

Timeout: due minuti per impostazione predefinita. Claude può richiedere fino a 10 minuti per comando con il parametro timeout. Sostituisci il valore predefinito e il limite massimo con BASH_DEFAULT_TIMEOUT_MS e BASH_MAX_TIMEOUT_MS.
Lunghezza dell’output: 30.000 caratteri per impostazione predefinita. Quando un comando produce più di quello, Claude Code salva l’output completo in un file nella directory della sessione e fornisce a Claude il percorso del file più un’anteprima breve dall’inizio. Claude legge o cerca quel file quando ha bisogno del resto. Aumenta il limite con BASH_MAX_OUTPUT_LENGTH, fino a un limite massimo fisso di 150.000 caratteri.

Per processi di lunga durata come server di sviluppo o build di watch, Claude può impostare run_in_background: true per avviare il comando come attività in background e continuare a lavorare mentre viene eseguito. Elenca e interrompi le attività in background con /tasks.

Comportamento dello strumento Edit

Lo strumento Edit esegue la sostituzione di stringhe esatte. Prende un old_string e un new_string e sostituisce il primo con il secondo. Non utilizza regex o corrispondenza fuzzy. Tre controlli devono passare affinché un’edit si applichi:

Lettura prima dell’edit: Claude deve aver letto il file nella conversazione corrente, e il file non deve essere cambiato su disco da quella lettura. Questo controllo viene eseguito per primo, prima di qualsiasi corrispondenza di stringhe.
Corrispondenza: old_string deve apparire nel file esattamente come scritto. Una singola differenza di carattere di spazio o indentazione è sufficiente per mancare.
Unicità: old_string deve apparire esattamente una volta. Quando appare più di una volta, Claude fornisce una stringa più lunga con abbastanza contesto circostante per individuare un’occorrenza, o imposta replace_all: true per sostituirle tutte.

Visualizzare un file con Bash soddisfa anche il requisito di lettura prima dell’edit quando il comando è cat path/to/file o sed -n 'X,Yp' path/to/file su un singolo file senza pipe o reindirizzamenti. Altri comandi Bash come head, tail, o output con pipe non contano, e Claude deve utilizzare Read prima di modificare in quei casi. Questo influisce solo sull’idoneità dell’edit, non sulle autorizzazioni. Le regole di negazione Read e Edit si applicano anche ai comandi di file che Claude Code riconosce in Bash, come cat, head, tail, e sed, ma non ai sottoprocessi arbitrari che leggono o scrivono file indirettamente, come uno script Python o Node che apre file da solo. Per l’applicazione a livello di sistema operativo che copre ogni processo, abilita la sandbox.

Comportamento dello strumento Glob

Lo strumento Glob trova file per pattern di nome. Supporta la sintassi glob standard incluso ** per la corrispondenza ricorsiva di directory:

**/*.js corrisponde a tutti i file .js a qualsiasi profondità
src/**/*.ts corrisponde a tutti i file .ts sotto src/
*.{json,yaml} corrisponde ai file .json e .yaml nella directory corrente

I risultati sono ordinati per tempo di modifica e limitati a 100 file. Se il limite viene raggiunto, Claude vede un flag di troncamento nel risultato e può restringere il pattern. Glob non rispetta .gitignore per impostazione predefinita, quindi trova file gitignored insieme a quelli tracciati. Questo differisce da Grep, che salta i file gitignored. Per fare in modo che Glob rispetti .gitignore, imposta CLAUDE_CODE_GLOB_NO_IGNORE=false prima di avviare Claude Code.

Comportamento dello strumento Grep

Lo strumento Grep cerca pattern nei contenuti dei file. Dove Glob trova file per nome, Grep trova righe dentro di loro. Grep è costruito su ripgrep e utilizza la sintassi regex di ripgrep, non grep POSIX. I pattern che includono metacaratteri regex hanno bisogno di escape. Ad esempio, trovare interface{} nel codice Go richiede il pattern interface\{\}. Tre modalità di output controllano cosa viene restituito:

files_with_matches: solo percorsi di file, nessun contenuto di riga. Questo è il valore predefinito.
content: righe corrispondenti con file e numero di riga.
count: conteggio delle corrispondenze per file.

Claude può limitare i risultati per file con il parametro glob, come **/*.tsx, o per linguaggio con il parametro type, come py o rust. Per impostazione predefinita, i pattern corrispondono all’interno di una singola riga. Claude può impostare multiline: true per corrispondere attraverso i confini di riga. Grep rispetta .gitignore, quindi i file gitignored vengono saltati. Per cercare un file gitignored, Claude passa il suo percorso direttamente.

Comportamento dello strumento LSP

Lo strumento LSP fornisce a Claude intelligenza del codice da un language server in esecuzione. Dopo ogni modifica di file, segnala automaticamente errori di tipo e avvisi in modo che Claude possa correggere i problemi senza un passaggio di compilazione separato. Claude può anche chiamarlo direttamente per navigare il codice:

Salta alla definizione di un simbolo
Trova tutti i riferimenti a un simbolo
Ottieni informazioni sul tipo in una posizione
Elenca i simboli in un file o workspace
Trova implementazioni di un’interfaccia
Traccia gerarchie di chiamate

Lo strumento è inattivo finché non installi un plugin di intelligenza del codice per il tuo linguaggio. Il plugin raggruppa la configurazione del language server, e installi il binario del server separatamente.

Strumento Monitor

Lo strumento Monitor richiede Claude Code v2.1.98 o successivo.

Lo strumento Monitor consente a Claude di osservare qualcosa in background e reagire quando cambia, senza mettere in pausa la conversazione. Chiedi a Claude di:

Monitorare un file di log e segnalare gli errori man mano che appaiono
Eseguire il polling di una PR o di un lavoro CI e segnalare quando il suo stato cambia
Osservare una directory per i cambiamenti di file
Tracciare l’output da qualsiasi script di lunga durata che gli indichi

Claude scrive un piccolo script per l’osservazione, lo esegue in background e riceve ogni riga di output man mano che arriva. Continui a lavorare nella stessa sessione e Claude interviene quando un evento si verifica. Interrompi un monitor chiedendo a Claude di annullarlo o terminando la sessione. Monitor utilizza le stesse regole di autorizzazione di Bash, quindi i pattern allow e deny che hai impostato per Bash si applicano anche qui. Non è disponibile su Amazon Bedrock, Google Vertex AI, o Microsoft Foundry. Non è disponibile nemmeno quando DISABLE_TELEMETRY o CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC è impostato. I plugin possono dichiarare monitor che si avviano automaticamente quando il plugin è attivo, invece di chiedere a Claude di avviarli. Vedi plugin monitors.

Comportamento dello strumento NotebookEdit

NotebookEdit modifica un notebook Jupyter una cella alla volta, puntando alle celle per il loro cell_id. Non esegue la sostituzione di stringhe attraverso il notebook come fa Edit sui file semplici. Tre modalità di edit controllano cosa accade alla cella target:

replace: sovrascrivi la sorgente della cella. Questo è il valore predefinito.
insert: aggiungi una nuova cella dopo la target. Senza cell_id, la nuova cella va all’inizio del notebook. Richiede cell_type impostato a code o markdown.
delete: rimuovi la cella target.

Le regole di autorizzazione utilizzano il formato di percorso Edit(...). Una regola come Edit(notebooks/**) copre le chiamate NotebookEdit su file in quella directory.

Strumento PowerShell

Lo strumento PowerShell consente a Claude di eseguire comandi PowerShell nativamente. Su Windows, questo significa che i comandi vengono eseguiti in PowerShell invece di essere instradati attraverso Git Bash. Su Windows senza Git Bash, lo strumento è abilitato automaticamente. Su Windows con Git Bash installato, lo strumento è in rollout progressivo. Su Linux, macOS e WSL, lo strumento è opt-in.

Abilita lo strumento PowerShell

Imposta CLAUDE_CODE_USE_POWERSHELL_TOOL=1 nel tuo ambiente o in settings.json:

{
  "env": {
    "CLAUDE_CODE_USE_POWERSHELL_TOOL": "1"
  }
}

Su Windows, imposta la variabile a 0 per rinunciare al rollout. Su Linux, macOS e WSL, lo strumento richiede PowerShell 7 o successivo: installa pwsh e assicurati che sia nel tuo PATH. Su Windows, Claude Code rileva automaticamente pwsh.exe per PowerShell 7+ con un fallback a powershell.exe per PowerShell 5.1. Quando lo strumento è abilitato, Claude tratta PowerShell come la shell primaria. Lo strumento Bash rimane disponibile per gli script POSIX quando Git Bash è installato.

Selezione della shell nelle impostazioni, negli hook e nelle skill

Tre impostazioni aggiuntive controllano dove viene utilizzato PowerShell:

"defaultShell": "powershell" in settings.json: instrada i comandi interattivi ! attraverso PowerShell. Richiede che lo strumento PowerShell sia abilitato.
"shell": "powershell" su singoli hook di comando: esegue quell’hook in PowerShell. Gli hook avviano PowerShell direttamente, quindi funziona indipendentemente da CLAUDE_CODE_USE_POWERSHELL_TOOL.
shell: powershell nel frontmatter della skill: esegue i blocchi !`command` in PowerShell. Richiede che lo strumento PowerShell sia abilitato.

Lo stesso comportamento di ripristino della directory di lavoro della sessione principale descritto nella sezione dello strumento Bash si applica ai comandi PowerShell, inclusa la variabile di ambiente CLAUDE_BASH_MAINTAIN_PROJECT_WORKING_DIR.

Limitazioni dell’anteprima

Lo strumento PowerShell ha le seguenti limitazioni note durante l’anteprima:

I profili PowerShell non vengono caricati
Su Windows, il sandboxing non è supportato

Comportamento dello strumento Read

Lo strumento Read prende un percorso di file e restituisce i contenuti con numeri di riga. Claude è istruito a passare sempre percorsi assoluti. Per impostazione predefinita, Read restituisce il file dall’inizio. I file oltre una soglia di dimensione restituiscono un errore piuttosto che contenuto parziale, richiedendo a Claude di riprovare con offset e limit per leggere un intervallo specifico. Read gestisce diversi tipi di file oltre al testo semplice:

Immagini: PNG, JPG e altri formati di immagine vengono restituiti come contenuto visivo che Claude può vedere, non come byte grezzi. Claude Code ridimensiona e ricomprime le immagini grandi per adattarsi ai limiti di dimensione dell’immagine del modello prima di inviarle, quindi Claude potrebbe vedere una versione ridotta di uno screenshot grande. Se Claude perde dettagli a livello di pixel fine in un’immagine grande, chiedigli di ritagliare prima la regione di interesse, ad esempio con ImageMagick tramite Bash.
PDF: Claude legge file .pdf brevi nel loro insieme. Per i PDF più lunghi di 10 pagine, legge in intervalli con un parametro pages, come "1-5", fino a 20 pagine alla volta.
Notebook Jupyter: i file .ipynb restituiscono tutte le celle con i loro output, inclusi codice, markdown e visualizzazioni.

Read legge solo file, non directory. Claude utilizza ls tramite lo strumento Bash per elencare i contenuti della directory.

Comportamento dello strumento WebFetch

WebFetch prende un URL e un prompt che descrive cosa estrarre. Recupera la pagina, converte la risposta in Markdown quando il server restituisce HTML, ed esegue il prompt contro il contenuto utilizzando un modello piccolo e veloce. Per la maggior parte dei recuperi, Claude riceve la risposta di quel modello, non la pagina grezza. Il passaggio di conversione non è configurabile. Questo rende WebFetch lossy per progettazione. Il prompt di estrazione determina cosa raggiunge Claude, quindi un risultato che dice che una pagina non menziona qualcosa potrebbe significare solo che il prompt non l’ha chiesto. Chiedi a Claude di recuperare di nuovo con un prompt più specifico, o utilizza curl tramite Bash per la pagina non elaborata. Alcuni comportamenti modellano la risposta che Claude riceve:

Gli URL HTTP vengono automaticamente aggiornati a HTTPS.
Le pagine grandi vengono troncate a un limite di caratteri fisso prima dell’elaborazione.
Le risposte vengono memorizzate nella cache per 15 minuti, quindi i recuperi ripetuti dello stesso URL vengono restituiti rapidamente.
Quando un URL reindirizza a un host diverso, WebFetch restituisce un risultato di testo che nomina l’URL originale e il target di reindirizzamento invece di seguirlo. Claude quindi recupera il nuovo URL con una seconda chiamata WebFetch.

Nelle modalità di autorizzazione predefinita e acceptEdits, WebFetch richiede la prima volta che raggiunge un nuovo dominio. Per consentire un dominio in anticipo senza un prompt, aggiungi una regola di autorizzazione come WebFetch(domain:example.com). Le modalità di autorizzazione auto e bypassPermissions saltano completamente il prompt. WebFetch imposta un’intestazione User-Agent che inizia con Claude-User, e un’intestazione Accept che preferisce Markdown a HTML in modo che i server che supportano la negoziazione dei contenuti possano restituire Markdown direttamente. Le regole di rete della Sandbox sono configurate separatamente, quindi un dominio che vuoi che un processo in sandbox raggiunga ha ancora bisogno di una regola di autorizzazione sandbox esplicita.

Comportamento dello strumento WebSearch

WebSearch esegue una query rispetto al backend di web search di Anthropic e restituisce titoli e URL dei risultati. Non recupera le pagine dei risultati. Per leggere una pagina che Claude trova nei risultati di ricerca, segue con WebFetch. Lo strumento può emettere fino a otto ricerche backend per chiamata, affinando la ricerca internamente prima di restituire i risultati. Claude può limitare i risultati con allowed_domains per includere solo determinati host, o blocked_domains per escluderli. I due elenchi non possono essere combinati in una singola chiamata. Il backend di ricerca non è configurabile. Per cercare con un provider diverso, aggiungi un server MCP che espone uno strumento di ricerca. Le regole di autorizzazione WebSearch non accettano specifier. Una voce WebSearch nuda in allow o deny è l’unica forma.

WebSearch è disponibile sull’API Claude e su Microsoft Foundry. Su Google Cloud Vertex AI funziona con i modelli Claude 4, inclusi Opus, Sonnet, e Haiku. Amazon Bedrock non espone lo strumento di web search lato server.

Comportamento dello strumento Write

Lo strumento Write crea un nuovo file o sovrascrivi uno esistente con il contenuto completo fornito. Non aggiunge o unisce. Se il percorso target esiste già, Claude deve aver letto quel file almeno una volta nella conversazione corrente prima di sovrascriverlo. Una Write a un file esistente non letto fallisce con un errore. Questo vincolo non si applica ai nuovi file. Visualizzare il file con Bash cat o sed -n soddisfa anche questo requisito, come descritto in comportamento dello strumento Edit. Per modifiche parziali a un file esistente, Claude utilizza Edit invece di Write.

Verifica quali strumenti sono disponibili

Il tuo set esatto di strumenti dipende dal tuo provider, dalla piattaforma e dalle impostazioni. Per verificare cosa è caricato in una sessione in esecuzione, chiedi direttamente a Claude:

What tools do you have access to?

Claude fornisce un riepilogo conversazionale. Per i nomi esatti degli strumenti MCP, esegui /mcp.

Vedi anche

Server MCP: aggiungi strumenti personalizzati connettendo server esterni
Autorizzazioni: sistema di autorizzazione, sintassi delle regole, e pattern specifici dello strumento
Subagent: configura l’accesso agli strumenti per i subagent
Hooks: esegui comandi personalizzati prima o dopo l’esecuzione dello strumento

Riferimento

Glossario

Documentation Index

​Configura gli strumenti con regole di autorizzazione e hook

​Comportamento dello strumento Agent

​Comportamento dello strumento Bash

​Comportamento dello strumento Edit

​Comportamento dello strumento Glob

​Comportamento dello strumento Grep

​Comportamento dello strumento LSP

​Strumento Monitor

​Comportamento dello strumento NotebookEdit

​Strumento PowerShell

​Abilita lo strumento PowerShell

​Selezione della shell nelle impostazioni, negli hook e nelle skill

​Limitazioni dell’anteprima

​Comportamento dello strumento Read

​Comportamento dello strumento WebFetch

​Comportamento dello strumento WebSearch

​Comportamento dello strumento Write

​Verifica quali strumenti sono disponibili

​Vedi anche

Configura gli strumenti con regole di autorizzazione e hook

Comportamento dello strumento Agent

Comportamento dello strumento Bash

Comportamento dello strumento Edit

Comportamento dello strumento Glob

Comportamento dello strumento Grep

Comportamento dello strumento LSP

Strumento Monitor

Comportamento dello strumento NotebookEdit

Strumento PowerShell

Abilita lo strumento PowerShell

Selezione della shell nelle impostazioni, negli hook e nelle skill

Limitazioni dell’anteprima

Comportamento dello strumento Read

Comportamento dello strumento WebFetch

Comportamento dello strumento WebSearch

Comportamento dello strumento Write

Verifica quali strumenti sono disponibili

Vedi anche