Utilisation d'outils avec Claude

Claude est capable d'interagir avec des outils et des fonctions, ce qui vous permet d'étendre les capacités de Claude pour effectuer une plus grande variété de tâches.

Voici un exemple de la façon de fournir des outils à Claude en utilisant l'API Messages :

curl https://api.anthropic.com/v1/messages \
  -H "content-type: application/json" \
  -H "x-api-key: $ANTHROPIC_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -d '{
    "model": "claude-sonnet-4-5",
    "max_tokens": 1024,
    "tools": [
      {
        "name": "get_weather",
        "description": "Get the current weather in a given location",
        "input_schema": {
          "type": "object",
          "properties": {
            "location": {
              "type": "string",
              "description": "The city and state, e.g. San Francisco, CA"
            }
          },
          "required": ["location"]
        }
      }
    ],
    "messages": [
      {
        "role": "user",
        "content": "What is the weather like in San Francisco?"
      }
    ]
  }'

Fonctionnement de l'utilisation d'outils

Claude prend en charge deux types d'outils :

1. Outils clients : Outils qui s'exécutent sur vos systèmes, qui incluent :

   • Les outils personnalisés définis par l'utilisateur que vous créez et implémentez
   • Les outils définis par Anthropic comme l'utilisation d'ordinateur et l'éditeur de texte qui nécessitent une implémentation client

2. Outils serveur : Outils qui s'exécutent sur les serveurs d'Anthropic, comme les outils recherche web et récupération web. Ces outils doivent être spécifiés dans la demande API mais ne nécessitent pas d'implémentation de votre part.

Outils clients

Intégrez les outils clients avec Claude en suivant ces étapes :

Remarque : Les étapes 3 et 4 sont facultatives. Pour certains flux de travail, la demande d'utilisation d'outil de Claude (étape 2) pourrait être tout ce dont vous avez besoin, sans renvoyer les résultats à Claude.

Outils serveur

Les outils serveur suivent un flux de travail différent :

Utilisation des outils MCP avec Claude

Si vous construisez une application qui utilise le Model Context Protocol (MCP), vous pouvez utiliser les outils des serveurs MCP directement avec l'API Messages de Claude. Les définitions d'outils MCP utilisent un format de schéma similaire au format d'outil de Claude. Vous devez simplement renommer inputSchema en input_schema.

Conversion des outils MCP au format Claude

Lorsque vous construisez un client MCP et appelez list_tools() sur un serveur MCP, vous recevrez des définitions d'outils avec un champ inputSchema. Pour utiliser ces outils avec Claude, convertissez-les au format de Claude :

Ensuite, transmettez ces outils convertis à Claude :

Lorsque Claude répond avec un bloc tool_use, exécutez l'outil sur votre serveur MCP en utilisant call_tool() et retournez le résultat à Claude dans un bloc tool_result.

Pour un guide complet sur la construction de clients MCP, consultez Construire un client MCP.

Exemples d'utilisation d'outils

Voici quelques exemples de code démontrant divers modèles et techniques d'utilisation d'outils. Par souci de concision, les outils sont simples et les descriptions d'outils sont plus courtes que l'idéal pour assurer les meilleures performances.

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 notre tableau de comparaison des modèles pour les prix actuels par modèle.

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

Étapes suivantes

Explorez notre référentiel d'exemples de code d'utilisation d'outils prêts à mettre en œuvre dans nos livres de recettes :