Utilisation d'outils avec Claude

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

Apprenez tout ce dont vous avez besoin pour maîtriser l’utilisation d’outils avec Claude via notre nouveau cours complet sur l’utilisation d’outils ! Veuillez continuer à partager vos idées et suggestions en utilisant ce formulaire.

Voici un exemple de comment 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-opus-4-20250514",
    "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?"
      }
    ]
  }'

Comment fonctionne l’utilisation d’outils

Claude prend en charge deux types d’outils :

Outils client : Outils qui s’exécutent sur vos systèmes, qui incluent :
- Des outils personnalisés définis par l’utilisateur que vous créez et implémentez
- Des outils définis par Anthropic comme l’utilisation d’ordinateur (bêta) et l’éditeur de texte qui nécessitent une implémentation client
Outils serveur : Outils qui s’exécutent sur les serveurs d’Anthropic, comme l’outil de recherche web. Ces outils doivent être spécifiés dans la requête API mais ne nécessitent pas d’implémentation de votre part.

Les outils définis par Anthropic utilisent des types versionnés (par exemple, web_search_20250305, text_editor_20250124) pour assurer la compatibilité entre les versions du modèle.

Outils client

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

Fournir à Claude des outils et une invite utilisateur

Définissez les outils client avec des noms, des descriptions et des schémas d’entrée dans votre requête API.
Incluez une invite utilisateur qui pourrait nécessiter ces outils, par exemple, “Quel temps fait-il à San Francisco ?”

Claude décide d'utiliser un outil

Claude évalue si des outils peuvent aider à répondre à la requête de l’utilisateur.
Si oui, Claude construit une demande d’utilisation d’outil correctement formatée.
Pour les outils client, la réponse API a un stop_reason de tool_use, signalant l’intention de Claude.

Exécuter l'outil et renvoyer les résultats

Extrayez le nom de l’outil et l’entrée de la demande de Claude
Exécutez le code de l’outil sur votre système
Renvoyez les résultats dans un nouveau message user contenant un bloc de contenu tool_result

Claude utilise le résultat de l'outil pour formuler une réponse

Claude analyse les résultats de l’outil pour élaborer sa réponse finale à l’invite utilisateur originale.

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 de résultats à Claude.

Outils serveur

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

Fournir à Claude des outils et une invite utilisateur

Les outils serveur, comme la recherche web, ont leurs propres paramètres.
Incluez une invite utilisateur qui pourrait nécessiter ces outils, par exemple, “Recherchez les dernières nouvelles sur l’IA.”

Claude exécute l'outil serveur

Claude évalue si un outil serveur peut aider à répondre à la requête de l’utilisateur.
Si oui, Claude exécute l’outil, et les résultats sont automatiquement incorporés dans la réponse de Claude.

Claude utilise le résultat de l'outil serveur pour formuler une réponse

Claude analyse les résultats de l’outil serveur pour élaborer sa réponse finale à l’invite utilisateur originale.
Aucune interaction utilisateur supplémentaire n’est nécessaire pour l’exécution de l’outil serveur.

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 ce qui serait idéal pour assurer les meilleures performances.

Exemple d'outil unique

curl https://api.anthropic.com/v1/messages \
     --header "x-api-key: $ANTHROPIC_API_KEY" \
     --header "anthropic-version: 2023-06-01" \
     --header "content-type: application/json" \
     --data \
'{
    "model": "claude-opus-4-20250514",
    "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"
                },
                "unit": {
                    "type": "string",
                    "enum": ["celsius", "fahrenheit"],
                    "description": "The unit of temperature, either \"celsius\" or \"fahrenheit\""
                }
            },
            "required": ["location"]
        }
    }],
    "messages": [{"role": "user", "content": "What is the weather like in San Francisco?"}]
}'

Claude renverra une réponse similaire à :

JSON
{
  "id": "msg_01Aq9w938a90dw8q",
  "model": "claude-opus-4-20250514",
  "stop_reason": "tool_use",
  "role": "assistant",
  "content": [
    {
      "type": "text",
      "text": "<thinking>I need to call the get_weather function, and the user wants SF, which is likely San Francisco, CA.</thinking>"
    },
    {
      "type": "tool_use",
      "id": "toolu_01A09q90qw90lq917835lq9",
      "name": "get_weather",
      "input": {"location": "San Francisco, CA", "unit": "celsius"}
    }
  ]
}

Vous devriez ensuite exécuter la fonction get_weather avec l’entrée fournie, et renvoyer le résultat dans un nouveau message user :

curl https://api.anthropic.com/v1/messages \
     --header "x-api-key: $ANTHROPIC_API_KEY" \
     --header "anthropic-version: 2023-06-01" \
     --header "content-type: application/json" \
     --data \
