Quand ça bloque : lire une erreur et repartir proprement

1. À la fin de cette leçon, tu sauras

Lire un message d’erreur sans paniquer et en tirer l’essentiel.
Faire expliquer une erreur en mots simples.
Interrompre l’agent avec Échap et repartir proprement avec /clear.
Trouver de l’aide fiable quand tu restes bloqué.

2. Pourquoi ça t’intéresse

Hugo demande à l’agent de transformer ses notes de cours en fiches de révision. Au bout d’un moment, un pavé de texte en anglais apparaît, avec le mot « error ». L’agent essaie autre chose, se trompe encore, propose une troisième solution de plus en plus compliquée. Hugo sent la panique monter. Il appuie sur Échap, copie le message, demande une explication simple : un de ses fichiers avait un nom avec un caractère spécial. Il note le problème dans son carnet, tape /clear, renomme le fichier, relance sa demande. Les fiches sortent en deux minutes.

3. Avant de commencer


Il te faut	Claude Code installé, ton dossier `formation-ia`, ton carnet de bord, un chatbot habituel ouvert dans le navigateur
Coût	Celui de ton abonnement : vérifie le prix du jour sur claude.com/pricing
Durée	30 à 40 minutes

4. Comprendre en 3 minutes

Une erreur n’est pas une panne. C’est un message qui te dit ce qui a coincé. Les développeurs expérimentés en voient tous les jours : ils les lisent au lieu de les fuir.

Image mentale : le voyant du tableau de bord d’une voiture. Il ne veut pas dire que la voiture est morte. Il te dit où regarder.

Les blocages les plus courants, et le bon premier geste :

Ce que tu vois	Ce que ça veut souvent dire	Premier geste
Un message d’erreur après une commande	Un fichier introuvable, un outil absent, une faute de nom	Copier le message et demander une explication
L’agent tente, échoue, retente	Il manque une information ou la demande est floue	Échap, puis préciser
Les réponses deviennent confuses après une longue session	La conversation est trop chargée	Noter l’essentiel, puis `/clear`
Un souci de connexion ou de compte	Abonnement, réseau, identification	Vérifier sur la documentation et l’aide officielles

Tes trois outils :

Échap : arrête l’agent en cours de route, sans rien casser.
Échap deux fois : revient à un message précédent pour reformuler (leçon 5).
/clear : vide la conversation et repart de zéro. Tes fichiers ne bougent pas, mais l’agent oublie tout ce qui s’est dit. D’où l’importance de noter avant.

La commande /help affiche l’aide intégrée. Pour le reste, la documentation officielle est sur code.claude.com/docs.

5. Faire ensemble

Étape 1 · Provoquer une erreur sans risque

Lance claude dans formation-ia et demande :

Ouvre le fichier [un nom de fichier qui n'existe pas, par exemple : budget-2019.md] et résume-le.

L’agent signale que le fichier est introuvable : une erreur ordinaire, sans conséquence.

Étape 2 · Faire expliquer un message

Quand un message d’erreur s’affiche (ici ou plus tard), sélectionne-le, copie-le, puis :

Je débute. Voici le message d'erreur qui vient de s'afficher : [colle le message].
Explique-moi en trois phrases simples ce qu'il veut dire, la cause la plus probable, et ce que je peux vérifier moi-même avant que tu fasses quoi que ce soit.

Tu peux aussi poser la même question dans ton chatbot habituel, pour un second avis. Vérifie qu’aucun mot de passe ni information personnelle ne figure dans le message copié.

Étape 3 · Interrompre une tentative qui s’emballe

Range tous les fichiers de ce dossier dans des sous-dossiers thématiques.

Dès que l’agent commence à proposer des déplacements, appuie sur Échap. Puis réoriente :

Stop. Ne déplace rien. Propose-moi d'abord un plan de rangement en mots simples, et attends mon accord.

Étape 4 · Repartir proprement avec /clear

Demande à l’agent :

Résume en cinq lignes ce que nous avons fait, ce qui a bloqué et ce qui reste à faire.

Copie ce résumé dans ton carnet de bord.
Tape /clear.
Relance une demande nette en t’appuyant sur ton résumé.

Étape 5 · Savoir où demander de l’aide

Ouvre code.claude.com/docs et repère la partie consacrée aux problèmes courants et au dépannage.
Ouvre support.anthropic.com pour les questions de compte et d’abonnement.
Note dans ton carnet ces deux adresses, et le nom d’une communauté d’utilisateurs que tu as trouvée par la documentation ou par ton entourage.

6. Faire toi-même

Reprends une tâche qui t’a déjà posé problème, ou une nouvelle tâche réelle un peu plus ambitieuse : fusionner deux fichiers de notes, transformer une liste en tableau, préparer un récapitulatif de plusieurs comptes rendus.

Au premier blocage, applique la routine : Échap, copier l’erreur, faire expliquer, vérifier.
Si l’agent tourne en rond après deux essais, fais résumer, note, /clear, recommence.
Si rien ne marche, cherche dans la documentation officielle avant tout autre site.

Résultat attendu : une tâche menée jusqu’au bout malgré au moins un blocage, et une fiche « Erreur rencontrée, cause, solution » dans ton carnet.

7. Vérifier

J’ai lu au moins un message d’erreur jusqu’au bout au lieu de le fuir.
J’ai obtenu une explication simple d’une erreur avant de laisser l’agent la corriger.
J’ai interrompu l’agent avec Échap et réorienté sa demande.
J’ai noté un résumé dans mon carnet avant d’utiliser /clear.
Je connais l’adresse de la documentation officielle et de l’aide d’Anthropic.
Ma fiche « Erreur, cause, solution » contient au moins une ligne.

Piège fréquent : copier dans le terminal une commande trouvée sur un forum ou dans une vidéo, sans la comprendre, pour « réparer » un problème. Certaines commandes suppriment ou modifient beaucoup de choses. Fais-la toujours expliquer d’abord, et préfère la documentation officielle.

8. Ce que tu gardes

Dans ton carnet de bord, une rubrique « Dépannage » :

La routine : Échap, copier, faire expliquer, vérifier, noter, /clear si besoin.
La demande de l’étape 2, prête à coller.
Ta fiche « Erreur, cause, solution », que tu complètes à chaque blocage.
Les adresses code.claude.com/docs et support.anthropic.com.

9. Pour aller plus loin

Quand une session devient longue sans être bloquée, /compact résume la conversation pour alléger la mémoire de l’agent ; la documentation officielle explique la différence avec /clear.
Le module 6 t’apprend à garder une mémoire durable dans un fichier CLAUDE.md, pour ne plus tout réexpliquer après un /clear.