Mon IA tourne en rond sur la même erreur : comment l’arrêter

Mis à jour le

Elle corrige. Ça ne marche pas. Elle corrige autrement. Ça ne marche toujours pas. Elle revient à la première solution. Tu la regardes tourner depuis vingt minutes, tu vois passer les mêmes fichiers, et tu n’oses pas l’interrompre au cas où le prochain essai serait le bon.

Une IA boucle quand la tâche n’a pas de condition d’arrêt. Elle essaie, échoue, et rien ne lui dit quand renoncer. Interromps-la, demande-lui d’expliquer pourquoi la première tentative a échoué avant d’en proposer une autre, et fixe une limite d’essais dans tes consignes. La boucle disparaît.

Pourquoi elle recommence indéfiniment

Une IA qui code ne sait pas qu’elle tourne en rond. Elle traite chaque tentative comme une nouvelle demande, sans compteur, sans mémoire de l’échec précédent, sans fatigue.

Le déclencheur est presque toujours le même : une demande sans condition d’arrêt. « Corrige ce bug » ne dit pas quand renoncer. Alors elle essaie une approche, constate que ça échoue, en essaie une autre, revient à la première sous une forme légèrement différente, et ainsi de suite. Chaque essai lui paraît neuf.

Le phénomène est assez connu pour que les outils s’en protègent : la documentation officielle décrit un mécanisme qui coupe automatiquement quand une opération se répète sans progresser, précisément pour ne pas gaspiller des appels sur une boucle qui n’avance pas.

Les trois phrases qui cassent la boucle

Interromps d’abord — la touche d’échappement ou Ctrl+C selon ton outil. Tu ne perds ni la conversation ni ton travail, seulement l’opération en cours.

Ensuite, dans l’ordre :

« Ne tente pas une autre solution. Explique-moi d’abord pourquoi la première a échoué. » C’est la plus importante. Elle force un diagnostic là où il n’y avait que des essais. Neuf fois sur dix, l’explication révèle que le problème n’est pas là où elle cherchait.

« Qu’est-ce que tu as déjà essayé, et qu’est-ce que ça a donné à chaque fois ? » Elle liste. Toi et elle voyez enfin le motif. Et souvent, elle réalise en écrivant qu’elle a testé deux fois la même chose.

« Reviens à l’état qui marchait avant tout ça. » Si les vingt minutes ont laissé des traces partout, repartir d’un état propre coûte moins cher que de démêler.

La cause que personne ne regarde

Quand une IA n’arrive pas à corriger quelque chose après plusieurs essais sincères, le problème est rarement celui qu’on lui a décrit.

Elle corrige ce que tu lui as montré. Si le symptôme visible vient d’ailleurs — un réglage qui ne s’applique qu’au redémarrage, un fichier qui n’est pas celui qui est réellement servi, une valeur écrite à deux endroits — elle peut réparer indéfiniment le mauvais endroit avec une conviction totale.

D’où la question qui débloque le plus de situations : « Es-tu sûre que le fichier que tu modifies est bien celui qui produit ce que je vois ? »

La consigne qui empêche le retour

Tout ce qui précède se règle après coup. La vraie économie, c’est de l’écrire une fois pour toutes dans le fichier de consignes que ton outil relit à chaque démarrage.

Deux règles y suffisent, et elles doivent obtenir deux choses précises.

La première interdit d’enchaîner les tentatives sans diagnostic. Formulée correctement, elle oblige l’IA à dire pourquoi la précédente a échoué avant d’en lancer une nouvelle. C’est ce passage obligé qui casse l’automatisme.

La seconde fixe une limite chiffrée. C’est celle qu’on oublie systématiquement, et c’est elle qui supprime la boucle. « Ne t’acharne pas » ne veut rien dire pour une machine ; un nombre d’essais, si.

Les dix règles d’or du kit gratuit contiennent ces deux-là, rédigées comme des ordres vérifiables et prêtes à coller dans ton fichier.

Ce que ça t’économise vraiment

Une boucle de vingt minutes ne coûte pas vingt minutes. Elle consomme ton abonnement, elle laisse des modifications éparpillées dans des fichiers que tu n’as pas suivis, et elle épuise la patience qui te servira au problème suivant.

Le pire reste l’effet sur la confiance : après trois boucles, on commence à croire que l’outil ne fonctionne pas. Alors qu’il faisait exactement ce qu’on lui avait demandé — continuer, sans qu’on lui ait jamais dit quand s’arrêter.

Même demande, deux réponses. Clique pour comparer.

> ajoute un formulaire de contact

Questions fréquentes

Est-ce que ça veut dire que l’outil est mauvais ?
Non. Une boucle est presque toujours le symptôme d’une demande sans limite : rien n’indique quand s’arrêter, alors elle continue. Les outils intègrent d’ailleurs des protections contre ça — la documentation officielle décrit un arrêt automatique quand une opération se répète sans progresser.
Combien de temps la laisser essayer avant d’intervenir ?
Deux tentatives sur le même problème. À la troisième, elle ne cherche plus, elle permute des variantes. C’est le moment d’interrompre, pas dix minutes plus tard.
Et si j’interromps au mauvais moment ?
Tu ne perds rien d’important. L’interruption arrête l’opération en cours, pas la conversation ni ton projet. Tu peux reprendre immédiatement en reformulant.

Sources

  1. Documentation Claude Code — dépannage et arrêt d’une opération — consultée le
  2. Dépôt officiel Claude Code — signalement de boucle répétitive — consultée le