Utilisation d'outils avec Claude

L'utilisation d'outils permet à Claude d'appeler des fonctions que vous définissez ou que Anthropic fournit. Claude décide quand appeler un outil en fonction de la demande de l'utilisateur et de la description de l'outil, puis retourne un appel structuré que votre application exécute (outils clients) ou qu'Anthropic exécute (outils serveur).

Voici l'exemple le plus simple utilisant un outil serveur, où Anthropic gère l'exécution :

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)

Comment fonctionne l'utilisation d'outils

Les outils diffèrent principalement par le lieu d'exécution du code. Les outils clients (y compris les outils définis par l'utilisateur et les outils de schéma Anthropic comme bash et text_editor) s'exécutent dans votre application : Claude répond avec stop_reason: "tool_use" et un ou plusieurs blocs tool_use, votre code exécute l'opération, et vous renvoyez un tool_result. Les outils serveur (web_search, code_execution, web_fetch, tool_search) s'exécutent sur l'infrastructure d'Anthropic : vous voyez les résultats directement sans gérer l'exécution.

Pour le modèle conceptuel complet incluant la boucle agentive et quand choisir chaque approche, consultez Comment fonctionne l'utilisation d'outils.

Pour la connexion aux serveurs MCP, consultez le connecteur MCP. Pour construire votre propre client MCP, consultez modelcontextprotocol.io.

L'accès aux outils est l'une des primitives les plus efficaces que vous pouvez donner à un agent. Sur des benchmarks comme LAB-Bench FigQA (interprétation de figures scientifiques) et SWE-bench (ingénierie logicielle du monde réel), l'ajout même d'outils basiques produit des gains de capacité disproportionnés, surpassant souvent les références d'experts humains.

Exemples d'utilisation d'outils

Pour une présentation pratique complète, consultez le tutoriel. Pour des exemples de référence de concepts individuels, consultez Définir des outils et Gérer les appels d'outils.

Tarification

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, we also automatically include 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.

Consultez le tableau de vue d'ensemble des modèles pour les prix actuels par modèle.

Lorsque vous envoyez une demande d'utilisation d'outils, tout comme toute autre demande d'API, la réponse affichera à la fois les comptages de jetons d'entrée et de sortie dans le cadre des métriques usage signalées.

Étapes suivantes

Choisissez votre chemin