Cours Vibe coding avec Claude Code · Module 1: Claude Code et Cursor
Anatomie d'une bonne demande : but, endroit, contraintes, vérification
Dans cette leçon12
Content de te revoir ! La section « Notre équipage » est déjà sur la page, et tu sais ce que Claude voit et ce qu'il ignore. Aujourd'hui, nous nous occupons de l'ordre lui-même : de quelles parties se compose une demande que Claude exécutera bien du premier coup, et que faire quand la conversation part du mauvais côté.
Problème : corriger une devinette prend plus de temps qu'un bon ordre
« Améliore la page » est une énigme pour Claude. Il ne sait pas ce qui doit changer, dans quel fichier, ce qu'il ne faut pas toucher ni quand s'arrêter, donc il devine. Parfois il tombe juste, plus souvent il fait les choses à sa façon, et tu passes trois tours à corriger. La documentation de Claude Code attire l'attention sur autre chose encore : Claude lit ta demande avec prudence et construit la plus petite chose qui la satisfait, car il ne voit pas l'ampleur de ce que tu espères. Si tu en veux plus, tu dois le dire. Deux minutes passées sur la demande économisent un quart d'heure de corrections.
Quatre briques d'une bonne demande
Dans la leçon 0_1, tu as découvert trois parties d'une demande : le but, l'endroit et les contraintes. Aujourd'hui s'en ajoute une quatrième, qui clôt l'ordre :
| Brique | Question à laquelle elle répond | Exemple |
|---|---|---|
| But | que doit-il naître, et pourquoi ? | les cartes de l'équipage doivent ressembler à de vieux parchemins |
| Endroit | dans quel fichier et dans quelle partie ? | @pirate.html, uniquement la règle CSS des cartes |
| Contraintes | que ne pas toucher et que ne pas utiliser ? | pas de nouveaux fichiers ni de bibliothèques, le titre reste |
| Vérification | à quoi reconnaît-on que c'est fini, et comment Claude le prouve-t-il ? | montre la règle modifiée et le résultat de ls |
La recette du capitaine : écris les briques dans cet ordre. Le but au début, car tout le reste en dépend. L'endroit et les contraintes ensuite, car ils resserrent la route. La vérification à la fin, car elle dit quand la traversée est terminée. C'est justement la vérification que les débutants oublient le plus souvent, alors qu'elle est la plus précieuse : la documentation conseille de donner à Claude quelque chose qui se lance et qui renvoie un résultat clair, et de toujours demander une preuve, c'est-à-dire une commande et son résultat. Un rapport « c'est fait » sans preuve ne dit pas grand-chose, comme tu l'as constaté dans la leçon 0_4.
Désigne l'endroit avec le signe @
Au lieu d'écrire « dans le fichier de la page pirate », tape dans la demande le signe @ et le chemin du fichier. Après @, Claude Code propose les fichiers correspondants, et Tab ou Entrée insère le chemin sélectionné. Voici un exemple de question avec une telle désignation :
Explique ce que font les règles CSS dans @pirate.htmlL'écriture @pirate.html joint le contenu du fichier à la conversation, donc Claude n'a pas à le chercher ni à deviner de quel fichier il s'agit. Le fichier lui-même ne change pas : ce n'est qu'une désignation. Dans une même demande, tu peux désigner plusieurs fichiers, et @ suivi d'un nom de dossier joint la liste de ses fichiers, sans leur contenu.
Fournis au lieu de décrire
La même règle vaut plus largement : si tu as ce dont Claude a besoin, fournis-le-lui au lieu de le décrire avec des mots. Tu as trois moyens :
- un fichier :
@et le chemin, comme ci-dessus ; - une capture d'écran : Claude ne voit pas le navigateur, mais il comprend une image. Le plus simple est d'enregistrer la capture dans le dossier du projet et d'indiquer son chemin dans la demande, par exemple « Regarde la capture cartes.png : les cartes se chevauchent. Corrige cela dans @pirate.html » ;
- le résultat d'une commande : la commande précédée d'un point d'exclamation, vue dans la leçon 0_3, par exemple
! ls, ajoute à la conversation la commande et son résultat, et Claude le commente aussitôt.
Quand tu ne sais pas toi-même ce que tu veux
Parfois, tu n'as qu'une idée vague. Alors n'invente pas une demande de force, mais demande à Claude de t'interroger. Claude te posera des questions sur des points auxquels tu n'as pas encore réfléchi, et il consignera les réponses dans une spécification, c'est-à-dire un fichier qui décrit ce qui doit naître et à quoi l'on reconnaît que c'est prêt. Par exemple :
Je veux ajouter à pirate.html un mini-jeu « Trouve le trésor », mais je
n'y ai pas encore réfléchi. Interroge-moi jusqu'à pouvoir écrire une
spécification, puis enregistre-la dans le fichier SPEC.md.Claude posera des questions, souvent avec des réponses toutes prêtes à choisir : combien de cases a le plateau, que se passe-t-il quand on trouve, ce que le jeu ne fait sûrement pas. L'entretien seul ne construit rien, et en mode Manual Claude ne demandera ton accord qu'avant d'enregistrer SPEC.md. Quand le fichier existe, tape /clear : cette commande ouvre une nouvelle conversation, et l'ancienne reste disponible pour être reprise. Commence la construction dans la conversation neuve par une demande contenant @SPEC.md. Un contexte propre et une définition écrite de « fini » marchent mieux qu'une longue conversation pleine d'idées que tu as écartées en chemin.
Petits pas et la main sur la barre
Découpe une grosse tâche en étapes et donne-les une par une. Ensuite, regarde comment Claude travaille :
- observe la première minute : c'est là qu'il est le plus facile de remarquer que Claude fait fausse route ;
- Échap quand il dévie : cela interrompt le travail, garde ce qui est déjà fait et attend ta consigne ;
- après deux corrections ratées,
/clear: si tu as corrigé deux fois la même chose et que c'est toujours faux, la troisième correction s'ajoute à une conversation qui contient déjà deux essais ratés. Mieux vaut repartir à zéro avec une seule demande qui rassemble tout ce que tu as appris en chemin.
Ce qu'il ne faut plus faire
Les vieux tutoriels sont pleins d'astuces qui n'aident plus aujourd'hui. Les bonnes pratiques officielles de Claude Code en parlent sans détour :
| Ancien conseil | Pourquoi plus maintenant |
|---|---|
| MAJUSCULES et le mot IMPORTANT | les modèles actuels exécutent une phrase ordinaire, et un excès d'insistance pousse Claude à appliquer la règle avec exagération |
| « think hard », « be thorough » | c'est du texte ordinaire, pas un interrupteur ; la profondeur de réflexion de Claude se règle par un réglage à part, l'effort (effort), que tu découvriras dans les lieux suivants |
| « ne sois pas paresseux », « ne t'arrête pas » | de telles phrases provoquent plus souvent un excès de zèle qu'elles n'aident ; donne plutôt à Claude une vérification à réussir |
Le conseil du capitaine : écris calmement et concrètement, comme à un maître d'équipage expérimenté.
Un style de réponse pour apprendre
Tu apprends à lire du code, donc il t'est utile que Claude explique ses décisions. C'est le rôle du style de réponse Explanatory, que tu actives par une commande dans la session :
/output-style explanatoryDès le message suivant, Claude ajoute dans la conversation de courts blocs Insight qui expliquent pourquoi il a écrit le code ainsi plutôt qu'autrement. Ces explications vont seulement dans la conversation, et non dans tes fichiers sous forme de commentaires. Le choix est enregistré dans les réglages locaux du projet, donc il vaut aussi pour les sessions suivantes dans ce dossier. Tu reviens au style ordinaire avec la commande /output-style default. Il existe aussi un style Learning, où Claude te laisse en plus quelques lignes de code à écrire toi-même ; c'est une option pour plus tard, car ce cours s'exerce surtout au commandement et à la lecture.
Avant et après : la section « Notre équipage »
Voici une demande qui laisse à Claude trop de choses à deviner :
Améliore la section de l'équipage pour qu'elle soit plus jolie.Outre le thème général, il manque toutes les briques. « Plus jolie » peut signifier de nouvelles couleurs, des images, des animations ou une tout autre disposition, et Claude peut au passage créer un nouveau fichier de styles ou changer le titre. La même demande construite avec les quatre briques ressemble à ceci :
Demande pour Claude Code :
But : les cartes de la section « Notre équipage » doivent ressembler à
de vieux parchemins : fond crème, bordure marron et coins arrondis.
Endroit : @pirate.html, uniquement la règle CSS .crew-card dans la
balise <style>.
Contraintes : ne change ni le contenu des cartes ni le titre « Ohé les
Pirates ! », ne crée aucun fichier et n'ajoute aucune bibliothèque.
Vérification : à la fin, montre la règle modifiée et le résultat de la
commande ls, pour que je voie qu'il n'y a toujours que pirate.html dans
le dossier.Les étiquettes « But : », « Endroit : » et les autres aident au début de l'apprentissage. Quand les briques seront devenues une habitude, tu écriras la même chose en phrases ordinaires.
Ce que Claude a écrit
Ouvre pirate.html dans Cursor et trouve dans la balise <style> la règle des cartes. Tes couleurs peuvent différer d'une nuance, mais la construction sera semblable :
.crew-card {
border: 3px solid #8b5a2b;
border-radius: 12px;
background-color: #f5e6c8;
padding: 12px;
margin: 12px 0;
}Le point avant crew-card désigne une classe : la règle concerne tout élément avec class="crew-card", donc les trois cartes. border règle la bordure : l'épaisseur, le type de ligne et la couleur, ici marron. border-radius arrondit les coins, et background-color donne le fond crème. La règle ne change ni le contenu des cartes ni le titre h1 : elle ne concerne que l'aspect des éléments de classe crew-card.
La revue du capitaine
- Un seul fichier : seul
pirate.htmla changé, et le résultat delsdonné par Claude le confirme. Lis ce résultat toi-même au lieu de croire le résumé. - Les contraintes : le titre est toujours rouge, et les prénoms et descriptions des cartes sont comme avant.
- La vérification : Claude a montré la règle et le résultat de la commande. S'il ne l'a pas fait, demande-le-lui.
- L'erreur typique : l'agent corrige « au passage » d'autres endroits, par exemple la police de toute la page ou la couleur du titre. En mode Manual, tu le remarques dans la proposition de modification avant d'accepter ; réponds alors No et précise la demande.
Pour finir, ouvre la page dans le navigateur : les cartes doivent avoir un fond crème et des coins arrondis.
Étape suivante
Le site grandit, donc tu as de plus en plus à perdre. Dans la leçon 0_6, tu tendras le filet de sécurité : tu découvriras les limites de /rewind et tu commenceras à tenir le journal de bord dans Git.
Retiens : un bon ordre dit où l'on va, par où l'on passe, ce qu'il faut éviter et à quoi l'on reconnaîtra le port.
Code de cette leçon : demande.md
# La demande avant et après
## Avant : Claude doit deviner
Améliore la section de l'équipage pour qu'elle soit plus jolie.
Il manque le but (que veut dire « plus jolie » ?), l'endroit (quel
fichier et quelle règle ?), les contraintes (que ne pas toucher ?) et la
vérification (à quoi reconnaît-on que c'est fini ?).
## Après : quatre briques dans l'ordre de la recette du capitaine
But : les cartes de la section « Notre équipage » doivent ressembler à de
vieux parchemins : fond crème, bordure marron et coins arrondis.
Endroit : @pirate.html, uniquement la règle CSS .crew-card dans la balise <style>.
Contraintes : ne change ni le contenu des cartes ni le titre « Ohé les
Pirates ! », ne crée aucun fichier et n'ajoute aucune bibliothèque.
Vérification : à la fin, montre la règle modifiée et le résultat de la
commande ls, pour que je voie qu'il n'y a toujours que pirate.html dans le dossier.
## À toi de jouer
Écris ci-dessous ta propre demande en quatre briques, par exemple sur le
pied de page du site avec l'inscription « Perle Noire ».
But :
Endroit :
Contraintes :
Vérification :
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. La demande est : « Dans @pirate.html, ajoute sous la section de l'équipage un pied de page avec l'inscription Perle Noire. Ne change pas les autres sections et ne crée aucun fichier. » Quelle brique manque ?
2. Que fait l'écriture @pirate.html dans une demande pour Claude Code ?
3. Demande A : « Améliore la section de l'équipage pour qu'elle soit plus jolie. » Demande B : « Les cartes de la section Notre équipage doivent ressembler à des parchemins. Change uniquement la règle .crew-card dans @pirate.html, ne touche ni au contenu des cartes ni au titre, ne crée aucun fichier. À la fin, montre la règle et le résultat de ls. » Laquelle est meilleure, et pourquoi ?
4. Tu as corrigé deux fois Claude sur le même point et c'est toujours faux. Que fais-tu ?
5. Que change la commande /output-style explanatory ?
Tâches pratiques dans le jeu
- Tri vertical
Tu ne sais pas encore ce que tu veux. Range les étapes, de l'idée à la construction :