Le fichier CLAUDE.md expliqué : la mémoire de votre projet Claude Code
CLAUDE.md, c'est quoi ? Le fichier que Claude Code relit à chaque session : quoi y écrire, un exemple réel commenté, des règles tirées de vrais pièges.
L'essentiel
CLAUDE.md est un fichier texte placé dans le dossier principal d'un projet. Claude Code le relit au début de chaque session : on y écrit le métier, les conventions et les interdits de l'outil. Il se rédige en quelques minutes, puis on y ajoute une ligne après chaque erreur corrigée, pour que Claude ne la refasse pas.
Sommaire
- Qu'est-ce que le fichier CLAUDE.md, exactement ?
- Que mettre dans un CLAUDE.md ?
- À quoi ressemble un CLAUDE.md de départ en cinq lignes ?
- Un vrai CLAUDE.md commenté : celui du site Korbolia
- Que mettre dans la section « Ne jamais faire » ?
- Comment faire grandir le CLAUDE.md après chaque erreur ?
- Qu'est-ce que ça change dans une semaine de travail ?
- Que ne fait pas le fichier CLAUDE.md ?
- Questions fréquentes
- Par où commencer
Le fichier CLAUDE.md est un fichier texte placé dans le dossier principal d'un projet, que Claude Code relit au début de chaque session. On y écrit ce que Claude doit savoir sur votre outil : le métier, les conventions à respecter et ce qu'il ne doit jamais faire.
Claude Code commence chaque session sans souvenir de la précédente. Le CLAUDE.md lui redonne vos règles à chaque ouverture, et vous évite de les répéter.
Cet article s'adresse à vous si vous débutez avec Claude Code et que vous n'avez jamais programmé. À la fin, vous saurez écrire un premier CLAUDE.md de cinq lignes, le compléter après chaque erreur corrigée, et vous connaîtrez ses limites.
Qu'est-ce que le fichier CLAUDE.md, exactement ?
Claude Code est l'outil de programmation de Claude, l'IA de la société Anthropic : il lit un projet, modifie les fichiers et vérifie son travail. L'article Claude Code, c'est quoi le présente en détail. Une session, c'est une conversation ouverte avec Claude Code dans un projet, et chaque session démarre à neuf.
Le CLAUDE.md fait exception. Un fichier est un document enregistré sur votre ordinateur, comme une photo ou un tableau Excel. Celui-ci porte exactement le nom CLAUDE.md, en majuscules, et se trouve à la racine du projet, c'est-à-dire directement dans le dossier principal de votre outil. Claude Code le charge au début de chaque session, avant votre première demande.
Le contenu s'écrit en texte ordinaire, en français, avec quelques titres et des tirets. La documentation d'Anthropic sur la mémoire de Claude Code cite trois emplacements ; pour débuter, le premier suffit.
| Emplacement | À quoi il sert | Qui le voit |
|---|---|---|
CLAUDE.md à la racine du projet | Les règles du projet | Toute l'équipe, avec le code |
CLAUDE.local.md à la racine du projet | Vos préférences pour ce projet | Vous seul, s'il reste hors de GitHub |
~/.claude/CLAUDE.md dans votre dossier personnel | Vos préférences pour tous vos projets | Vous seul |
Que mettre dans un CLAUDE.md ?
Le kit de départ de la formation contient déjà un CLAUDE.md qui décrit la pile technique, c'est-à-dire la liste des outils avec lesquels le projet est construit. Vous y ajoutez trois sections, en phrases courtes.
- Métier : qui utilise l'outil, pour quoi faire, avec le vocabulaire de votre activité.
- Conventions : ce qui doit être pareil sur tous les écrans, comme la langue, le format des dates, l'affichage des prix ou un seul bouton principal par formulaire.
- Interdits : ce qui a déjà causé un problème, ou ce qui pourrait en causer un.
Le métier est la partie que Claude ne peut pas deviner en lisant les fichiers du projet. Une boutique écrirait par exemple : « Un client a déjà commandé au moins une fois ; avant sa première commande, c'est un prospect. » Quand vous demandez ensuite « la liste des clients », Claude sait lesquels afficher.
Le même soin vaut pour les statuts : si une commande passe par « à préparer », « prête » puis « livrée », écrivez ces mots tels quels, pour que chaque écran les reprenne.
À quoi ressemble un CLAUDE.md de départ en cinq lignes ?
Prenons un traiteur qui veut un outil pour ses devis et ses commandes. Son premier CLAUDE.md peut tenir en cinq lignes, rangées sous les titres Métier, Conventions et Interdits.
- « Outil interne d'un traiteur : devis, commandes et fiches de production, sur ordinateur et sur téléphone. »
- « Un devis indique le nombre de convives. Un devis signé devient une commande. »
- « Tout le texte est en français. Les dates s'écrivent 12 mars 2026, et chaque montant porte la mention HT ou TTC. »
- « Le message « Enregistré » s'affiche seulement quand la base de données a confirmé l'enregistrement. »
- « Ne jamais supprimer une table, une colonne ou une fiche, ni toucher à la base réelle, sans ma demande explicite. »
La base de données est l'endroit où l'outil range vos informations, comme un classeur Excel qu'il remplit lui-même ; une table en est une feuille. L'article une base de données, c'est quoi reprend cette comparaison. La base réelle contient vos vraies données, et Claude fait ses essais sur une base séparée.
Vous n'avez pas à écrire ce fichier vous-même. Dictez-le à Claude, en français courant :
Ouvre le fichier CLAUDE.md du projet et ajoute trois sections : « Métier », « Conventions » et « Interdits ». Pour le métier, écris que c'est l'outil interne d'un traiteur, pour les devis, les commandes et les fiches de production. Garde des phrases courtes, puis montre-moi le fichier complet.
Si votre projet existe déjà sans CLAUDE.md, tapez la commande /init dans Claude Code. Elle analyse le projet et rédige un premier fichier ; si un CLAUDE.md existe, elle propose des améliorations sans l'écraser. Complétez ensuite avec ce que Claude ne trouvera dans aucun fichier : votre métier et vos interdits.
Un vrai CLAUDE.md commenté : celui du site Korbolia
Le site qui vend cette formation a son propre CLAUDE.md, et il tient sur un écran. Après quelques lignes sur la technique du site, chaque règle répond à un risque précis.
| Ce que dit le fichier | Ce que la règle évite |
|---|---|
| « Un seul prix pour tout » | Le prix de la formation est défini à un seul endroit. Claude ne crée ni deuxième tarif ni offre de lancement en retouchant une page. |
| « Aucune rareté, aucun compteur, jamais » | Un assistant qui rédige une page de vente peut ajouter un compte à rebours par habitude. La règle l'exclut sur tout le site. |
| Une leçon sans vidéo s'affiche « en cours d'enregistrement » | Certaines vidéos sont encore en préparation, et aucune page ne les annonce comme disponibles. |
| « Rien n'est inventé à leur place » | Les mentions légales attendent le vrai numéro SIREN et la vraie adresse. Claude laisse la case « À COMPLÉTER » visible. |
« Jamais de push --force » | La commande qui met à jour la structure de la base peut, en mode forcé, vider des tables. C'est un des douze pièges racontés dans la formation. |
Chaque règle se vérifie en regardant l'écran. Le fichier contient aussi un bloc ajouté par Next.js, l'outil de construction du site, qui prévient Claude que sa version a changé. Certains outils écrivent ainsi leurs propres consignes dans le CLAUDE.md ; laissez-les en place.
Que mettre dans la section « Ne jamais faire » ?
Les interdits protègent ce qui ne se rattrape pas : vos données et vos accès.
- Ne jamais modifier la base réelle depuis l'ordinateur de travail : les essais se font sur la base d'essai.
- Ne jamais supprimer une table, une colonne ou une fiche sans demande explicite.
- Ne jamais lancer de commande forcée sur la base de données.
- Ne jamais écrire une clé secrète dans le code. Une clé secrète est le mot de passe qui relie votre outil à un service, un moyen de paiement par exemple ; elle se range dans les réglages de l'hébergeur.
La dernière règle vient d'un piège vécu. Pendant la construction du CRM de Rugstar, une clé secrète est partie sur GitHub, le service qui garde le code et ses versions ; l'article GitHub, c'est quoi explique ce qu'on y range.
Comment faire grandir le CLAUDE.md après chaque erreur ?
La documentation d'Anthropic donne un repère : ajoutez une ligne quand Claude fait la même erreur une deuxième fois, ou quand vous retapez une correction déjà donnée lors d'une séance précédente. On corrige le bug, puis on écrit la règle.
Dans le CRM de Rugstar, une marque de tapis, un bouton affichait « Enregistré » alors que rien n'avait été sauvegardé. Une fois le bug corrigé, la règle est entrée dans les Interdits. Claude peut la rédiger lui-même :
Tu viens de corriger le bouton qui affichait « Enregistré » alors que rien n'était sauvegardé. Ajoute une règle courte dans la section « Interdits » de CLAUDE.md pour que ça n'arrive plus sur aucun écran, puis montre-moi la ligne ajoutée.
Les autres erreurs de vibe coding vécues se traduisent de la même façon en une ligne.
| Le piège | Une ligne qui l'évite |
|---|---|
| Un prix hors taxes pris pour un prix public | « Chaque montant affiché porte la mention HT ou TTC. » |
| Le nom complet rangé dans une seule colonne | « Prénom et nom sont deux champs séparés. » |
| Une page publique qui renvoie vers la connexion | « Les pages publiques s'ouvrent sans connexion. » |
Une fois par mois, relisez le fichier et retirez les lignes qui ne servent plus. D'après la documentation d'Anthropic, deux règles contradictoires peuvent amener Claude à choisir l'une des deux au hasard.
Qu'est-ce que ça change dans une semaine de travail ?
Le premier jour, vous écrivez les cinq lignes avec Claude. Le lendemain, vous demandez l'écran des commandes dans une nouvelle conversation, et Claude part de vos conventions de dates, de prix et de statuts. En milieu de semaine, un bug est corrigé et une ligne entre dans les Interdits. En fin de semaine, vos demandes raccourcissent, parce que le contexte est déjà écrit.
Pour vérifier que Claude connaît vos règles, ouvrez une nouvelle conversation et demandez :
Rappelle-moi les règles et les interdits de ce projet, tels qu'ils sont écrits dans CLAUDE.md.
S'il n'y arrive pas, vérifiez le nom exact du fichier et sa place à la racine du projet. La commande /memory ouvre les fichiers de mémoire, et la commande /context liste ceux qui ont été chargés.
Que ne fait pas le fichier CLAUDE.md ?
Le CLAUDE.md guide Claude sans le contraindre. La documentation d'Anthropic le dit franchement : Claude le lit et essaie de le suivre, sans garantie stricte, surtout pour une consigne vague ou contradictoire. Plus une règle est précise et vérifiable, mieux elle est suivie.
Pour bloquer une action dans tous les cas, Claude Code propose les hooks : des contrôles automatiques, réglés à part, qui s'exécutent avant une action et peuvent l'empêcher. Tant que vous débutez, le mode Manuel, où Claude demande avant chaque modification, ajoute une deuxième sécurité ; l'article sur les modes de Claude Code les compare.
La longueur compte aussi. Anthropic conseille de rester sous 200 lignes par fichier, parce qu'un fichier plus long réduit le respect des consignes. Enfin, le CLAUDE.md s'ajoute aux autres précautions de la méthode : la vérification de chaque écran, la base d'essai séparée et les sauvegardes.
Questions fréquentes
Où se trouve le fichier CLAUDE.md ?
Le fichier CLAUDE.md d'un projet se trouve à la racine du projet, dans le dossier principal de l'outil, sous ce nom exact en majuscules. Claude Code le charge au début de chaque session ouverte dans ce dossier. Un second fichier, ~/.claude/CLAUDE.md, placé dans votre dossier personnel, garde vos préférences pour tous vos projets.
Peut-on écrire le CLAUDE.md en français ?
Le fichier CLAUDE.md peut s'écrire en français, et ceux des projets de Korbolia le sont. Pour qu'il soit bien suivi, la documentation d'Anthropic recommande des consignes concrètes, vérifiables et sans contradiction entre elles.
Quelle est la différence entre CLAUDE.md et la mémoire automatique de Claude Code ?
Le CLAUDE.md contient les règles que vous écrivez vous-même. La mémoire automatique de Claude Code, activée par défaut, contient des notes que Claude prend seul, à partir de vos corrections et de vos préférences. Les deux sont chargées au début de chaque conversation. Une règle importante gagne à être écrite dans le CLAUDE.md, où vous savez exactement ce qu'elle dit.
Par où commencer
Ouvrez votre projet dans l'onglet Code de l'application Claude et demandez à Claude de créer le CLAUDE.md avec vos cinq premières lignes : ce que fait l'outil, deux conventions et deux interdits. Si vous n'avez pas encore de projet, l'article sur le premier outil à construire avec Claude Code vous aide à partir d'un besoin précis. Les deux leçons gratuites montrent l'installation de Claude et le choix de l'abonnement.
Apprenez à construire vos propres outils
Korbolia est une formation vidéo qui vous apprend à créer vos logiciels avec Claude Code, sans écrire de code : un tronc commun, puis les spécialités qui servent votre métier. Les deux premières leçons sont gratuites.
Victor vous guide dans Korbolia, le cours pour construire soi-même ses outils avec Claude Code, sans savoir programmer.
Korbolia est une formation indépendante. Elle n'est ni affiliée à Anthropic ni approuvée par Anthropic. Claude et Claude Code sont des marques d'Anthropic. Les autres marques citées appartiennent à leurs propriétaires, et Korbolia n'est lié à aucune d'elles.