Erreur de Claude Code : la décrire et la corriger

Claude Code s'est trompé ? Reproduis le bug, décris-le sans secret, isole la cause, vérifie la correction et reviens en arrière si besoin. La méthode.

En clair, en 30 secondes

Avant de demander une correction, refais le problème une fois en notant chaque geste.
Donne à Claude ce que tu attendais, ce que tu vois et le message d'erreur exact, sans aucun mot de passe ni clé API (un code secret d'accès à un service).
Si la correction empire les choses, reviens en arrière : Claude Code garde un point de retour à chaque demande.

Quand Claude Code fait une erreur, décris-lui le symptôme avec précision : ce que tu attendais, ce qui se passe, où, et le message exact, après avoir retiré tout secret. Demande-lui ensuite de trouver la cause avant de corriger, vérifie toi-même le résultat, et reviens en arrière si la correction ne marche pas.

En bref

Une bonne description donne le symptôme, l'endroit probable et ce que « corrigé » veut dire. C'est la méthode que recommande la documentation d'Anthropic [1].
Ce que tu écris à Claude Code part sur le réseau vers Anthropic [2]. Remplace toujours une clé API ou un mot de passe par [MASQUÉ] avant de coller.
Pour annuler, tu as trois filets : les points de retour de Claude Code, une copie de ton dossier, et Git, un logiciel qui sauvegarde ton dossier étape par étape [3] [4].

D'abord, de quelle erreur parle-t-on ?

Il y en a deux sortes.

Claude Code lui-même affiche une erreur. Chaque message a sa fiche dans la page officielle des erreurs, en anglais [5]. Deux cas fréquents :

Message	Ce que ça veut dire	Quoi faire
`API Error: 500` ou `Repeated 529 Overloaded errors`	Un souci passager côté serveur, sans lien avec ta demande ni ton compte	Attends un peu, regarde status.claude.com, puis renvoie ton message [5]
`You've hit your session limit`	Tu as utilisé ta réserve d'usage	Attends l'heure de remise à zéro indiquée dans le message [5]

Ce que Claude a construit ne marche pas. Un bouton qui ne réagit pas, un texte qui déborde sur téléphone, une page blanche. C'est le sujet de la suite.

Étape 1 : reproduis le problème

Reproduire, c'est refaire exprès les gestes qui provoquent le bug (le défaut). Note-les dans l'ordre :

« J'ouvre index.html dans Chrome. »
« Je réduis la fenêtre à la largeur d'un téléphone. »
« Le bouton Contact passe sous le texte et je ne peux plus cliquer dessus. »

Note aussi si ça arrive à chaque fois ou seulement parfois, et dis-le à Claude [6].

Étape 2 : copie le message, sans secret

Le message d'erreur exact vaut mieux qu'un résumé. Où le trouver :

dans le panneau de Claude Code, si c'est lui qui l'affiche ;
dans la Console de Chrome, pour une page web : Ctrl + Maj + J sur Windows, Cmd + Option + J sur Mac [7]. La Console affiche les messages enregistrés par la page [10].

Avant de coller, relis. Claude Code envoie tes messages sur le réseau pour obtenir une réponse [2]. Avec une offre Free, Pro ou Max, Anthropic peut aussi s'en servir pour entraîner ses modèles si le réglage correspondant est activé [2]. Donc :

remplace toute clé API, tout jeton d'accès et tout mot de passe par [MASQUÉ] ;
retire les noms, emails et téléphones de vrais clients ;
pour une capture d'écran, recadre-la avant de la coller dans la zone de saisie [8].

Étape 3 : décris le problème

Copie ce modèle et remplis-le :

```text Problème sur [nom du fichier ou de la page]. Ce que j'attendais : [le bouton Contact reste visible en haut]. Ce que je vois : [sur une fenêtre étroite, il passe sous le texte]. Comment le reproduire : [tes gestes, dans l'ordre]. Ça arrive : [à chaque fois / parfois]. Message d'erreur : [copié tel quel, secrets masqués, ou « aucun »].

Avant de modifier quoi que ce soit, explique-moi la cause la plus probable et propose-moi une correction. Ne change rien d'autre. ```

Dans VS Code, sélectionne les lignes concernées et appuie sur Alt + K (Option + K sur Mac). Claude reçoit une référence au fichier et aux numéros de ligne [8].

Pourquoi « la cause avant la correction » ? La documentation d'Anthropic demande de traiter la cause du problème plutôt que de masquer le symptôme [1].

Étape 4 : isole une seule cause

Si Claude propose plusieurs pistes, teste-les une par une, en commençant par la plus probable. Un seul changement à la fois : si quelque chose casse, tu sais pourquoi.

Pour garder la main, passe en mode Plan : Claude décrit ce qu'il compte faire et attend ton accord avant de modifier un fichier [8]. Et si tu vois Claude partir dans une mauvaise direction, arrête-le avec le bouton Stop ou la touche Échap [8].

Étape 5 : vérifie la correction toi-même

Refais exactement les gestes de l'étape 1, puis vérifie que le reste de la page marche encore.

