Bien formuler ses demandes à Claude Code

Avec Claude Code, vous n'écrivez pas de code : vous écrivez des demandes. La qualité du résultat suit celle de la description, comme pour briefer un prestataire. Cinq principes couvrent l'essentiel.

1. Décrivez le résultat et comment le juger. Vous n'avez pas à savoir comment on fait. Dites ce que vous voulez, à quoi ça sert, ajoutez un critère vérifiable : « la page doit rester lisible sur téléphone », « une ligne par client, sans doublon ». Claude s'en sert pour contrôler son propre travail avant de vous rendre la main. C'est le premier conseil des bonnes pratiques d'Anthropic.

2. Donnez le contexte qu'un inconnu n'aurait pas. Claude ne sait ni qui vous êtes ni à qui s'adresse le résultat : votre métier, votre public, la langue, le ton. Dites-le une fois. Si vous le répétez à chaque session, direction votre CLAUDE.md.

3. Montrez un exemple plutôt que d'empiler les adjectifs. « Moderne et épuré » ne veut rien dire de précis ; une référence, si. Collez une capture d'écran dans la fenêtre (Claude Code la lit), donnez l'adresse d'un site que vous aimez, ou citez un document modèle : « comme cette facture, mais avec mon logo ».

4. Avant le plan, laissez-le poser ses questions. Pour les tâches qui comptent, demandez « as-tu des questions avant de te lancer ? », puis « propose-moi un plan ». Vous tranchez sur le papier plutôt que sur le résultat : deux minutes de questions en amont épargnent une demi-heure de travail parti de travers.

5. Une tâche à la fois, corrigée en vol. Une demande-fleuve qui empile cinq souhaits donne un résultat moyen sur les cinq. Demandez une chose, regardez, ajustez : « plus sobre », « le bouton en haut ». Si Claude part dans la mauvaise direction, Échap l'interrompt net : interrompre tôt coûte toujours moins cher que laisser finir un travail mal engagé.

L'avant/après ci-dessous condense ces cinq principes :

✦ Avant : trop flou pour bien aboutir

Fais-moi un site.

✦ Après : résultat décrit, critère donné, questions puis plan

Crée une page web sobre, en un seul fichier index.html, qui présente mon activité de photographe indépendante à Lausanne. Je veux : un titre avec mon nom, un court texte qui dit ce que je fais et pour qui, mes trois prestations, et une section contact avec mon e-mail. Texte en français, vouvoiement. Pour le style, inspire-toi de la mise en page de [adresse d'un site que vous aimez]. Critère de réussite : la page doit rester parfaitement lisible sur téléphone. Avant d'écrire quoi que ce soit, dis-moi si tu as des questions pour lever les ambiguïtés, puis propose-moi un plan.

Ces principes ne valent pas que pour les pages web. Voici le même brief pour une tâche administrative, le terrain où Claude Code rend le plus de services au quotidien. Deux ajouts : un critère de réussite qui prévoit les cas d'échec et un test sur échantillon avant de traiter tout le dossier.

✦ Le même brief, version administrative

Dans ce dossier, renomme toutes les factures PDF au format 2026-03_NomDuFournisseur.pdf, en lisant la date et le nom du fournisseur dans chaque fichier. Contexte : ce sont mes factures fournisseurs, certaines sont en allemand. Critère de réussite : aucun fichier perdu, et un fichier a-verifier.txt qui liste les PDF que tu n'as pas réussi à lire avec certitude. Montre-moi le renommage prévu sur 3 exemples avant de traiter le reste.

Et quand le résultat ne convient pas ? Vos corrections comptent autant que la demande initiale. « Ce n'est pas ce que je voulais » ne donne rien à Claude pour travailler ; « le ton est trop commercial, garde le contenu mais reste factuel, sans superlatifs » corrige en un aller-retour. Décrivez l'écart entre ce que vous vouliez et ce que vous voyez, pas votre déception.

Si une série d'itérations est partie trop loin, rien n'est perdu : un double Échap ouvre l'historique de la session, pour remonter à un message antérieur. Claude restaure alors les fichiers dans l'état exact où ils étaient, une photo étant prise avant chaque modification. Vous pouvez donc essayer une direction, constater qu'elle ne donne rien et revenir au point de départ.

Quelques formules reviennent dans toutes les bonnes sessions et méritent d'entrer dans votre vocabulaire : « as-tu des questions avant de te lancer ? », « propose-moi un plan », « quelles informations te manquent ? », « explique-moi avant d'agir », « montre-moi sur un exemple avant de traiter le reste », « qu'est-ce qui pourrait mal se passer avec cette approche ? ».

Pour passer à la pratique, l'exercice final du cours Bien commencer avec Claude Code vous fait créer la page de l'exemple avant/après, itérations comprises.