'{
    "model": "claude-opus-4-20250514",
    "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"
                    },
                    "unit": {
                        "type": "string",
                        "enum": ["celsius", "fahrenheit"],
                        "description": "The unit of temperature, either \"celsius\" or \"fahrenheit\""
                    }
                },
                "required": ["location"]
            }
        }
    ],
    "messages": [
        {
            "role": "user",
            "content": "What is the weather like in San Francisco?"
        },
        {
            "role": "assistant",
            "content": [
                {
                    "type": "text",
                    "text": "<thinking>I need to use get_weather, and the user wants SF, which is likely San Francisco, CA.</thinking>"
                },
                {
                    "type": "tool_use",
                    "id": "toolu_01A09q90qw90lq917835lq9",
                    "name": "get_weather",
                    "input": {
                        "location": "San Francisco, CA",
                        "unit": "celsius"
                    }
                }
            ]
        },
        {
            "role": "user",
            "content": [
                {
                    "type": "tool_result",
                    "tool_use_id": "toolu_01A09q90qw90lq917835lq9",
                    "content": "15 degrees"
                }
            ]
        }
    ]
}'

Cela imprimera la réponse finale de Claude, incorporant les données météorologiques :

JSON
{
  "id": "msg_01Aq9w938a90dw8q",
  "model": "claude-opus-4-20250514",
  "stop_reason": "stop_sequence",
  "role": "assistant",
  "content": [
    {
      "type": "text",
      "text": "The current weather in San Francisco is 15 degrees Celsius (59 degrees Fahrenheit). It's a cool day in the city by the bay!"
    }
  ]
}

Exemple d'outils multiples

Vous pouvez fournir à Claude plusieurs outils parmi lesquels choisir dans une seule requête. Voici un exemple avec à la fois un outil get_weather et un outil get_time, ainsi qu’une requête utilisateur qui demande les deux.

curl https://api.anthropic.com/v1/messages \
     --header "x-api-key: $ANTHROPIC_API_KEY" \
     --header "anthropic-version: 2023-06-01" \
     --header "content-type: application/json" \
     --data \
'{
    "model": "claude-opus-4-20250514",
    "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"
                },
                "unit": {
                    "type": "string",
                    "enum": ["celsius", "fahrenheit"],
                    "description": "The unit of temperature, either 'celsius' or 'fahrenheit'"
                }
            },
            "required": ["location"]
        }
    },
    {
        "name": "get_time",
        "description": "Get the current time in a given time zone",
        "input_schema": {
            "type": "object",
            "properties": {
                "timezone": {
                    "type": "string",
                    "description": "The IANA time zone name, e.g. America/Los_Angeles"
                }
            },
            "required": ["timezone"]
        }
    }],
    "messages": [{
        "role": "user",
        "content": "What is the weather like right now in New York? Also what time is it there?"
    }]
}'

Dans ce cas, Claude essaiera très probablement d’utiliser deux outils séparés, un à la fois — get_weather puis get_time — afin de répondre complètement à la question de l’utilisateur. Cependant, il produira aussi occasionnellement deux blocs tool_use à la fois, particulièrement s’ils ne dépendent pas l’un de l’autre. Vous devriez exécuter chaque outil et renvoyer leurs résultats dans des blocs tool_result séparés au sein d’un seul message user.

Informations manquantes

Si l’invite de l’utilisateur ne contient pas suffisamment d’informations pour remplir tous les paramètres requis pour un outil, Claude Opus est beaucoup plus susceptible de reconnaître qu’un paramètre est manquant et de le demander. Claude Sonnet peut poser la question, surtout lorsqu’il est invité à réfléchir avant de produire une demande d’outil. Mais il peut aussi faire de son mieux pour déduire une valeur raisonnable.

Par exemple, en utilisant l’outil get_weather ci-dessus, si vous demandez à Claude “Quel temps fait-il ?” sans préciser un lieu, Claude, particulièrement Claude Sonnet, peut faire une supposition sur les entrées d’outils :

JSON
{
  "type": "tool_use",
  "id": "toolu_01A09q90qw90lq917835lq9",
  "name": "get_weather",
  "input": {"location": "New York, NY", "unit": "fahrenheit"}
}

Ce comportement n’est pas garanti, surtout pour des invites plus ambiguës et pour des modèles moins intelligents. Si Claude Opus n’a pas assez de contexte pour remplir les paramètres requis, il est beaucoup plus susceptible de répondre avec une question de clarification au lieu de faire un appel d’outil.

Outils séquentiels

