Aller au contenu
Floskool

Chapitre 2 · Chapitre 2 · Découvrir CLAUDE.md

2.4 Les erreurs de compréhension fréquentes

Leçon gratuite 7 minGroupe Claude Code & IA

Suis cette formation dans ton espace : ta progression est gardée, et la communauté répond à tes questions.

Suivre gratuitement

Avant d'écrire ton premier fichier, faisons le tour des idées reçues. Chacune peut te faire perdre du temps ou te donner de faux espoirs.

« Claude va se souvenir de tout ce que je lui dis »

Non. La conversation disparaît à la fin de la session, et peut même être résumée en cours de route lors d'une compaction. La mémoire automatique ne garde que certaines notes, choisies par Claude. Ce qui doit tenir dans la durée doit être écrit dans CLAUDE.md.

« Plus mon CLAUDE.md est long, mieux c'est »

Non. La documentation conseille de rester sous 200 lignes par fichier : au-delà, il occupe plus de contexte et les consignes risquent d'être moins bien suivies. Mieux vaut 30 lignes précises que 300 lignes floues. Et découper avec des imports @ n'y change rien : les fichiers importés sont chargés avec CLAUDE.md.

« Une règle écrite est une règle garantie »

Non. CLAUDE.md contient des consignes, que Claude suit très bien quand elles sont claires, mais sans garantie absolue. Pour une règle qui doit s'appliquer à chaque fois sans exception (par exemple bloquer une commande dangereuse), Claude Code propose les hooks : des commandes lancées automatiquement à des moments précis, qui s'exécutent à chaque fois sans dépendre de la décision de Claude. C'est un sujet plus avancé.

« Si je contredis une règle dans la conversation, CLAUDE.md gagne »

Pas forcément. Si deux consignes se contredisent (dans le fichier, entre deux fichiers, ou entre le fichier et ta demande), Claude peut en choisir une. Garde ton fichier cohérent, et sois explicite quand tu veux une exception :

Pour cette vidéo seulement, ignore la règle sur la durée : vise 90 secondes. Les autres règles de CLAUDE.md restent valables.

« Je peux y mettre mes mots de passe pour gagner du temps »

Jamais. CLAUDE.md est souvent partagé, et son contenu passe dans le contexte. Les clés et mots de passe vont dans un fichier .env que tu remplis toi-même, jamais dans CLAUDE.md, jamais dans la conversation. Dans CLAUDE.md, tu peux en revanche écrire la règle : « Ne jamais afficher le contenu du fichier .env. »

« La mémoire automatique et CLAUDE.md, c'est pareil »

Non : tu écris CLAUDE.md (des instructions), Claude écrit sa mémoire automatique (ses notes). Les deux se complètent. Et attention au vocabulaire : « souviens-toi de… » range l'information en mémoire automatique ; « ajoute à CLAUDE.md… » l'écrit dans ton fichier.

« Il existe un raccourci # pour ajouter une règle »

Tu le croiseras peut-être dans d'anciens tutoriels. Il n'apparaît plus dans la liste actuelle des raccourcis de la documentation officielle : ne compte pas dessus. Les méthodes à jour sont de demander « Ajoute ceci à CLAUDE.md », ou d'ouvrir le fichier avec /memory.

« /init écrit un fichier parfait »

Non. /init analyse ton projet et décrit ce qu'il voit (dossiers, commandes). Il ne peut pas deviner ton public, ton ton ou tes règles. Il te donne une base à relire et à compléter.

Le petit quiz de vérification

Copie ces questions dans une note et réponds-y. Si tu hésites sur une réponse, relis la section correspondante.

1. Où va la règle « public : débutants en IA » ?
2. Où va la procédure « script, voix, montage, publication » ?
3. Où va ma clé d'API ?
4. Que se passe-t-il si deux règles se contredisent ?
5. Quelle phrase utiliser pour écrire dans CLAUDE.md ?

Réponses : 1. CLAUDE.md. 2. Un skill. 3. Le fichier .env, jamais CLAUDE.md. 4. Claude peut choisir l'une ou l'autre. 5. « Ajoute à CLAUDE.md… ».

Si ça coince

  • Claude applique une règle que tu n'as jamais écrite dans le projet : regarde dans ~/.claude/CLAUDE.md et dans la mémoire automatique, via /memory.
  • Tu as collé une clé dans CLAUDE.md par erreur : supprime-la du fichier tout de suite et considère-la comme exposée (change-la chez le service concerné).
  • Ton fichier dépasse 200 lignes : déplace les procédures dans des skills et les règles d'une seule partie du projet dans .claude/rules/ avec paths.

À retenir

  • La conversation s'oublie, CLAUDE.md reste.
  • Court et précis vaut mieux que long et flou (moins de 200 lignes).
  • CLAUDE.md guide, il ne garantit pas : pour l'absolu, il y a les hooks.
  • Aucune clé ni mot de passe dans CLAUDE.md.
  • Pas de raccourci # : dis « Ajoute à CLAUDE.md » ou utilise /memory.