Claude Code charge paresseusement les schémas d'outils via ToolSearch pour économiser des tokens

Une analyse Reddit du prompt système de Claude Code révèle que les outils sont chargés paresseusement pour réduire la consommation de tokens. Au lieu d'envoyer le schéma complet de chaque outil à chaque requête, Claude Code envoie une liste de noms d'outils dans une balise <system-reminder> et ordonne au modèle d'appeler d'abord ToolSearch pour charger le schéma de chaque outil.

Comment ça marche

Le prompt système inclut une instruction comme celle-ci :

<system-reminder>
Les outils différés suivants sont désormais disponibles via ToolSearch. Leurs schémas ne sont PAS chargés — les appeler directement échouera avec une InputValidationError. Utilisez ToolSearch avec la requête "select:<nom>[,<nom>...]" pour charger les schémas d'outils avant de les appeler :

AskUserQuestion CronCreate CronDelete CronList EnterPlanMode EnterWorktree ExitPlanMode ExitWorktree Monitor NotebookEdit PushNotification RemoteTrigger TaskOutput TaskStop TodoWrite WebFetch WebSearch
[+ ~130 outils MCP (Slack, Notion, Gmail...)]
</system-reminder>

La balise <system-reminder> n'est injectée que dans le premier message utilisateur de la conversation. Un bloc similaire liste les compétences avec des descriptions d'une ligne.

Impact sur les tokens

Selon le post, les instructions système plus les rappels consommaient à eux seuls 38k tokens sur un simple message test "hi". Charger le schéma complet de chaque outil dès le départ augmenterait considérablement cette consommation — d'où l'approche de chargement paresseux.

Implications pratiques

Si vous construisez sur Claude Code ou des systèmes agents similaires, ce motif mérite d'être adopté :

• Différez les schémas des outils rarement utilisés jusqu'à ce qu'ils soient nécessaires.
• Utilisez une commande de type ToolSearch pour demander explicitement les schémas.
• Gardez les rappels dans le premier message pour éviter de répéter le contexte.

Cela signifie aussi que si vous écrivez des outils personnalisés pour Claude Code, vous devez vous assurer que le modèle peut les découvrir via ToolSearch — sinon ils seront invisibles ou provoqueront des erreurs de validation.