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 dans le cadre de nos nouveaux cours ! 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 :
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 :
- Outils personnalisés définis par l’utilisateur que vous créez et implémentez
- Outils définis par Anthropic comme l’utilisation d’ordinateur et l’éditeur de texte qui nécessitent une implémentation côté 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 de modèles.
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, descriptions et 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 avec 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
detool_use
, signalant l’intention de Claude.
Exécuter l'outil et retourner les résultats
- Extraire le nom de l’outil et l’entrée de la demande de Claude
- Exécuter le code de l’outil sur votre système
- Retourner les résultats dans un nouveau message
user
contenant un bloc de contenutool_result
Claude utilise le résultat de l'outil pour formuler une réponse
- Claude analyse les résultats de l’outil pour créer sa réponse finale à l’invite utilisateur originale.
Note : Les étapes 3 et 4 sont optionnelles. 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 :
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 avec 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 créer 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 diverses techniques et modèles d’utilisation d’outils. Par souci de brièveté, les outils sont des outils simples, et les descriptions d’outils sont plus courtes que ce qui serait idéal pour assurer les meilleures performances.
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 responsestool_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.1 | auto , none any , tool | 346 tokens 313 tokens |
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) (deprecated) | auto , none any , tool | 346 tokens 313 tokens |
Claude Sonnet 3.5 (June) (deprecated) | auto , none any , tool | 294 tokens 261 tokens |
Claude Haiku 3.5 | auto , none any , tool | 264 tokens 340 tokens |
Claude Opus 3 (deprecated) | 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 comparaison des modèles pour les prix actuels par modèle.
Quand vous envoyez une invite d’utilisation d’outil, comme toute autre requête API, la réponse affichera les comptes de tokens d’entrée et de sortie dans le cadre des métriques d’usage
rapportées.
Prochaines étapes
Explorez notre dépôt d’exemples de code d’utilisation d’outils prêts à implémenter dans nos livres de recettes :
Outil Calculatrice
Apprenez comment intégrer un outil calculatrice simple 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
Voyez comment Claude et l’utilisation d’outils peuvent extraire des données structurées à partir de texte non structuré.