Uso degli strumenti con Claude

L'uso degli strumenti consente a Claude di chiamare funzioni che definisci o che fornisce Anthropic. Claude decide quando chiamare uno strumento in base alla richiesta dell'utente e alla descrizione dello strumento, quindi restituisce una chiamata strutturata che la tua applicazione esegue (strumenti client) o che Anthropic esegue (strumenti server).

Ecco l'esempio più semplice utilizzando uno strumento server, dove Anthropic gestisce l'esecuzione:

import anthropic

client = anthropic.Anthropic()
response = client.messages.create(
    model="claude-opus-4-7",
    max_tokens=1024,
    tools=[{"type": "web_search_20260209", "name": "web_search"}],
    messages=[{"role": "user", "content": "What's the latest on the Mars rover?"}],
)
print(response.content)

Come funziona l'uso degli strumenti

Gli strumenti differiscono principalmente per il luogo in cui viene eseguito il codice. Gli strumenti client (inclusi gli strumenti definiti dall'utente e gli strumenti dello schema Anthropic come bash e text_editor) vengono eseguiti nella tua applicazione: Claude risponde con stop_reason: "tool_use" e uno o più blocchi tool_use, il tuo codice esegue l'operazione e tu rimandi un tool_result. Gli strumenti server (web_search, code_execution, web_fetch, tool_search) vengono eseguiti sull'infrastruttura di Anthropic: vedi i risultati direttamente senza gestire l'esecuzione.

Per il modello concettuale completo incluso il ciclo agentivo e quando scegliere ogni approccio, vedi Come funziona l'uso degli strumenti.

Per la connessione ai server MCP, vedi il connettore MCP. Per costruire il tuo client MCP, vedi modelcontextprotocol.io.

L'accesso agli strumenti è uno dei primitivi con il più alto valore che puoi dare a un agente. Su benchmark come LAB-Bench FigQA (interpretazione di figure scientifiche) e SWE-bench (ingegneria del software nel mondo reale), aggiungere anche strumenti di base produce guadagni di capacità sproporzionati, spesso superando i livelli di base degli esperti umani.

Esempi di uso degli strumenti

Per una procedura dettagliata completa, vedi il tutorial. Per esempi di riferimento di concetti individuali, vedi Definire gli strumenti e Gestire le chiamate degli strumenti.

Prezzi

Tool use requests are priced based on:

1. The total number of input tokens sent to the model (including in the tools parameter)
2. The number of output tokens generated
3. For server-side tools, additional usage-based pricing (e.g., web search charges per search performed)

Client-side tools are priced the same as any other Claude API request, while server-side tools may incur additional charges based on their specific usage.

The additional tokens from tool use come from:

• The tools parameter in API requests (tool names, descriptions, and schemas)
• tool_use content blocks in API requests and responses
• tool_result content blocks in API requests

When you use tools, the API also automatically includes a special system prompt for the model which enables tool use. The number of tool use tokens required for each model are listed below (excluding the additional tokens listed above). Note that the table assumes at least 1 tool is provided. If no tools are provided, then a tool choice of none uses 0 additional system prompt tokens.

These token counts are added to your normal input and output tokens to calculate the total cost of a request.

Fai riferimento alla tabella di panoramica dei modelli per i prezzi attuali per modello.

Quando invii un prompt di uso degli strumenti, proprio come qualsiasi altra richiesta API, la risposta restituirà sia i conteggi dei token di input che di output come parte delle metriche usage segnalate.

Passaggi successivi

Scegli il tuo percorso