Accueil

Quand ça déraille

1. 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.

2. 02Annuler et récupérer une modification9 min

   Pour annuler la dernière modification de Claude Code dans la session en cours, ouvrez le menu de points de reprise avec /rewind plutôt que de passer d'abord par Git. Git reste l'outil pour ce que ces points ignorent : les modifications faites par une commande bash, les éditions d'un sous-agent en arrière-plan et les fichiers liés.

3. 03Erreurs d'API et limite de débit9 min

   Une erreur d'API porte un code de statut qui distingue des causes très différentes : une requête mal formée doit être corrigée avant tout nouvel essai, alors qu'un plafond temporaire se résout en respectant Retry-After. Un plafond de dépense atteint ne porte pas cet en-tête, et attendre ne sert à rien : il faut relever le plafond.

4. 04Une commande bloquée7 min

   Pour une commande shell figée, tapez Ctrl+C, qui tente d'interrompre l'opération ; sinon relancez avec claude --resume. N'ajoutez pas de préfixe timeout à la main, car l'outil Bash porte déjà un paramètre de délai que Claude choisit lui-même, et la plupart des commandes qui atteignent leur délai basculent en tâche de fond au lieu d'être arrêtées.

5. 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.

6. 06La demande peut reposer sur une fausse prémisse9 min

   Une demande de correction mêle un symptôme observé et une cause supposée : le symptôme peut être exact pendant que la cause est fausse. L'exécuter à la lettre ne répare alors rien. Mesurez l'état réel, énoncez l'écart dès le début de la réponse, puis corrigez la cause réelle.

7. 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.