Tous les modules

Module 5 / 12

Outils intégrés

Comprendre les outils que Claude Code utilise pour explorer, modifier et exécuter du code.

Intermédiaire12 min de lecture

Les outils de base

Claude Code dispose d'un jeu d'outils natifs qu'il choisit d'invoquer selon la tâche :

OutilRôle
ReadLire le contenu d'un fichier (avec numéros de ligne)
EditRemplacer une chaîne précise dans un fichier existant
WriteCréer un nouveau fichier ou réécrire un fichier entier
GlobTrouver des fichiers par motif (**/*.test.ts)
GrepRechercher du texte/regex dans les fichiers (basé sur ripgrep)
BashExécuter des commandes shell (build, tests, git...)
WebFetch / WebSearchRécupérer une page web ou faire une recherche
Task / AgentDéléguer une sous-tâche à un agent spécialisé
TodoWrite / TaskCreateGérer une liste de tâches pour les travaux multi-étapes
ArtifactPublier 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 »