Chapter 1 · Comprendre ce qu'est un agent
Chat ou agent : la vraie différence
Follow this course in your space: your progress is saved, and the community answers your questions.
Follow for freeUne IA qui répond, une IA qui agit
Le pourquoi
Une IA de chat, comme la conversation sur claude.ai, reçoit ton texte et renvoie du texte. Elle ne voit que ce que tu lui colles. Elle ne peut pas ouvrir ton fichier, ni vérifier si sa réponse marche.
Claude Code est ce que la documentation officielle appelle un outil « agentique » (capable d'agir par lui-même pour atteindre un objectif). Il lit ton projet, modifie des fichiers, lance des commandes et s'intègre à tes outils. La documentation résume l'idée ainsi : sans outils, Claude peut seulement répondre avec du texte ; avec des outils, il peut agir.
Prends une photographe qui veut renommer 200 photos d'un mariage selon la date et le nom des mariés. Le chat lui expliquera comment faire, étape par étape, et c'est elle qui fera le travail. Claude Code, lancé dans le dossier des photos, peut lister les fichiers, lui proposer le nouveau nom de chacun, puis faire le renommage après son accord.
Le comment : les outils d'un agent
Un outil, c'est une action précise que Claude Code sait faire. La documentation les range en cinq familles :
- Les opérations sur les fichiers : lire, modifier, créer, renommer, réorganiser.
- La recherche : trouver des fichiers par leur nom, chercher un mot ou un motif dans leur contenu.
- L'exécution : lancer des commandes dans le terminal, démarrer un aperçu, lancer des tests, utiliser Git (l'outil qui garde l'historique de ton projet).
- Le web : chercher sur internet, lire une documentation, comprendre un message d'erreur.
- L'intelligence du code : repérer des erreurs après une modification (cette famille demande des extensions, appelées plugins).
Il a aussi des outils pour te poser une question ou confier une partie du travail à un sous-agent (leçon 8).
Chaque fois qu'il utilise un outil, il reçoit un résultat (le contenu d'un fichier, la sortie d'une commande). Ce résultat l'aide à décider de l'étape suivante. C'est ce qui le rend autonome.
Ce qu'il peut voir
Quand tu tapes claude dans un dossier, il a accès, d'après la documentation :
- aux fichiers de ce dossier et de ses sous-dossiers (ailleurs, seulement avec ta permission) ;
- à ton terminal, donc à toute commande que tu pourrais lancer toi-même ;
- à l'état de Git si ton dossier en utilise ;
- à ton fichier CLAUDE.md et à sa mémoire automatique (chapitre 3) ;
- aux extensions que tu as installées : skills, connecteurs, sous-agents.
C'est pour ça qu'on dit « un dossier par projet ». Le dossier où tu le lances, c'est son terrain de travail.
Où on le trouve
La documentation cite plusieurs façons de l'utiliser : le terminal, l'application de bureau (onglet Code), les extensions pour VS Code et JetBrains (des logiciels d'édition de code), et le web sur claude.ai/code. Le moteur est le même partout, et ton CLAUDE.md, tes réglages et tes connecteurs suivent.
Ce qui ne change pas
Agent ou pas, Claude ne connaît ni ton public, ni ton ton, ni tes limites tant que tu ne les as pas écrits. Il agit, mais c'est toi qui décides. Chez GoVincia, c'est la règle de tout le circuit des carrousels : l'IA prépare, l'humain valide, et rien n'est publié sans accord.
Exemple à copier
Ce prompt te montre l'agent au travail, sans risque : il lit et cherche, mais ne modifie rien.
Contexte : ce dossier contient mon projet [nom du projet].
Objectif : voir comment tu travailles quand tu explores un dossier.
Contraintes : ne modifie et ne crée aucun fichier. Ne lance aucune commande qui change quelque chose.
Format attendu : la liste des actions que tu as faites (lecture, recherche), dans l'ordre, puis ce que tu as compris du projet en 5 lignes.
Validation : termine par ce que tu ne peux pas savoir sans moi.
Les erreurs à éviter
- Utiliser Claude Code comme un chat. Lui coller le contenu d'un fichier qu'il peut lire lui-même, c'est perdre son principal avantage. Pointe plutôt le fichier avec
@suivi de son nom, par exemple@index.html. - Oublier qu'il agit pour de vrai. Un fichier modifié est vraiment modifié sur ton ordinateur.
- Lui demander ce qu'il ne peut pas voir. Ton chiffre d'affaires, tes avis clients, ton ton de marque : s'ils ne sont écrits nulle part, il va deviner.
À toi de jouer
Lance le prompt ci-dessus dans ton dossier de projet. Pendant qu'il travaille, observe les lignes qui s'affichent : chacune correspond à un outil (lecture d'un fichier, recherche). Compte combien d'actions il a faites avant de te répondre. Ensuite, pose la même question sur claude.ai, sans rien coller. Compare les deux réponses : tu viens de voir la différence entre un chat et un agent.