Demande à Claude des preuves plutôt qu'une simple affirmation, par exemple ce qu'il a lancé et ce que ça a donné. La documentation recommande cette habitude, car relire une preuve va plus vite que tout revérifier [1].

Après deux corrections ratées sur le même problème, la documentation conseille de repartir d'une conversation propre, avec une demande plus précise qui intègre ce que tu as appris [1]. Une conversation encombrée de tentatives ratées gêne Claude.

Revenir en arrière : trois filets selon ton niveau

Filet	Comment	Ce qu'il ne rattrape pas
Points de retour de Claude Code	Dans VS Code, survole un de tes messages et clique sur le bouton de retour. Dans le terminal, tape `/rewind` ou appuie deux fois sur `Échap`	Les fichiers changés par une commande (suppression, déplacement), tes propres modifications à la main [3] [8]
Copie de sauvegarde	Avant une grosse demande, copie tout le dossier et ajoute la date à son nom	Ce que tu as modifié après la copie
Git	Un « commit » par étape qui marche, puis retour à cet état dans VS Code	Ce que tu n'as pas enregistré dans un commit

Les points de retour (« checkpoints »). Chaque demande que tu envoies crée un point de retour [3]. Dans VS Code, le bouton propose trois choix [8] :

Fork conversation from here : repartir de ce message dans une nouvelle conversation, sans toucher aux fichiers ;
Rewind code to here : remettre les fichiers dans l'état de ce moment-là, en gardant la conversation ;
Fork conversation and rewind code : les deux à la fois.

Ces points de retour servent pour la séance en cours. Anthropic précise qu'ils ne remplacent pas Git pour un historique durable [3].

Git. C'est un logiciel gratuit qui garde des points de sauvegarde de ton dossier. Il s'installe à part de VS Code [4]. Dans la vue Source Control de VS Code, un clic droit sur un fichier de la liste Changes, puis Discard Changes, annule ses modifications en cours. Sur un fichier tout neuf, il le supprime. Attention : ce qui est annulé ne part pas dans la corbeille [9]. Pour démarrer, fais l'exercice « Sauvegarder ton travail avec Git ».

FAQ

Claude dit que c'est corrigé, mais le bug est toujours là. Que faire ?

Refais ton test de l'étape 1 et décris ce que tu vois maintenant. Si l'échec se répète, repars d'une conversation propre [1].

Je peux coller tout mon fichier ?

Oui, s'il ne contient aucun secret. Le plus simple reste de citer le fichier : dans VS Code, tape @ suivi de son nom et Claude le lit lui-même [8].

Les points de retour remplacent-ils Git ?

Non. Ils ne voient pas les fichiers modifiés par des commandes, et ils sont faits pour la séance en cours [3]. Git garde un historique durable de ton projet.

La suite

Pour t'entraîner sur un vrai cas, fais l'exercice « Corriger un problème en le décrivant bien », puis retrouve tous les exercices sur la page des exercices et le parcours débutant. Pas encore de projet ? Lis « Comment créer sa première page web avec Claude Code ? ». Et pour garder la main sur ce que l'IA écrit, lis notre article sur la dépendance à l'IA.

Les mots de l'article, expliqués simplement

Bug : un défaut qui fait qu'un programme ou une page ne marche pas comme prévu.
Clé API : un code secret qui ouvre l'accès à un service en ligne, comme une clé de maison.
Console : la zone des outils de Chrome qui affiche les messages d'une page web.
Point de retour (checkpoint) : une sauvegarde automatique que Claude Code crée à chaque demande.
Git : un logiciel qui garde l'historique de ton dossier, sauvegarde après sauvegarde.
Commit : un point de sauvegarde enregistré avec Git.

Sources

Pages consultées le 10 octobre 2026.

[1] Anthropic. Best practices for Claude Code. Claude Code Docs. https://code.claude.com/docs/en/best-practices

[2] Anthropic. Data usage. Claude Code Docs. https://code.claude.com/docs/en/data-usage

[3] Anthropic. Checkpointing. Claude Code Docs. https://code.claude.com/docs/en/checkpointing

[4] Microsoft. Source Control in VS Code. https://code.visualstudio.com/docs/sourcecontrol/overview

[5] Anthropic. Error reference. Claude Code Docs. https://code.claude.com/docs/en/errors

[6] Anthropic. Common workflows, section Fix bugs efficiently. Claude Code Docs. https://code.claude.com/docs/en/common-workflows

[7] Google. Open Chrome DevTools. Chrome for Developers. https://developer.chrome.com/docs/devtools/open

[8] Anthropic. Use Claude Code in VS Code. Claude Code Docs. https://code.claude.com/docs/en/vs-code

[9] Microsoft. Staging and committing changes. https://code.visualstudio.com/docs/sourcecontrol/staging-commits

[10] Google. Console overview. Chrome for Developers. https://developer.chrome.com/docs/devtools/console

Par Kemy Guerouine, le 10 octobre 2026. Cet article a été rédigé pour Formez-vous à l'IA (FVIA).