Définition d'outil
Une définition d'outil décrit au modèle le nom, l'usage et le schéma des entrées d'un outil, comptés en tokens d'entrée lorsqu'un client l'inclut dans une requête.
Un modèle ne peut appeler un outil dont il ignore l'existence. Chaque outil disponible doit donc être décrit dans la requête. Dans l'API Claude, c'est une entrée du paramètre tools avec un name, une description en langage courant et un input_schema en JSON Schema. Le modèle choisit d'appeler l'outil à partir de la demande et de cette description.
Tout cela est facturé comme entrée. La tarification d'Anthropic compte les noms, descriptions et schémas des outils en tokens d'entrée. Dès qu'un outil est présent, l'API ajoute également un prompt système consacré aux outils : 286 tokens sur Claude Opus 5.5 en septembre 2026. Les outils définis par Anthropic ont leurs propres descriptions, et les appels puis résultats s'ajoutent à la facture.
Dans un agent, outils intégrés, serveurs MCP et plugins peuvent tous apporter des définitions. Leur coût en contexte dépend du client : certains incluent les schémas détaillés d'emblée, d'autres les diffèrent. En septembre 2026, Claude Code diffère les définitions d'outils MCP par défaut et Codex peut différer les outils MCP découvrables avec la recherche d'outils.
Les définitions occupent aussi le début du préfixe mis en cache. Anthropic le traite dans l'ordre outils, prompt système, messages. Ajouter, retirer ou modifier un outil entre deux requêtes invalide donc tout ce qui suivait dans le cache. La requête suivante doit retraiter le contexte entier.