Certaines tâches peuvent nécessiter d’appeler plusieurs outils en séquence, en utilisant la sortie d’un outil comme entrée pour un autre. Dans un tel cas, Claude appellera un outil à la fois. S’il est invité à appeler tous les outils en même temps, Claude est susceptible de deviner les paramètres pour les outils en aval s’ils dépendent des résultats d’outils en amont.

Voici un exemple d’utilisation d’un outil get_location pour obtenir l’emplacement de l’utilisateur, puis de transmission de cet emplacement à l’outil get_weather :

curl https://api.anthropic.com/v1/messages \
     --header "x-api-key: $ANTHROPIC_API_KEY" \
     --header "anthropic-version: 2023-06-01" \
     --header "content-type: application/json" \
     --data \
'{
    "model": "claude-opus-4-20250514",
    "max_tokens": 1024,
    "tools": [
        {
            "name": "get_location",
            "description": "Get the current user location based on their IP address. This tool has no parameters or arguments.",
            "input_schema": {
                "type": "object",
                "properties": {}
            }
        },
        {
            "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"
                    },
                    "unit": {
                        "type": "string",
                        "enum": ["celsius", "fahrenheit"],
                        "description": "The unit of temperature, either 'celsius' or 'fahrenheit'"
                    }
                },
                "required": ["location"]
            }
        }
    ],
    "messages": [{
        "role": "user",
        "content": "What is the weather like where I am?"
    }]
}'

Dans ce cas, Claude appellerait d’abord l’outil get_location pour obtenir l’emplacement de l’utilisateur. Après que vous ayez renvoyé l’emplacement dans un tool_result, Claude appellerait ensuite get_weather avec cet emplacement pour obtenir la réponse finale.

La conversation complète pourrait ressembler à :

Rôle	Contenu
Utilisateur	Quel temps fait-il là où je suis ?
Assistant	<thinking>Pour répondre à cela, je dois d’abord déterminer l’emplacement de l’utilisateur en utilisant l’outil get_location. Ensuite, je peux transmettre cet emplacement à l’outil get_weather pour trouver la météo actuelle à cet endroit.</thinking>[Utilisation d’outil pour get_location]
Utilisateur	[Résultat d’outil pour get_location avec id correspondant et résultat de San Francisco, CA]
Assistant	[Utilisation d’outil pour get_weather avec l’entrée suivante]{ “location”: “San Francisco, CA”, “unit”: “fahrenheit” }
Utilisateur	[Résultat d’outil pour get_weather avec id correspondant et résultat de “59°F (15°C), mostly cloudy”]
Assistant	D’après votre emplacement actuel à San Francisco, CA, le temps est actuellement de 59°F (15°C) et principalement nuageux. C’est une journée assez fraîche et couverte dans la ville. Vous voudrez peut-être emporter une veste légère si vous sortez.

Cet exemple démontre comment Claude peut enchaîner plusieurs appels d’outils pour répondre à une question qui nécessite de recueillir des données de différentes sources. Les étapes clés sont :

Claude réalise d’abord qu’il a besoin de l’emplacement de l’utilisateur pour répondre à la question sur la météo, il appelle donc l’outil get_location.
L’utilisateur (c’est-à-dire le code client) exécute la fonction get_location réelle et renvoie le résultat “San Francisco, CA” dans un bloc tool_result.
Avec l’emplacement maintenant connu, Claude procède à l’appel de l’outil get_weather, en passant “San Francisco, CA” comme paramètre location (ainsi qu’un paramètre unit deviné, car unit n’est pas un paramètre requis).
L’utilisateur exécute à nouveau la fonction get_weather réelle avec les arguments fournis et renvoie les données météorologiques dans un autre bloc tool_result.
Enfin, Claude incorpore les données météorologiques dans une réponse en langage naturel à la question originale.

Utilisation d'outils avec chaîne de pensée

Mode JSON

Vous pouvez utiliser des outils pour faire produire à Claude une sortie JSON qui suit un schéma, même si vous n’avez pas l’intention d’exécuter cette sortie via un outil ou une fonction.

Lorsque vous utilisez des outils de cette façon :

Vous voulez généralement fournir un seul outil
Vous devriez définir tool_choice (voir Forcer l’utilisation d’outils) pour indiquer au modèle d’utiliser explicitement cet outil
N’oubliez pas que le modèle passera l’input à l’outil, donc le nom de l’outil et la description doivent être du point de vue du modèle.

L’exemple suivant utilise un outil record_summary pour décrire une image selon un format particulier.

#!/bin/bash
IMAGE_URL="https://upload.wikimedia.org/wikipedia/commons/a/a7/Camponotus_flavomarginatus_ant.jpg"
IMAGE_MEDIA_TYPE="image/jpeg"
IMAGE_BASE64=$(curl "$IMAGE_URL" | base64)

