Les détails de l'API d'outil de Claude Code révélés

Structure de l'API d'outils de Claude Code

Un utilisateur de Reddit a documenté sa conversation avec Claude Code concernant son API d'outils interne. L'assistant IA a révélé des détails spécifiques sur la manière dont il interagit avec l'environnement.

Catégories et fonctions des outils

Outils du système de fichiers :

• Read — lit les fichiers par chemin absolu, retourne le contenu avec des numéros de ligne (style cat -n). Prend en charge les images, PDF, notebooks Jupyter.
• Write — écrase ou crée des fichiers. Doit d'abord Lire avant d'Écrire dans des fichiers existants.
• Edit — effectue un remplacement de chaîne chirurgical. Requiert que l'old_string soit unique dans le fichier, sinon l'opération échoue. Doit d'abord Lire.
• Glob — trouve des fichiers par motif (par exemple, *.py), triés par date de modification.
• Grep — recherche de contenu basée sur ripgrep. Prend en charge les expressions régulières, les filtres de type de fichier et les lignes de contexte.

Outils d'exécution :

• Bash — exécute des commandes shell avec un délai d'attente par défaut de 2 minutes (jusqu'à 10 minutes). Le répertoire de travail persiste entre les appels, mais l'état du shell ne se conserve pas (pas de variables d'environnement, alias, etc.). Possède une option run_in_background.

Outils web :

• WebFetch — récupère le contenu d'une URL.
• WebSearch — effectue une recherche sur le web.

Agents IA :

• Agent — génère des sous-agents (à usage général, Explore, Plan, etc.) avec leur propre accès aux outils et contexte. Peut s'exécuter en arrière-plan. Retourne un seul message une fois terminé.

Outils spéciaux :

• Skill — invoque des "compétences" nommées (commandes slash comme /commit) qui se développent en prompts complets.
• ToolSearch — récupère les schémas pour les "outils différés" (outils connus par nom mais qui ne peuvent être appelés que lorsque leur schéma est récupéré).

Détails clés de l'implémentation

Structure des appels d'outils : Claude Code n'utilise pas de jetons spéciaux pour déclencher les outils — il s'agit d'une API standard d'appel de fonction. La réponse inclut des blocs structurés d'appel d'outils, et les résultats reviennent sous forme de messages de résultat d'outil.

Format des appels d'outils : Les blocs utilisent une syntaxe de type XML avec un wrapper antml:function_calls contenant un ou plusieurs éléments antml:invoke avec le nom de l'outil comme attribut. Chaque paramètre est un élément antml:parameter avec un attribut name et la valeur comme contenu textuel.

Exemple de structure pour un appel Bash :

• Balise externe : antml:function_calls
• Balise interne : antml:invoke avec l'attribut name="Bash"
• Balise de paramètre : antml:parameter avec name="command" contenant le texte de la commande

Comportements opérationnels

• Interactions avec le linter : Lors de l'édition de fichiers, les hooks git ou les "hooks" configurés peuvent s'exécuter automatiquement après les appels d'outils et modifier davantage les fichiers. Le résultat de l'outil indique "le fichier a été modifié par un autre processus", nécessitant une relecture avant une nouvelle édition.
• Visibilité des appels d'outils : Chaque appel d'outil apparaît dans le terminal pour approbation par l'utilisateur (selon le mode de permission). Les utilisateurs peuvent refuser tout appel d'outil.
• Exécution parallèle : Plusieurs appels d'outils peuvent être émis dans une seule réponse et s'exécuter simultanément, utile pour lire plusieurs fichiers à la fois.
• Gestion du contexte : Les longues conversations sont automatiquement compressées — les messages antérieurs sont résumés pour libérer du contexte. La persistance de la mémoire se fait via une structure de répertoires : /home/tpreal/.claude/projects/...