Module 5 / 12
Outils intégrés
Comprendre les outils que Claude Code utilise pour explorer, modifier et exécuter du code.
Les outils de base
Claude Code dispose d'un jeu d'outils natifs qu'il choisit d'invoquer selon la tâche :
| Outil | Rôle |
|---|---|
| Read | Lire le contenu d'un fichier (avec numéros de ligne) |
| Edit | Remplacer une chaîne précise dans un fichier existant |
| Write | Créer un nouveau fichier ou réécrire un fichier entier |
| Glob | Trouver des fichiers par motif (**/*.test.ts) |
| Grep | Rechercher du texte/regex dans les fichiers (basé sur ripgrep) |
| Bash | Exécuter des commandes shell (build, tests, git...) |
| WebFetch / WebSearch | Récupérer une page web ou faire une recherche |
| Task / Agent | Déléguer une sous-tâche à un agent spécialisé |
| TodoWrite / TaskCreate | Gérer une liste de tâches pour les travaux multi-étapes |
| Artifact | Publier une page web (HTML/Markdown) consultable via une URL |
Pourquoi Edit plutôt que Write ?
Pour modifier un fichier existant, Claude Code privilégie Edit (remplacement ciblé d'une chaîne unique) plutôt que Write (réécriture complète). Cela limite le risque d'effacer du contenu non lié à la tâche et produit des diffs plus lisibles et plus faciles à relire pour vous.
Write reste l'outil approprié pour créer un nouveau fichier, ou dans les cas où une réécriture complète est réellement nécessaire.
Recherche : Glob et Grep
Glob répond à « quels fichiers correspondent à ce motif ? » (ex: tous les fichiers de test). Grep répond à « où apparaît ce symbole/texte dans le code ? ». Combinés, ils permettent à Claude Code d'explorer un repo inconnu sans avoir besoin d'un index préconstruit : il cherche, lit ce qui est pertinent, et ignore le reste : une approche qui s'adapte à des bases de code de toute taille.
Bash et la prudence sur les actions destructrices
L'outil Bash est le plus puissant et le plus sensible : il peut lancer des tests, mais aussi rm -rf, git push --force, ou modifier des ressources partagées. Claude Code applique une politique de prudence :
- Les commandes en lecture (tests, lint, git status/diff/log) sont généralement sûres.
- Les commandes destructrices ou difficiles à inverser (force-push, reset --hard, suppression de fichiers) doivent être confirmées explicitement, sauf autorisation explicite de l'utilisateur.
- Les hooks (voir module Hooks) peuvent intercepter et bloquer certaines commandes Bash avant exécution.
Artifacts : publier une page web depuis l'agent
L'outil Artifact transforme un fichier HTML ou Markdown en une page web hébergée, accessible par une URL, sans quitter la conversation. C'est l'outil adapté quand un résultat se lit mieux visuellement qu'en texte brut dans le terminal : tableau de bord, rapport structuré, maquette d'interface, diagramme.
Points clés à connaître :
- Une page publiée est privée par défaut : c'est vous qui décidez de la partager.
- Republier sur le même chemin de fichier met à jour la même URL ; un nouveau chemin crée une nouvelle page.
- Certaines pages peuvent recevoir des capacités d'exécution (données à jour, état partagé entre plusieurs personnes) au-delà du HTML statique, selon ce qui est disponible pour le compte utilisé.
- Avant de publier un fichier qu'on n'a pas soi-même écrit, il faut le lire en entier : publier revient à diffuser son contenu.
Outils différés : ToolSearch
Quand de nombreux serveurs MCP ou capacités additionnelles sont connectés, charger la définition complète de chaque outil dès le début de la session gaspillerait du contexte pour des outils qui ne serviront peut-être jamais. Claude Code peut donc lister certains outils uniquement par leur nom, sans leur schéma de paramètres : ce sont des outils différés.
L'outil ToolSearch permet de récupérer, à la demande, le schéma complet d'un ou plusieurs outils différés à partir d'une recherche par mot-clé ou par nom exact ; c'est ce schéma qui rend l'outil appelable. Bonne pratique : regrouper en une seule recherche tous les outils différés dont une tâche va avoir besoin, plutôt que d'enchaîner les recherches une par une.
Points clés à retenir
- Read/Edit/Write pour le code, Glob/Grep pour explorer, Bash pour exécuter.
- Edit (remplacement ciblé) est préféré à Write (réécriture complète) sur les fichiers existants.
- Glob trouve des fichiers par motif, Grep recherche du contenu : combinés, ils remplacent un index.
- Bash est l'outil le plus puissant : les actions destructrices doivent être confirmées.
- Artifact publie une page web (privée par défaut) à partir d'un fichier HTML/Markdown.
- Les outils différés n'exposent d'abord que leur nom ; ToolSearch charge leur schéma à la demande.
Tester ce module
15 questions corrigées sur « Outils intégrés »