Chapitre 1 · Comprendre ce qu'est un agent
La boucle de travail : il lit, il propose, il agit, il vérifie
Suis cette formation dans ton espace : ta progression est gardée, et la communauté répond à tes questions.
Suivre gratuitementLa boucle de l'agent
Le pourquoi
Quand tu donnes une tâche à Claude Code, il ne produit pas une réponse unique. La documentation décrit une boucle en trois phases : rassembler le contexte (lire, chercher), agir (modifier, lancer une commande), vérifier le résultat. Il recommence jusqu'à ce que la tâche soit finie. Ces phases se mélangent : il peut lire un fichier, en modifier un autre, relancer une vérification, relire.
Dans cette formation, on ajoute une étape à ta portée : proposer. Avec le mode plan ou les demandes de permission (chapitre 2), il te montre ce qu'il compte faire avant de le faire. La boucle devient : il lit, il propose, il agit, il vérifie.
Prends une boulangère qui veut mettre à jour les horaires d'été sur son site. Claude Code va :
- chercher les fichiers qui contiennent les horaires (il lit) ;
- lui dire « les horaires apparaissent dans 3 pages, voici ce que je change » (il propose) ;
- modifier les trois pages (il agit) ;
- rechercher les anciens horaires pour vérifier qu'il n'en reste aucun (il vérifie).
Tu fais partie de la boucle
La documentation le dit clairement : tu peux intervenir à tout moment pour le réorienter, ajouter une information ou lui demander une autre approche. Deux façons :
- Appuie sur Échap (
Esc) : il s'arrête tout de suite, garde ce qui a été fait et attend ta consigne. - Écris une correction et appuie sur Entrée sans l'arrêter : ton message est mis en file d'attente, et il en tient compte avant sa prochaine étape.
Le comment : donne-lui un moyen de vérifier
La phase « vérifier » est celle qui fait la différence. La documentation des bonnes pratiques l'explique : Claude s'arrête quand le travail semble fini. S'il n'a rien pour savoir s'il est fini, c'est toi qui deviens le contrôle qualité.
Donne-lui donc une vérification dont il peut lire le résultat. Pour un débutant, ça peut être :
- une capture d'écran de ce que tu attends, à comparer avec le résultat ;
- une recherche (« vérifie qu'il ne reste aucune trace de l'ancien prix ») ;
- un aperçu du site à ouvrir et à regarder en largeur téléphone ;
- une liste de critères écrite à l'avance.
Et demande toujours une preuve : la commande qu'il a lancée et son résultat, ou la capture. « C'est fait » tout seul ne te dit presque rien.
Exemple à copier
Contexte : mon site est dans ce dossier. Mes horaires changent pour l'été : [nouveaux horaires].
Objectif : remplacer les anciens horaires partout où ils apparaissent.
Contraintes : ne touche à rien d'autre que les horaires.
Format attendu : d'abord la liste des fichiers et des lignes concernées, avant toute modification.
Validation : attends mon accord. Après la modification, recherche les anciens horaires dans tout le dossier et montre-moi le résultat de cette recherche comme preuve qu'il n'en reste aucun.
Ce que la boucle ne fait pas toute seule
- Elle ne devine pas ce que « réussi » veut dire pour toi. Si tu ne le dis pas, il choisit.
- Elle ne vérifie pas ce qu'elle ne peut pas voir : l'avis d'un client, le rendu dans un logiciel qu'il n'a pas ouvert.
- Elle peut tourner longtemps sur une mauvaise piste. Regarde la première minute : s'il part ailleurs,
Esc.
Les erreurs à éviter
- Laisser travailler sans regarder. La documentation conseille de surveiller la première minute et d'arrêter dès qu'il dérive.
- Accepter « tout est bon » sans preuve. Demande la sortie de la commande ou la capture.
- Corriger dix fois le même point. Après deux corrections ratées, mieux vaut repartir proprement (leçon 6).
À toi de jouer
Choisis une petite modification réelle de ton projet : un numéro de téléphone, un prix, une adresse. Adapte le prompt ci-dessus. Pendant qu'il travaille, repère à l'écran les quatre moments : quand il lit, quand il propose, quand il agit, quand il vérifie. Si la phase « vérifier » n'apparaît pas, c'est que ta demande ne la prévoyait pas : ajoute-la et recommence.