Pourquoi tes demandes donnent des résultats moyens

Le scénario que tu connais

Tu demandes quelque chose à Claude. Il répond vite, le code tourne, et pourtant ce n'est pas tout à fait ça. Tu reformules, il corrige, tu reformules encore.

Au bout d'un moment, tu te dis que l'outil est « moyen ». Chez moi, le plus souvent, ce n'était pas l'outil. Il manquait quelque chose dans ma demande.

Cette leçon te montre ce qui manque, sur un vrai cas.

Un vrai cas : la musique trop forte

Je fabrique les vidéos courtes de ma chaîne de développement avec Claude Code. Certaines sont des promos de sites, narrées avec ma voix, avec une musique en fond.

Un jour, je fais ce retour : « la musique est presque trop forte par rapport à ma voix ». Et ce n'était pas la première fois que je le disais.

La réponse d'avant avait été la plus naturelle du monde : baisser la musique avec un volume fixe. Un réglage de 0,16 dans une version du modèle de vidéo, de 0,22 dans l'autre.

Ce que ça donnait vraiment

Un volume fixe ne tient pas compte de la piste. Chaque musique a sa propre puissance : une piste calme et une piste chargée ne sonnent pas pareil au même réglage.

Une fois mesuré, l'écart entre la voix et la musique allait de 2 dB à 13 dB selon la piste. Le dB, ou décibel, est l'unité qui mesure un écart de volume. À 2 dB d'écart, la musique couvre presque la voix.

Le réglage était raisonnable. Il n'était pas juste.

La même demande, réécrite

Voici la même demande, écrite comme il aurait fallu l'écrire dès le départ :

Les promos sont narrées : c'est ma voix qui porte le message,
la musique ne fait qu'habiller.

Aujourd'hui l'écart entre voix et musique va de 2 à 13 dB
selon la piste, parce que le volume de la musique est fixe.

Mesure chaque piste au lieu de poser un volume fixe :
- voix à -16 LUFS ;
- musique 20 dB sous la voix quand je parle,
  14 dB sous la voix sur la carte de fin ;
- limiteur à -1,5 dBFS.

Ne touche pas à l'image des vidéos déjà rendues :
remplace seulement le son.

Avant de rendre, affiche l'écart mesuré pour chaque vidéo.
Je veux lire 20 dB environ, partout.

Le LUFS mesure le volume tel que l'oreille le perçoit. Tu n'as pas besoin de retenir ces unités pour suivre la formation : regarde plutôt ce que la demande dit en plus.

Le résultat

C'est devenu un petit outil de mixage qui s'applique d'office à chaque nouvelle promo. Le 28 septembre 2026, il a remixé mes 29 promos d'un coup, sans toucher à l'image. Chaque vidéo affiche son écart mesuré, et je le relis avant le rendu.

La différence entre les deux demandes n'est pas la longueur. C'est tout ce que la seconde dit et que la première taisait.

Les trois trous

1. Le but manquait

« Presque trop forte » dit ce qui gêne, pas pourquoi ça compte. Sans savoir que la voix porte tout le message, baisser un peu la musique paraît suffisant.

Le guide d'Anthropic sur l'écriture des demandes le dit ainsi : imagine Claude comme un nouvel employé brillant, qui ne connaît ni tes habitudes ni ton projet. Le même guide ajoute qu'expliquer pourquoi une consigne compte aide Claude à mieux viser.

2. Le critère était flou

« Presque trop forte », c'est une impression. Claude ne peut pas la mesurer.

« 20 dB sous la voix », si. Un critère qu'on peut mesurer ne laisse pas de place au « à peu près ».

3. Aucune preuve n'était demandée

Personne n'avait mesuré l'écart avant que je réécoute. La documentation de Claude Code le résume bien : Claude s'arrête quand le travail a l'air fini.

Sans vérification qu'il peut lancer lui-même, c'est toi qui deviens la vérification. Chaque erreur attend que tu la remarques.

Un deuxième cas, en deux phrases

Au début de la chaîne, j'ai demandé trois nouvelles séries de vidéos avec « à peu près le même nombre de tips ». Je voulais dire 10 à 12 par série. Claude avait compris 10 à 12 au total.

Sa lecture n'était pas fausse : ma phrase permettait les deux. Une demande ambiguë donne un résultat ambigu.

Le test du collègue

Avant d'envoyer une demande, fais ce test, tiré du même guide d'Anthropic. Montre-la à un collègue qui ne connaît pas le projet, et demande-lui de la suivre. S'il est perdu, Claude le sera aussi.

La différence, c'est qu'un collègue perdu pose une question. Claude, lui, avance souvent quand même : il suppose.

Pas besoin de quatre paragraphes pour renommer une variable. Mais dès que la tâche touche plusieurs fichiers, ou qu'un résultat « à peu près » ne te suffit pas, le test vaut les trente secondes qu'il coûte.

Ce qu'il te faut pour suivre

La méthode elle-même ne demande rien : elle marche aussi avec Claude dans le navigateur. Les gestes des chapitres suivants (mode plan, images, dictée, retour en arrière) sont ceux de Claude Code.

Il te faut donc Claude Code installé, avec un abonnement Claude Pro, Max, Team ou Enterprise, ou un compte Claude Console. Tape claude --version dans ton terminal : si un numéro s'affiche, tu es prêt. Sinon, la formation Claude Code : bien démarrer l'installe pas à pas sous Windows, macOS et Linux, dans une leçon offerte.

Pour la leçon sur la dictée, prévois un micro.

Ce que la suite t'apporte

La prochaine leçon, en accès libre elle aussi, te donne la structure complète d'une demande qui marche : le but, le contexte, les contraintes, la preuve attendue. Avec un modèle prêt à copier, les exemples de la documentation officielle et un deuxième cas réel.

Ensuite, deux chapitres :

• Donner du contexte : faire réfléchir Claude avant qu'il écrive grâce au mode plan, lui montrer une capture au lieu de la décrire, et dicter tes demandes à la voix sans perdre en précision.
• Obtenir du fiable : exiger des preuves plutôt que croire, corriger le tir sans tout recommencer, et une bibliothèque de demandes prêtes à copier pour déboguer, relire, refactoriser, tester et comprendre un code inconnu.

Sources : le guide des bonnes pratiques d'écriture des demandes d'Anthropic, les bonnes pratiques de Claude Code et sa configuration requise, vérifiés le 19 octobre 2026.