curl https://api.anthropic.com/v1/messages \
     --header "content-type: application/json" \
     --header "x-api-key: $ANTHROPIC_API_KEY" \
     --header "anthropic-version: 2023-06-01" \
     --data \
'{
    "model": "claude-opus-4-20250514",
    "max_tokens": 1024,
    "tools": [{
        "name": "record_summary",
        "description": "Record summary of an image using well-structured JSON.",
        "input_schema": {
            "type": "object",
            "properties": {
                "key_colors": {
                    "type": "array",
                    "items": {
                        "type": "object",
                        "properties": {
"r": { "type": "number", "description": "red value [0.0, 1.0]" },
"g": { "type": "number", "description": "green value [0.0, 1.0]" },
"b": { "type": "number", "description": "blue value [0.0, 1.0]" },
"name": { "type": "string", "description": "Human-readable color name in snake_case, e.g. \"olive_green\" or \"turquoise\"" }
                        },
                        "required": [ "r", "g", "b", "name" ]
                    },
                    "description": "Key colors in the image. Limit to less than four."
                },
                "description": {
                    "type": "string",
                    "description": "Image description. One to two sentences max."
                },
                "estimated_year": {
                    "type": "integer",
                    "description": "Estimated year that the image was taken, if it is a photo. Only set this if the image appears to be non-fictional. Rough estimates are okay!"
                }
            },
            "required": [ "key_colors", "description" ]
        }
    }],
    "tool_choice": {"type": "tool", "name": "record_summary"},
    "messages": [
        {"role": "user", "content": [
            {"type": "image", "source": {
                "type": "base64",
                "media_type": "'$IMAGE_MEDIA_TYPE'",
                "data": "'$IMAGE_BASE64'"
            }},
            {"type": "text", "text": "Describe this image."}
        ]}
    ]
}'

Tarification

Tool use requests are priced based on:

The total number of input tokens sent to the model (including in the tools parameter)
The number of output tokens generated
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.

Model	Tool choice	Tool use system prompt token count
Claude Opus 4	`auto`, `none` `any`, `tool`	346 tokens 313 tokens
Claude Sonnet 4	`auto`, `none` `any`, `tool`	346 tokens 313 tokens
Claude Sonnet 3.7	`auto`, `none` `any`, `tool`	346 tokens 313 tokens
Claude Sonnet 3.5 (Oct)	`auto`, `none` `any`, `tool`	346 tokens 313 tokens
Claude Sonnet 3.5 (June)	`auto`, `none` `any`, `tool`	294 tokens 261 tokens
Claude Haiku 3.5	`auto`, `none` `any`, `tool`	264 tokens 340 tokens
Claude Opus 3	`auto`, `none` `any`, `tool`	530 tokens 281 tokens
Claude Sonnet 3	`auto`, `none` `any`, `tool`	159 tokens 235 tokens
Claude Haiku 3	`auto`, `none` `any`, `tool`	264 tokens 340 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 présentation des modèles pour les prix actuels par modèle.

Lorsque vous envoyez une invite d’utilisation d’outil, comme pour toute autre requête API, la réponse affichera à la fois les nombres de jetons d’entrée et de sortie dans le cadre des métriques usage rapportées.

Prochaines étapes

Explorez notre répertoire d’exemples de code d’utilisation d’outils prêts à être implémentés dans nos cookbooks :

Outil Calculatrice

Apprenez à intégrer un simple outil de calculatrice avec Claude pour des calculs numériques précis.

Agent de service client

Construisez un bot de service client réactif qui exploite les outils client pour améliorer le support.

Extracteur JSON

Découvrez comment Claude et l’utilisation d’outils peuvent extraire des données structurées à partir de texte non structuré.

Premiers pas

Modèles et tarifs

Explorer les fonctionnalités

En savoir plus sur Claude

Centre juridique

Tester et évaluer

Composants d'agent

Utilisation d'outils avec Claude

Comment fonctionne l’utilisation d’outils

Outils client

Outils serveur

Exemples d’utilisation d’outils

Tarification

Prochaines étapes

Outil Calculatrice

Agent de service client

Extracteur JSON

Premiers pas

Modèles et tarifs

Explorer les fonctionnalités

En savoir plus sur Claude

Centre juridique

Tester et évaluer

Composants d'agent

​Comment fonctionne l’utilisation d’outils

​Outils client

​Outils serveur

​Exemples d’utilisation d’outils

​Tarification

​Prochaines étapes

Outil Calculatrice

Agent de service client

Extracteur JSON

Comment fonctionne l’utilisation d’outils

Outils client

Outils serveur

Exemples d’utilisation d’outils

Tarification

Prochaines étapes