Utilisation d'outils avec Claude

L'utilisation d'outils permet à Claude d'appeler des fonctions que vous définissez ou qu'Anthropic fournit. Claude détermine quand appeler un outil en fonction de la requête de l'utilisateur et de la description de l'outil. Il renvoie ensuite un appel structuré que votre application exécute (outils client) ou qu'Anthropic exécute (outils serveur).

Voici un exemple minimal utilisant un outil serveur, l'outil de recherche web, qu'Anthropic exécute pour vous :

client = anthropic.Anthropic()
response = client.messages.create(
    model="claude-opus-4-8",
    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)

Claude exécute la recherche sur l'infrastructure d'Anthropic et renvoie les résultats cités dans la même réponse. Pour que Claude appelle une fonction que vous définissez, passez un outil avec un input_schema, puis exécutez l'appel lorsque Claude renvoie un bloc tool_use. Les pages Définir des outils et Gérer les appels d'outils couvrent cet aller-retour.



Fonctionnement de l'utilisation d'outils

Les outils diffèrent principalement par l'endroit où le code s'exécute. Les outils client (y compris les outils définis par l'utilisateur et les outils avec des schémas définis par Anthropic, tels que 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 renvoie un tool_result. Les outils serveur (tels que web_search, web_fetch, code_execution et tool_search) s'exécutent sur l'infrastructure d'Anthropic : vous voyez les résultats directement sans gérer l'exécution, sauf si Claude appelle l'outil dans le même groupe d'appels d'outils parallèles que l'un de vos outils client (voir Raisons d'arrêt et solution de repli).

Pour le modèle conceptuel complet, y compris la boucle agentique et quand choisir chaque approche, consultez Fonctionnement de l'utilisation d'outils.

Pour vous connecter à des serveurs Model Context Protocol (MCP), consultez le connecteur MCP. Pour créer votre propre client MCP, consultez le guide Model Context Protocol sur la création d'un client MCP.



Quand Claude utilise des outils

Avec le tool_choice par défaut de {"type": "auto"}, Claude détermine à chaque tour s'il doit appeler un outil ou répondre directement. Il appelle un outil lorsque la requête correspond à la capacité décrite de cet outil et que la réponse n'est pas déjà dans le contexte. Il répond directement pour les connaissances stables, les tâches créatives et les tours conversationnels.

Cette limite est orientable via votre invite système. Si Claude n'appelle pas d'outils alors que vous vous y attendez, une instruction légère telle que "Use the tools to investigate before responding." augmente l'utilisation d'outils. Une forme plus forte telle que "Always call a tool first before responding." pousse encore plus loin. À l'inverse, "Use your judgment about whether to call a tool or respond directly." maintient un comportement de déclenchement conservateur.

Pour exiger un appel d'outil plutôt que de vous fier au prompt, définissez tool_choice.

La page de chaque outil serveur décrit plus en détail sa propre limite de déclenchement.



Choisir un outil

Pour les chaînes type, les versions et les en-têtes bêta, consultez la Référence des outils.



Vos propres outils

Pour les outils que vous définissez, vous écrivez le schéma et votre application exécute chaque appel.



Outils client avec schéma Anthropic

Anthropic publie le schéma et entraîne Claude dessus. Votre application exécute toujours chaque appel et renvoie le tool_result.



Outils serveur

Les outils serveur s'exécutent sur l'infrastructure d'Anthropic, sans code de gestionnaire dans votre application. Consultez Outils serveur pour les mécanismes qu'ils partagent.



Tarification

Les requêtes d'utilisation d'outils sont facturées en fonction de :

1. Le nombre total de tokens d'entrée envoyés au modèle (y compris dans le paramètre tools)
2. Le nombre de tokens de sortie générés
3. Pour les outils côté serveur, une tarification supplémentaire basée sur l'utilisation (par exemple, la recherche web est facturée par recherche effectuée)

Les outils côté client sont facturés de la même manière que toute autre requête à l'API Claude, tandis que les outils côté serveur peuvent entraîner des frais supplémentaires en fonction de leur utilisation spécifique.

Les tokens supplémentaires liés à l'utilisation d'outils proviennent de :

• Le paramètre tools dans les requêtes API (noms, descriptions et schémas des outils)
• Les blocs de contenu tool_use dans les requêtes et réponses API
• Les blocs de contenu tool_result dans les requêtes API

Lorsque vous utilisez tools, l'API inclut également automatiquement une invite système spéciale pour le modèle qui active l'utilisation d'outils. Le nombre de tokens d'utilisation d'outils requis pour chaque modèle est indiqué ci-dessous (à l'exclusion des tokens supplémentaires mentionnés ci-dessus). Notez que le tableau suppose qu'au moins 1 outil est fourni. Si aucun tools n'est fourni, alors un choix d'outil de none utilise 0 token d'invite système supplémentaire.

Ces nombres de tokens sont ajoutés à vos tokens d'entrée et de sortie habituels pour calculer le coût total d'une requête.

Consultez le tableau Aperçu des modèles pour les prix actuels par modèle.

Lorsque vous envoyez un prompt d'utilisation d'outils, comme toute autre requête API, la réponse inclut à la fois le nombre de tokens d'entrée et de sortie dans les métriques usage rapportées.

Certains outils serveur ajoutent des frais basés sur l'utilisation en plus des tokens : consultez Outil de recherche web et Outil d'exécution de code pour leurs tarifs.



Prochaines étapes