Quand ça déraille
- 01Boucles, contexte pollué et redémarrage10 min
Le signal d'une boucle est la répétition du même message d'échec, un contexte saturé se traite par une compaction ciblée ou par un effacement complet, et repartir avec un résumé écrit à la main des décisions déjà prises vaut mieux que d'insister dans une conversation dégradée.
- 02Annuler et récupérer une modification9 min
Pour annuler la dernière action de Claude Code dans la session en cours, le menu de points de reprise ouvert par /rewind précède désormais Git, qui reste nécessaire pour tout ce que ce système ne suit pas : une modification faite par une commande bash, l'édition d'un sous-agent en arrière-plan, ou un fichier lié par un lien symbolique ou physique.
- 03Erreurs d'API et limite de débit9 min
Un appel à l'API échoue de plusieurs façons différentes : une erreur 400 ou 404 signale le plus souvent une requête mal formée qui doit être corrigée avant tout nouvel essai, sauf le cas particulier d'un 400 renvoyé pour un plafond de dépense atteint, tandis qu'une erreur 429 ne se résout en attendant que si elle porte un en-tête Retry-After, ce qui n'est pas le cas d'un plafond de dépense atteint.
- 04Une commande bloquée7 min
Une commande shell qui ne répond plus se coupe par Ctrl+C sans quitter la session, et le délai qui la fait basculer en tâche de fond est déjà fixé par Claude lui même, pas par un préfixe que vous ajoutez à la main.
- 05Plusieurs sessions meurent ensemble, soupçonnez la machine9 min
Quand plusieurs sessions meurent au même instant sans aucune trace dans leurs propres journaux, la cause probable est le système d'exploitation qui tue des processus sous pression mémoire, et le journal système tranche plus vite qu'une chasse aux erreurs applicatives.
- 06La demande peut reposer sur une fausse prémisse9 min
Une demande peut décrire le symptôme avec exactitude tout en se trompant sur la cause, et exécuter cette demande à la lettre ne corrige alors rien ou aggrave la situation.
- 07Lire la fonction appelée, prouver le coupable10 min
Un correctif dont le test unitaire passe au vert peut être annulé, dans le même tour d'exécution, par la fonction appelée juste après, et la fonction déjà corrigée n'est un coupable prouvé qu'après qu'un test a isolé son effet de celui des fonctions suivantes.