---
title: Riferimento degli strumenti
url: https://platform.claude.com/docs/it/agents-and-tools/tool-use/tool-reference
description: Elenco degli strumenti server, degli strumenti client e dei toolset client forniti da Anthropic, più il riferimento per le proprietà opzionali delle definizioni degli strumenti.
---

Questa pagina è un riferimento per gli strumenti forniti da Anthropic e per le proprietà opzionali che puoi impostare su qualsiasi definizione di strumento. Per un’introduzione concettuale al “tool use” (uso degli strumenti), consulta [Uso degli strumenti con Claude](https://platform.claude.com/docs/it/agents-and-tools/tool-use/overview). Per indicazioni su come implementare l’uso degli strumenti nella tua applicazione, consulta [Definire gli strumenti](https://platform.claude.com/docs/it/agents-and-tools/tool-use/define-tools).

## Strumenti forniti da Anthropic

Anthropic fornisce due tipi di strumenti: gli **strumenti server**, che vengono eseguiti sull’infrastruttura di Anthropic, e gli **strumenti client**, per i quali Anthropic definisce lo schema ma è la tua applicazione a gestirne l’esecuzione. Entrambi i tipi compaiono nell’array `tools` della tua richiesta insieme a eventuali strumenti definiti dall’utente.

| Strumento | `type` | Esecuzione | [Header beta](https://platform.claude.com/docs/it/api/beta-headers) |
| ----- | ----- | ----- | ----- |
| [Strumento di ricerca web](https://platform.claude.com/docs/it/agents-and-tools/tool-use/web-search-tool) | `web_search_20260318`<br />`web_search_20260209`<br />`web_search_20250305` | Server | Nessuno |
| [Strumento web fetch](https://platform.claude.com/docs/it/agents-and-tools/tool-use/web-fetch-tool) | `web_fetch_20260318`<br />`web_fetch_20260309`<br />`web_fetch_20260209`<br />`web_fetch_20250910` | Server | Nessuno |
| [Strumento di esecuzione del codice](https://platform.claude.com/docs/it/agents-and-tools/tool-use/code-execution-tool) | `code_execution_20260521`<br />`code_execution_20260120`<br />`code_execution_20250825` | Server | Nessuno |
| [Strumento advisor](https://platform.claude.com/docs/it/agents-and-tools/tool-use/advisor-tool) | `advisor_20260301` | Server | `advisor-tool-2026-03-01` |
| [Strumento di ricerca strumenti](https://platform.claude.com/docs/it/agents-and-tools/tool-use/tool-search-tool) | `tool_search_tool_regex_20251119`<br />`tool_search_tool_bm25_20251119` | Server | Nessuno |
| [Connettore MCP](https://platform.claude.com/docs/it/agents-and-tools/mcp-connector) | `mcp_toolset` | Server | `mcp-client-2025-11-20` |
| [Strumento memoria](https://platform.claude.com/docs/it/agents-and-tools/tool-use/memory-tool) | `memory_20250818` | Client | Nessuno |
| [Strumento Bash](https://platform.claude.com/docs/it/agents-and-tools/tool-use/bash-tool) | `bash_20250124` | Client | Nessuno |
| [Strumento editor di testo](https://platform.claude.com/docs/it/agents-and-tools/tool-use/text-editor-tool) | `text_editor_20250728`<br />`text_editor_20250124` | Client | Nessuno |
| [Strumento computer use](https://platform.claude.com/docs/it/agents-and-tools/tool-use/computer-use-tool) | `computer_toolset_20260801`<br />`computer_20251124`<br />`computer_20250124` | Client | Nessuno<br />`computer-use-2025-11-24`<br />`computer-use-2025-01-24` |
| [Strumento browser use](https://platform.claude.com/docs/it/agents-and-tools/tool-use/browser-use-tool) | `browser_toolset_20260801` | Client | Nessuno |

Per la compatibilità dei modelli, consulta la pagina di ciascuno strumento. I modelli supportati variano in base allo strumento e alla versione dello strumento. Per verificare dal tuo codice se un modello accetta la ricerca web o l’esecuzione del codice, consulta [Utilizzo della Models API](https://platform.claude.com/docs/it/models/overview#using-the-models-api).

<Note>
  I valori `type` della ricerca degli strumenti accettano anche alias senza data: `tool_search_tool_regex` e `tool_search_tool_bm25`. Questi vengono risolti nell’ultima versione datata.
</Note>

### Versionamento degli strumenti

La maggior parte degli strumenti forniti da Anthropic riporta un suffisso `_YYYYMMDD` nella stringa `type`. Una nuova versione viene rilasciata quando cambiano il comportamento, lo schema o il supporto dei modelli dello strumento. Le versioni precedenti restano disponibili affinché le integrazioni esistenti continuino a funzionare.

Quando uno strumento ha più versioni attive, la relazione tra di esse varia:

* **Basate sulle funzionalità:** `web_search_20260209` e `web_fetch_20260209` aggiungono il filtraggio dinamico dei contenuti rispetto ai loro predecessori; `web_fetch_20260309` aggiunge un’opzione per bypassare la cache; `web_search_20260318` e `web_fetch_20260318` aggiungono il controllo dell’inclusione nella risposta. `code_execution_20260120` aggiunge la [chiamata programmatica degli strumenti](https://platform.claude.com/docs/it/agents-and-tools/tool-use/programmatic-tool-calling) dall’interno della sandbox; `code_execution_20260521` indica il limite di tempo per cella nella descrizione dello strumento. In ogni caso, sia la nuova sia la vecchia versione sono attuali; quale usare dipende dal fatto che ti serva o meno la nuova funzionalità.
* **Basate sul modello:** `text_editor_20250728` è per Claude 4 e i modelli successivi, mentre `text_editor_20250124` è per i modelli precedenti. La versione da usare dipende dal modello a cui ti rivolgi.
* **Variante, non versione:** `tool_search_tool_regex_20251119` e `tool_search_tool_bm25_20251119` sono due algoritmi di ricerca rilasciati insieme. Nessuno dei due sostituisce l’altro.
* **Legacy:** `code_execution_20250522` supporta solo Python. `code_execution_20250825` aggiunge Bash e le operazioni sui file.
* **Successore:** `computer_toolset_20260801` è il successore stabile delle versioni beta `computer_20251124` e `computer_20250124`, che sono disponibili sui modelli elencati per esse in [Versioni precedenti dello strumento](https://platform.claude.com/docs/it/agents-and-tools/tool-use/computer-use-tool#earlier-tool-versions). `browser_toolset_20260801` è la prima versione dello strumento browser use. Entrambi sono [toolset client](https://platform.claude.com/docs/it/agents-and-tools/tool-use/tool-reference#client-toolsets).

Il tipo `mcp_toolset` non è versionato per data; il versionamento è invece gestito tramite l’header `anthropic-beta`.

### Toolset client

Lo [strumento computer use](https://platform.claude.com/docs/it/agents-and-tools/tool-use/computer-use-tool) e lo [strumento browser use](https://platform.claude.com/docs/it/agents-and-tools/tool-use/browser-use-tool) sono toolset client definiti da Anthropic: una singola voce in `tools` dichiara un insieme fisso di strumenti membri i cui nomi, descrizioni e schemi di input sono definiti da Anthropic, e la tua applicazione esegue ogni chiamata. La voce non accetta un `name`, perché il `type` datato fissa i nomi dei membri. `configs`, `cache_control` e `allowed_callers` (che accetta solo `["direct"]`) sono opzionali.

I toolset client sono strumenti della Messages API. Non sono attualmente disponibili come strumenti agente in [Claude Managed Agents](https://platform.claude.com/docs/it/managed-agents/tools), che fornisce il proprio toolset agente integrato, toolset MCP e strumenti personalizzati.

```json
{
  "type": "browser_toolset_20260801",
  "configs": {
    "javascript_exec": { "enabled": true }
  },
  "cache_control": { "type": "ephemeral" }
}
```

`configs` regola i singoli membri:

* Le chiavi sono i nomi dei membri e ogni valore accetta solo `enabled` e `defer_loading`.
* Un membro omesso mantiene i suoi valori predefiniti. Un valore assente, `{}` e un valore predefinito ribadito sono equivalenti.
* Un nome di membro sconosciuto o qualsiasi altro campo nel valore di un membro viene rifiutato, così come un `configs` che disabilita tutti i membri (ometti invece la voce).
* Un membro disabilitato viene rimosso dagli strumenti che Claude riceve. Se Claude lo nomina comunque, restituisci un `tool_result` di errore.

Imposta `defer_loading` per ciascun membro, mai sulla voce, e assegna a ogni membro abilitato lo stesso valore: con la [ricerca degli strumenti](https://platform.claude.com/docs/it/agents-and-tools/tool-use/tool-search-tool#deferred-tool-loading) il toolset viene caricato ed espanso come un’unica definizione. Quando tutti i membri abilitati sono differiti, solo uno [strumento di ricerca degli strumenti](https://platform.claude.com/docs/it/agents-and-tools/tool-use/tool-search-tool) che non sia a sua volta differito può far emergere il toolset, quindi dichiarane uno nella stessa richiesta. Non inserire `cache_control` su una voce di toolset i cui membri sono differiti; imposta invece il breakpoint su uno strumento non differito, perché le definizioni differite non fanno parte del prefisso memorizzato nella cache.

`cache_control` va solo sulla voce; per sapere dove ricade il breakpoint, inclusi i marcatori all’interno di un’azione batch, consulta [Uso degli strumenti con la cache dei prompt](https://platform.claude.com/docs/it/agents-and-tools/tool-use/tool-use-with-prompt-caching#cache-control-on-tool-definitions).

**Gestisci le chiamate agli strumenti membri.** Claude chiama un membro con un blocco `tool_use` il cui `name` è il nome del membro e il cui `toolset_name` è `computer` o `browser`; `input` contiene i parametri di quel membro e nessun campo `action`. Smista le chiamate in base alla coppia `toolset_name` e `name`, perché uno strumento personalizzato potrebbe condividere il nome di un membro e i due toolset condividono nomi come `screenshot`. Solo i risultati dei membri riportano `toolset_name`. Più chiamate a membri in un singolo turno formano un’azione batch da eseguire in ordine ([computer use](https://platform.claude.com/docs/it/agents-and-tools/tool-use/computer-use-tool#batch-actions), [browser use](https://platform.claude.com/docs/it/agents-and-tools/tool-use/browser-use-tool#batch-actions)). Nuovi membri arrivano solo con un nuovo `type` datato.

**Non supportato sulle voci di toolset.** L’API rifiuta ciascuno di questi con un `invalid_request_error`:

* `strict: true` o `input_examples`.
* `defer_loading` sulla voce, oppure membri abilitati i cui valori di `defer_loading` differiscono (impostalo per ciascun membro in `configs`, tutti con lo stesso valore).
* Un chiamante di esecuzione del codice in `allowed_callers` (nessuna [chiamata programmatica degli strumenti](https://platform.claude.com/docs/it/agents-and-tools/tool-use/programmatic-tool-calling)).
* L’header beta `fine-grained-tool-streaming-2025-05-14`. Quando usi lo streaming, l’`input` di ciascun membro arriva come un unico `input_json_delta` completo.
* Un `tool_choice` di tipo `tool` che nomina il toolset o un membro (usa `auto`, `any` o `none`).
* Due voci dello stesso toolset, oppure un altro strumento che porta il nome di quel toolset: uno strumento chiamato `computer` insieme a `computer_toolset_20260801`, oppure uno strumento chiamato `browser` insieme a `browser_toolset_20260801`. I due toolset possono essere dichiarati insieme.

## Proprietà delle definizioni degli strumenti

Ogni strumento nell’array `tools`, inclusi gli strumenti definiti dall’utente, accetta proprietà opzionali che controllano come lo strumento viene caricato, chi può chiamarlo e come vengono validati i suoi input. Puoi combinare queste proprietà, con due eccezioni: uno strumento con `defer_loading: true` non può avere anche `cache_control`, e uno strumento definito dall’utente con `strict: true` non può elencare un chiamante di esecuzione del codice in `allowed_callers`.

| Proprietà | Scopo | Disponibile su | Guida dettagliata |
| ----- | ----- | ----- | ----- |
| `cache_control` | Imposta un breakpoint della cache dei prompt in corrispondenza di questa definizione di strumento | Tutti gli strumenti (su `computer_toolset_20260801` e `browser_toolset_20260801`, impostalo sulla voce del toolset stessa, non all’interno dei `configs` dei membri) | [Cache dei prompt](https://platform.claude.com/docs/it/build-with-claude/prompt-caching) |
| `strict` | Garantisce la convalida dello schema sui nomi e sugli input degli strumenti | Tutti gli strumenti tranne `mcp_toolset`, `computer_toolset_20260801` e `browser_toolset_20260801` | [Uso rigoroso degli strumenti](https://platform.claude.com/docs/it/agents-and-tools/tool-use/strict-tool-use) |
| `defer_loading` | Esclude lo strumento dal prompt di sistema iniziale; lo carica su richiesta quando la ricerca degli strumenti restituisce un `tool_reference` per esso | Tutti gli strumenti (per `mcp_toolset`, consulta la [configurazione del toolset MCP](https://platform.claude.com/docs/it/agents-and-tools/mcp-connector#mcp-toolset-configuration)). Sui toolset computer use e browser use, impostalo per ciascun membro all’interno di `configs`; consulta [Toolset client](https://platform.claude.com/docs/it/agents-and-tools/tool-use/tool-reference#client-toolsets). | [Strumento di ricerca degli strumenti](https://platform.claude.com/docs/it/agents-and-tools/tool-use/tool-search-tool) |
| `allowed_callers` | Limita quali chiamanti possono chiamare lo strumento | Tutti gli strumenti tranne `mcp_toolset` (su `computer_toolset_20260801` e `browser_toolset_20260801` è accettato solo `["direct"]`; consulta [Toolset client](https://platform.claude.com/docs/it/agents-and-tools/tool-use/tool-reference#client-toolsets)) | [Chiamata programmatica degli strumenti](https://platform.claude.com/docs/it/agents-and-tools/tool-use/programmatic-tool-calling#the-allowed-callers-field) |
| `input_examples` | Fornisce oggetti di input di esempio per mostrare a Claude come chiamare lo strumento | Strumenti definiti dall’utente e strumenti client con schema Anthropic, tranne `computer_toolset_20260801` e `browser_toolset_20260801`. Non disponibile sugli strumenti server. | [Definire gli strumenti](https://platform.claude.com/docs/it/agents-and-tools/tool-use/define-tools#providing-tool-use-examples) |
| `eager_input_streaming` | Abilita lo streaming granulare degli input (`true`) o mantiene lo streaming standard con buffer (`false`) per questo strumento | Solo strumenti definiti dall’utente | [Streaming granulare degli strumenti](https://platform.claude.com/docs/it/agents-and-tools/tool-use/fine-grained-tool-streaming) |

### Valori di `allowed_callers`

`allowed_callers` è un array che accetta qualsiasi combinazione di:

| Valore | Significato |
| ----- | ----- |
| `"direct"` | Il modello può chiamare questo strumento direttamente in un blocco `tool_use`. Questo è il valore predefinito se `allowed_callers` viene omesso. |
| `"code_execution_20260120"` | Il codice in esecuzione all’interno di una sandbox `code_execution_20260120` o successiva può chiamare questo strumento. |

Sia `"code_execution_20260120"` che `"code_execution_20260521"` sono accettati in `allowed_callers` e sono intercambiabili: una richiesta che usa una qualsiasi delle due versioni dello strumento di esecuzione del codice soddisfa gli strumenti che elencano uno qualsiasi dei due chiamanti. I blocchi di risposta etichettano sempre il chiamante come `code_execution_20260120` indipendentemente dalla versione dichiarata nella richiesta.

Omettere `"direct"` dall’array (ad esempio, `"allowed_callers": ["code_execution_20260120"]`) induce Claude a chiamare lo strumento solo dall’interno dell’esecuzione del codice. Il blocco `tool_use` della risposta include un campo `caller` che identifica quale chiamante ha chiamato lo strumento. Consulta [Chiamata programmatica degli strumenti](https://platform.claude.com/docs/it/agents-and-tools/tool-use/programmatic-tool-calling#the-allowed-callers-field) per la trattazione completa, inclusa la forma della risposta `caller` e il comportamento in caso di errore.

### `defer_loading` e cache dei prompt

`defer_loading: true` preserva la tua “prompt cache” (cache dei prompt): la ricerca degli strumenti può caricare uno strumento differito durante una conversazione senza invalidare una voce di cache esistente. Inserisci i breakpoint `cache_control` sugli strumenti non differiti. Per scoprire come gli strumenti differiti mantengono valida la cache, consulta [`defer_loading` e preservazione della cache](https://platform.claude.com/docs/it/agents-and-tools/tool-use/tool-use-with-prompt-caching#defer-loading-and-cache-preservation).
