CLAUDE.md est un fichier texte que Claude Code lit automatiquement au démarrage et traite comme ses instructions permanentes. Vous le placez à la racine du dossier où vous travaillez, vous y écrivez vos règles en français, et l'agent les applique à chaque session sans que vous ayez à les répéter.
C'est le fichier le plus rentable de tout un montage à base d'agent, et celui que la plupart des gens négligent. Voici ce qu'on y met, et un template complet à copier.
À quoi il sert vraiment
Sans CLAUDE.md, chaque session recommence à zéro. Vous réexpliquez votre organisation, vos conventions, ce que vous ne voulez pas qu'il touche. Vous obtenez des résultats corrects mais différents à chaque fois, parce que vos consignes varient sans que vous vous en rendiez compte.
Avec un CLAUDE.md, vous écrivez ces règles une seule fois. L'agent devient prévisible, et surtout il devient automatisable : une tâche planifiée qui tourne sans vous n'a personne pour lui rappeler les consignes. Le fichier joue ce rôle.
Autre bénéfice, moins évident : écrire ce fichier vous force à formuler votre propre organisation. Beaucoup découvrent à ce moment-là qu'ils n'en avaient pas vraiment.
Ce qu'un bon CLAUDE.md contient
Le périmètre, en premier
C'est la section la plus importante, celle qui vous protège. Elle dit ce que l'agent a le droit de toucher, et surtout ce qu'il ne doit jamais toucher.
Un agent sans limites écrites finit toujours par prendre une initiative que vous n'aviez pas demandée. Ce n'est pas de la malveillance, c'est de la serviabilité mal cadrée : il essaie de bien faire sur un terrain que vous n'aviez pas délimité.
La conduite à tenir en cas de doute
La règle qui change le plus la qualité du résultat : dire explicitement quoi faire quand l'agent ne sait pas. Sans cette consigne, il tranche. Avec elle, il signale et laisse en l'état.
Une ligne suffit : « en cas de doute, laisse la note où elle est et signale-le, plutôt que de deviner ».
Les conventions concrètes
Où vont les choses, comment on nomme, quel format. Soyez précis et court : trois règles appliquées valent mieux que quinze ignorées.
Ce qu'il n'invente pas
Un agent complète volontiers ce qui manque. Sur des notes personnelles, c'est exactement ce qu'on ne veut pas : une note enrichie d'informations que vous n'avez jamais écrites devient un faux souvenir.
Un template complet, à copier
# Règles de ce vault
Ce dossier est mon second cerveau. Tout est en markdown.
## Ton périmètre
- Tu ne traites QUE le dossier 00-Inbox.
- Tu ne modifies JAMAIS une note existante hors de 00-Inbox.
- Tu ne supprimes jamais un fichier. Si quelque chose te semble à jeter,
tu le signales dans le récap.
## En cas de doute
- Si le classement n'est pas évident, tu laisses la note dans 00-Inbox
et tu expliques pourquoi dans le récap.
- Tu ne devines pas. Tu préfères poser une question.
## Comment tu ranges
- Chaque note traitée part dans le dossier thématique adapté.
- Tu ajoutes en tête : une phrase de résumé, puis 3 tags maximum.
- Tu relies la note à 2 ou 3 notes existantes pertinentes ([[liens wiki]]).
- Tu ne crées un dossier que si aucun existant ne convient.
## Ce que tu n'inventes pas
- Tu ne complètes pas une note avec des informations que je n'ai pas écrites.
- Si une note est incompréhensible, tu la laisses et tu le dis.
## Le récap
- À la fin, tu écris dans 99-Recaps/ un fichier daté qui liste :
ce que tu as rangé, ce que tu as laissé, et pourquoi.Adaptez les noms de dossiers aux vôtres. Le reste fonctionne tel quel.
Les trois erreurs qui le rendent inutile
1. Le fichier trop long. Un CLAUDE.md de trois pages se dilue. Les règles importantes se noient dans les détails. Visez une page, quitte à être brutal.
2. Les règles floues. « Range bien mes notes » ne veut rien dire. « Chaque note reçoit une phrase de résumé et trois tags maximum » se vérifie. Écrivez des règles dont vous pourriez constater l'application.
3. Décrire l'organisation rêvée. C'est l'erreur la plus fréquente. On décrit le système qu'on aimerait tenir, pas celui qu'on tient. Résultat : l'agent applique consciencieusement des règles que vous ne suivez pas, et le décalage vous saute au visage au bout d'une semaine.
Comment le faire évoluer
Un CLAUDE.md se corrige à l'usage. La bonne méthode : chaque fois qu'un résultat vous déplaît, ne corrigez pas la note à la main. Demandez-vous quelle règle manquait, et ajoutez-la.
Au bout de trois ou quatre corrections, le fichier se stabilise et vous n'y touchez plus. C'est le signe qu'il décrit enfin votre organisation réelle.
Pour voir ce fichier à l'œuvre dans un montage complet, allez voir brancher Claude Code sur Obsidian.
FAQ
Où placer le fichier CLAUDE.md ?
À la racine du dossier depuis lequel vous lancez Claude Code. Pour un second cerveau, c'est la racine de votre vault Obsidian. L'agent le lit automatiquement, vous n'avez rien à faire pour le charger.
Quelle longueur pour un CLAUDE.md ?
Une page suffit dans la grande majorité des cas. Au-delà, les règles importantes se diluent et l'agent applique moins fidèlement. Mieux vaut cinq règles précises que vingt approximatives.
Faut-il l'écrire en anglais ?
Non. Le français fonctionne très bien, et vous serez plus précis dans votre langue. La précision des règles compte bien plus que la langue employée.
Est-ce que ça marche pour autre chose que des notes ?
Oui, c'est même son usage d'origine : cadrer un agent sur un projet de code (conventions, structure, ce qu'il ne doit pas toucher). Le principe reste le même quel que soit le dossier : des règles écrites une fois, appliquées à chaque session.
Que se passe-t-il si je n'en mets pas ?
L'agent fonctionne quand même, mais il improvise. Vous obtiendrez des résultats différents d'une session à l'autre, et l'automatisation devient hasardeuse puisque personne n'est là pour rappeler les consignes.