Accueil / Fondamentaux et boucle d'agent

Claude Code et la boucle de l'agent

Claude Code enchaîne réflexion, appel d'outil réel et lecture du résultat en boucle jusqu'à l'objectif, il ne répond pas une seule fois comme un chat.

Claude Code ne renvoie pas une réponse unique avant d'attendre une nouvelle question. Face à un objectif, il réfléchit à l'action à mener, appelle un outil réel, lecture d'un fichier, exécution d'une commande, modification de code, puis observe ce que cet outil a produit avant de décider la suite. Cette boucle recommence autant de fois que nécessaire, jusqu'à ce que l'objectif soit atteint ou que la main soit rendue à l'utilisateur.

Ce que change la boucle par rapport à un chat

Un assistant de conversation classique produit une réponse et s'arrête là. Claude Code, lui, exécute réellement les commandes qu'il propose, lit ce qu'elles renvoient sur la sortie standard et sur l'erreur standard, et ajuste son plan en fonction de ce résultat. Donner un objectif complet, plutôt qu'une suite d'instructions découpées pas à pas, laisse cette boucle déployer elle même ses étapes intermédiaires. Une demande formulée comme corrige le test qui échoue dans calc.test.js déclenche une séquence que personne n'a besoin de détailler à l'avance : lecture du fichier de test, exécution de la suite, lecture du message d'erreur, correction, nouvelle exécution.

Objectif reçu : corriger le test qui échoue dans calc.test.js

Réflexion : lire le fichier de test pour comprendre l'échec
Outil : lecture de calc.test.js
Observation : le test attend 4, la fonction renvoie 5

Réflexion : lire la fonction concernée
Outil : lecture de calc.js
Observation : une addition remplace une soustraction

Réflexion : corriger la ligne fautive
Outil : modification de calc.js
Observation : fichier modifié

Réflexion : vérifier que le test passe désormais
Outil : exécution de la suite de tests
Observation : boucle terminée, la main est rendue

Interrompre sans perdre la boucle

La boucle tourne visiblement dans le terminal : chaque réflexion, chaque outil appelé et chaque observation s'affichent au fil de l'eau, pas seulement le résultat final. Cela permet de suivre une tâche longue sans devoir la relancer pour savoir où elle en est, et de l'interrompre en cours de route si la direction prise ne convient pas, en gardant ce qui a déjà été accompli.

Ce qui alimente chaque tour de boucle

Chaque réflexion s'appuie sur ce que la session sait déjà du projet. Une partie de cette connaissance vient d'un fichier lu automatiquement au début de la session, CLAUDE.md, abordé dans la leçon suivante, qui fixe des règles avant même le premier tour de boucle. Sans objectif complet ni contexte de départ, la boucle tourne quand même, mais elle passe alors plus de tours à découvrir des informations qu'un fichier de mémoire aurait déjà portées.