Cours Vibe coding avec Claude Code · Module 3: Clone de Twitter
Le rat dans la cale : déboguer avec Claude Code
Dans cette leçon10
Après la leçon 2_5, tu as donné à Claude une courte demande : « Sur le dernier post du capitaine, montre un badge Nouveau ». Claude a glissé le badge dans le post par le children de la leçon 2_4, le build et le lint sont passés, et tu as fait un commit. Le lendemain, tu as aimé trois fois ton post sur le cap à l'ouest, ajouté un deuxième post et vu quelque chose d'étrange : le nouveau post a trois J'aime et l'ancien zéro. Dans la console du navigateur, pas une seule erreur, dans le terminal seulement GET /feed 200. Un bug qui ne crie pas est un rat dans la cale : on ne l'entend que si l'on sait où tendre l'oreille.
D'abord, reproduis
Avant d'écrire quoi que ce soit à Claude, vérifie que tu sais provoquer le bug sur commande. Note des étapes qui se terminent chaque fois de la même façon :
1. Ouvre /feed et ajoute le post A.
2. Clique sur J'aime du post A trois fois.
3. Ajoute le post B.
Attendu : B a J'aime (0), A a J'aime (3).
Réel : B a J'aime (3), A a J'aime (0).Ces cinq lignes sont la partie la plus précieuse du signalement. Elles disent quoi faire, ce qui devrait arriver et ce qui arrive vraiment, donc Claude n'a pas à deviner. En plus, les mêmes étapes deviendront ton test : après la correction, tu les répéteras et tu verras tout de suite si le rat a disparu.
Comment donner un bug à Claude
La règle de la leçon 0_5 dit : montre au lieu de décrire. Pour les bugs, tu as trois sortes de preuves, et le choix dépend de la manière dont le bug se manifeste :
- le message : quand quelque chose crie, tu copies le texte exact du terminal ou du panneau Console des outils de développement du navigateur, avec le nom du fichier et le numéro de ligne, et non ton propre résumé. Le plus simple pour joindre le résultat d'une commande est le point d'exclamation de la leçon 0_3, par exemple
! npm run build; - les étapes de reproduction : quand le bug est silencieux, comme aujourd'hui, tu donnes les étapes, le résultat attendu et le résultat réel ;
- la capture d'écran : quand il s'agit de l'apparence, tu enregistres la capture dans le dossier du projet et tu donnes son chemin dans la demande. À la fin, supprime le fichier pour qu'il n'entre pas dans le commit.
Attention au nom : la commande /debug de Claude Code sert aux soucis de Claude Code lui-même (elle active l'écriture de son journal), et non aux bugs de ton application.
Demande pour Claude Code
Aujourd'hui tu demandes des hypothèses, c'est-à-dire des causes possibles, et non une réparation. Qui répare avant de comprendre la cause soigne souvent seulement le symptôme.
Demande pour Claude Code :
Bug sur /feed : les J'aime sautent sur le nouveau post. Étapes :
1) ajoute le post A, 2) clique sur J'aime du post A trois fois,
3) ajoute le post B. Attendu : B a J'aime (0), A a J'aime (3). Réel :
B a J'aime (3), A a J'aime (0). Console et terminal sans erreur,
capture dans le fichier capture-jaime.png. Le bug est apparu après
le dernier commit avec le badge Nouveau dans @components/Feed.tsx.
Donne trois hypothèses, de la plus probable à la moins probable, et
pour chacune un moyen de la vérifier sans modifier le code. Ne
corrige encore rien.La demande contient les briques de la leçon 0_5 : le symptôme, les étapes, le lieu et un indice sur le moment où le bug est apparu. La dernière phrase arrête Claude avant qu'il rafistole, et en mode Manual chaque modification attend de toute façon ton accord.
Ce que Claude a répondu : les hypothèses
Ta réponse aura d'autres mots, mais une forme semblable :
1. Clé venant de l'index dans Feed.tsx. Avec le badge Nouveau, map
a reçu index et <li key={index}>. Le nouveau post en haut prend
la clé 0, et React laisse l'état de LikeButton attaché à la clé,
pas au post.
Vérification : la ligne avec key dans Feed.tsx et le diff du
dernier commit.
2. LikeButton ne lit initialLikes qu'au premier rendu.
Vérification : useState(initialLikes) dans LikeButton.tsx.
3. Les J'aime sont enregistrés dans localStorage sous le numéro
de position.
Vérification : cherche localStorage dans components/.La deuxième hypothèse décrit une vraie caractéristique du bouton, mais elle n'explique pas le bug à elle seule, car avant le badge tout marchait. La troisième s'écarte en une minute : la recherche dans le projet, dans Cursor, montre localStorage seulement dans Feed.tsx, pour les posts, et pas pour les J'aime. Reste la première.
Vérifie une hypothèse
Tu vérifies sans changer le code. Demande à Claude : « Montre le diff du dernier commit pour Feed.tsx », ou écris toi-même dans la session ! git show HEAD -- components/Feed.tsx, c'est-à-dire le dernier commit limité à un seul fichier. Le changement recherché ressemble à ceci :
- {posts.map((post) => (
- <li key={post.id}>
+ {posts.map((post, index) => (
+ <li key={index}>Claude avait besoin de index pour le badge et, au passage, il a déplacé la clé. Depuis la leçon 2_2 tu sais que l'index ne convient pas comme clé, car il change quand un nouveau post saute en haut. Voici maintenant la conséquence : key dit à React quel élément est lequel d'un rendu à l'autre. Le post B reçoit la clé 0, qui appartenait un instant plus tôt à A, donc React lui rend le bouton de A avec son état. La documentation de React avertit que l'index comme clé mène souvent à des bugs subtils et trompeurs. Hypothèse confirmée.
Corriger la cause
Maintenant seulement, la réparation, nommée clairement et étroite :
Hypothèse 1 confirmée. Dans @components/Feed.tsx, remets
key={post.id}, et garde index seulement pour le badge Nouveau.
Ne change rien d'autre. Ensuite npm run lint et npx tsc --noEmit,
montre les résultats.Le diff a une seule ligne : <li key={post.id}>. Répète les étapes du début de la leçon : B a zéro, A a trois, et le badge Nouveau voyage jusqu'au post le plus récent. Les étapes de reproduction se sont transformées en un test qui vient de passer.
Erreur typique d'un agent : réparer en cachant le symptôme
Quand la cause n'est pas évidente, l'agent est parfois tenté de faire taire le symptôme. Pour ce bug, Claude peut proposer une clé aléatoire et un compte rendu « les J'aime ne sautent plus » :
- <li key={index}>
+ // eslint-disable-next-line react-hooks/purity
+ <li key={Math.random()}>Le compte rendu est vrai, et la réparation est mauvaise. Une clé aléatoire change à chaque rendu, donc React reconstruit la liste de zéro à chaque fois. Il suffit de taper une lettre dans le champ pour que tous les J'aime des posts du capitaine retombent à zéro. Le lint signale ici l'erreur Cannot call impure function during render, et le commentaire eslint-disable la fait taire. Le même tour a trois autres déguisements : un try/catch avec un catch vide qui avale l'erreur, un ?. posé là où la valeur ne devrait pas être vide, et le as any ou @ts-ignore connu de la leçon 1_4. Tu les reconnais au fait que la correction ne nomme pas la cause. Demande alors : « Quelle était la cause, et pourquoi ce changement la supprime-t-il ? ».
La main sur la barre
Le débogage est un bon moment pour les trois habitudes de la leçon 0_5, cette fois en pratique :
- Esc quand Claude dévie. Si, au lieu des hypothèses, il commence à réécrire
LikeButtonpour enregistrer danslocalStorage, appuie sur Esc. Claude s'arrête, garde ce qu'il a fait et attend une indication, et/rewindannule les modifications s'il en a déjà enregistré. - Après deux corrections ratées,
/clear. Si deux corrections de suite n'ont pas aidé, la troisième ne fait que s'ajouter à une conversation pleine de fausses pistes. Commence une nouvelle conversation par une seule demande qui rassemble ce que tu as appris : le symptôme, les étapes, les hypothèses écartées et l'interdiction de faire taire le linter. - Un effort plus élevé pour un bug difficile. Le niveau d'effort (effort) par défaut est
medium(état en novembre 2026). La documentation conseille de le monter avec la commande/effort highou/effort xhighquand le résultat dépend de cas faciles à manquer, par exemple pour un bug dans du code que tu n'as pas écrit. Quand un seul message est difficile, ajoute-y le motultrathink: il demande une réflexion plus profonde pour ce seul tour et ne change pas le réglage de la session.
La revue du capitaine
Avant de faire le commit, vérifie :
- La correction nomme la cause. Dans le diff, c'est la ligne avec
keyqui a changé, et non le bouton, un effet ou les données delocalStorage. - Les étapes passent. Les étapes de reproduction répétées donnent le résultat attendu, même après l'ajout d'un troisième post.
- Rien n'a été étouffé. Dans le diff, il n'y a ni
eslint-disable, ni@ts-ignore, nicatchvide, ni nouveau?.. - La capture hors du dépôt.
capture-jaime.pngn'est pas dans la liste de Source Control.
Étape suivante
Demande un commit avec une description du genre « Clé du post avec l'id : les J'aime ne sautent plus sur le nouveau post ». Ce bug, tu l'as déjà fait une fois, il mérite donc une ligne dans le règlement du navire :
Dans la section Pièges de @CLAUDE.md, ajoute une seule ligne : la clé
d'un élément de liste vient seulement d'un id fixe, jamais de l'index
de map. Ne change rien d'autre.La prochaine fois, Claude respectera cette règle sans rappel. Et dans la leçon 2_9 tu verras comment un relecteur neuf attrape ces changements avant qu'ils n'entrent dans un commit. Dans l'éditeur ci-dessous t'attend un fil avec un interrupteur de clé : reproduis le bug avec la clé venant de l'index, puis répète les étapes avec la clé venant de l'id.
Retiens : le rat dans la cale, on l'attrape à ses traces, pas en se bouchant les oreilles pour ne plus l'entendre.
Code de cette leçon : App.jsx
// Débogage : les J'aime qui sautent sur le nouveau post.
// Étapes de reproduction : 1) ajoute le post A, 2) clique sur J'aime du post A trois fois,
// 3) ajoute le post B. Attendu : B a 0, A a 3.
// Reproduis d'abord le bug avec la clé venant de l'index, puis passe à la clé venant de l'id
// et répète les mêmes étapes.
import { useState } from 'react';
import LikeButton from './components/LikeButton';
export default function App() {
const [posts, setPosts] = useState([]);
const [draft, setDraft] = useState('');
const [indexKey, setIndexKey] = useState(true);
const handleSubmit = (e) => {
e.preventDefault();
if (!draft.trim()) return;
const newPost = { id: String(Date.now()), content: draft.trim() };
setPosts([newPost, ...posts]);
setDraft('');
};
return (
<div className="min-h-screen bg-gray-50 p-6 text-gray-900">
<h1 className="text-3xl font-bold">Le fil du capitaine</h1>
<label className="mt-4 flex items-center gap-2 text-sm">
<input type="checkbox" checked={indexKey} onChange={(e) => setIndexKey(e.target.checked)} />
Clé venant de l'index, key={'{index}'} (version avec le bug)
</label>
<form onSubmit={handleSubmit} className="mt-4 rounded-lg border border-gray-300 bg-white p-4">
<textarea
value={draft}
onChange={(e) => setDraft(e.target.value)}
rows={2}
placeholder="Post A, puis post B"
className="w-full rounded border border-gray-300 p-2"
/>
<button type="submit" className="mt-2 rounded bg-blue-600 px-4 py-2 font-semibold text-white">
Envoyer
</button>
</form>
<ul className="mt-4 space-y-4">
{posts.map((post, index) => (
// Voici le rat : la clé dit à React quel élément est lequel
<li key={indexKey ? index : post.id} className="rounded-lg border border-gray-300 bg-white p-4">
<p>{post.content}</p>
<LikeButton initialLikes={0} />
{index === 0 && (
<span className="ml-2 rounded bg-amber-100 px-2 py-1 text-xs font-bold text-amber-800">
Nouveau
</span>
)}
</li>
))}
</ul>
</div>
);
}Tu as repéré une erreur dans cette leçon ?
Teste tes connaissances
Réponds aux questions de cette leçon. Choisis une réponse pour voir tout de suite si elle est correcte.
1. Tu as demandé deux fois à Claude de corriger le même bug et ça ne va toujours pas. Que fais-tu ?
2. Quel compte rendu de Claude sur la réparation des J'aime qui sautent devrait t'inquiéter ?
Tâches pratiques dans le jeu
- Tri vertical
Ordonne les étapes pour déboguer un bug silencieux avec Claude Code :