Fichier CLAUDE.md : bonnes pratiques, exemples et 3 modèles

CLAUDE.md et la mémoire de Claude Code

Chaque session Claude Code démarre avec une mémoire vierge. Deux choses transmettent des connaissances d'une session à l'autre : les fichiers CLAUDE.md que vous écrivez, et les notes de mémoire automatique que Claude écrit pour lui-même.

Quand vous dites « retiens que je facture en euros », Claude l'enregistre dans la mémoire automatique, et des notes comme « Saved 2 memories » s'affichent quand cela arrive. Pour mettre une règle dans CLAUDE.md à la place, dites « ajoute ça à CLAUDE.md ».

La mémoire automatique est activée par défaut et se trouve dans ~/.claude/projects/<project>/memory/ : un index MEMORY.md avec une ligne par note, plus un petit fichier pour chaque note. Lancez /memory pour la lire, la modifier ou la désactiver.

Claude lit-il CLAUDE.md à chaque fois ?

Oui, automatiquement, au début de chaque conversation, y compris la nouvelle que vous obtenez après /clear. Claude Code le transmet à Claude sous forme de message juste après ses propres instructions intégrées, donc Claude le lit et essaie de le suivre, mais rien ne l'y oblige. Pour bloquer quelque chose quoi qu'il arrive, utilisez une règle de permission, présentée plus bas.

Emplacement du fichier CLAUDE.md : où va chaque fichier

~ désigne votre dossier personnel (%USERPROFILE% sous Windows), et ./ le dossier principal de votre projet.

Sur Mac, le fichier global est /Users/yourname/.claude/CLAUDE.md ; le Finder masque les dossiers qui commencent par un point, donc appuyez sur Cmd+Maj+. pour les voir. Voici à quoi ressemble un projet de petite entreprise sur le disque, avec le modèle dirigeant d'entreprise présenté plus bas enregistré comme CLAUDE.md :

Claude Code charge le CLAUDE.md du dossier où vous le lancez et de chaque dossier au-dessus, et les fichiers s'additionnent au lieu de se remplacer. Un CLAUDE.md dans un sous-dossier ne se charge que quand Claude commence à travailler sur des fichiers de ce sous-dossier.

Comme le fichier le plus spécifique est lu en dernier, une règle de projet est la plus proche du travail. Évitez quand même de contredire votre fichier personnel, car quand deux règles se contredisent, Claude peut suivre l'une ou l'autre.

Comment créer un fichier CLAUDE.md

1. Ouvrez le dossier du projet dans Claude Code. Dans le terminal, placez-vous dans le dossier et lancez claude ; dans l'application de bureau, utilisez l'onglet Code et Select folder.
2. Lancez /init. Claude parcourt le dossier et écrit un CLAUDE.md de départ. S'il en existe déjà un, il propose des améliorations au lieu de l'écraser, et il reprend les règles que vous aviez écrites pour Cursor ou GitHub Copilot.
3. Ou laissez Claude vous interroger. Pour un dossier encore presque vide, le prompt ci-dessous donne de meilleurs résultats que /init.
4. Modifiez-le. /memory liste vos fichiers CLAUDE.md et en ouvre un dans votre éditeur, ou dites simplement « ajoute cette règle à CLAUDE.md ».
5. Rechargez-le. Le fichier est lu au démarrage de la session, donc lancez /clear ou une nouvelle session après modification ; la page sur le cache des prompts d'Anthropic explique pourquoi les modifications en cours de session attendent.
6. Vérifiez qu'il est chargé. Lancez /context et cherchez le fichier sous Memory files.

Nous avons lancé /init dans le petit projet de landing page de notre guide du vibe coding. Il a lu les deux fichiers, présenté le CLAUDE.md pour validation (l'image en haut de ce guide), puis résumé ce qu'il avait retenu :

Je veux un CLAUDE.md pour ce dossier. Pose-moi jusqu'à 8 questions, une à la fois, sur mon activité, pour qui est le travail, mon ton, les règles que je veux toujours voir respectées et ce que « terminé » veut dire pour moi. Puis écris un CLAUDE.md de moins de 60 lignes avec des titres clairs, et montre-le-moi avant de l'enregistrer.

Bonnes pratiques CLAUDE.md : quoi y mettre et quoi laisser de côté

Voyez CLAUDE.md comme l'endroit des choses que vous réexpliqueriez sinon. Un bon signal pour ajouter une ligne : Claude fait deux fois la même erreur, ou vous tapez la même correction que la semaine dernière.

Quelle longueur pour un fichier CLAUDE.md ?

Moins de 200 lignes, et pour la plupart des dossiers professionnels bien moins de 100. Claude Code vous avertit au démarrage, et dans /status, quand un fichier dépasse la longueur recommandée ou quand l'ensemble de vos fichiers de consignes devient trop lourd, et il ignore tout fichier de plus de 4 MiB. Chaque ligne se charge à chaque session, donc un fichier léger fait aussi durer votre forfait, comme l'explique le guide des limites d'usage de Claude Code.

Importer d'autres fichiers avec @

Si vos règles sont déjà dans un autre fichier, importez-le au lieu de le copier. Une ligne comme @brand/voice.md charge ce fichier au démarrage, et le chemin est lu depuis le dossier où se trouve le CLAUDE.md. Les fichiers importés peuvent en importer d'autres, jusqu'à quatre niveaux de profondeur.

• Les espaces dans un chemin demandent une barre oblique inverse avant chacun : @Brand\ Kit/voice.md.
• Pour mentionner un chemin sans l'importer, entourez-le d'accents graves (backticks).
• Les fichiers hors du projet, comme @~/.claude/my-rules.md, déclenchent une fenêtre d'approbation unique dans ce projet.

Les imports gardent les choses organisées mais n'allègent pas le fichier, car les fichiers importés se chargent aussi au démarrage.

Trois modèles CLAUDE.md à copier

Ces exemples de CLAUDE.md sont écrits pour les personnes qui ne codent pas. Chacun fait de 21 à 25 lignes, environ un huitième du plafond de 200 lignes d'Anthropic, donc il reste de la place pour vos propres règles. Remplacez tout ce qui est entre crochets, supprimez ce qui ne s'applique pas, et élaguez encore après une semaine d'usage réel.

Modèle 1 : dirigeant d'entreprise

Enregistrez-le sous ~/.claude/CLAUDE.md pour l'appliquer partout, ou sous CLAUDE.md dans le dossier de votre travail administratif.

# Moi et mon entreprise
- Je dirige [NOM DE L'ENTREPRISE], un(e) [TYPE D'ACTIVITÉ] à [VILLE OU MARCHÉ].
- Les clients sont [QUI ILS SONT]. Produits ou services principaux : [LISTE].
- Je ne suis pas développeur. Explique tout ce qui est technique en une phrase simple.

# Comment travailler avec moi
- Pose-moi des questions avant de commencer tout ce qui prend plus de quelques étapes.
- Montre-moi un plan court avant de modifier plus de 3 fichiers.
- Réponds en [LANGUE], en paragraphes courts, sans jargon.

# Règles toujours valables
- N'envoie jamais d'e-mails, de messages ni de paiements. Prépare des brouillons que j'enverrai.
- Ne supprime jamais de fichiers. Déplace ce que tu veux retirer dans un dossier appelé _trash.
- N'invente jamais de chiffres, prix ou faits. S'il manque quelque chose, demande-moi.
- La devise est [DEVISE]. Les dates s'écrivent [FORMAT DE DATE].

# Fichiers et dossiers
- Les documents entrants sont dans /inbox. Le travail terminé va dans /output.
- Nomme les fichiers comme AAAA-MM-JJ_sujet.

# Quand tu termines une tâche
- Liste ce que tu as modifié, ce que tu n'as pas pu faire et ce dont tu n'étais pas sûr.

# Lors de la compaction
- Garde la liste des fichiers modifiés et les questions en suspens.

La dernière section suit un conseil de la page des bonnes pratiques d'Anthropic : une consigne « lors de la compaction » dit à Claude quoi garder quand il résume une longue conversation.

Modèle 2 : marketeur

Enregistrez-le sous CLAUDE.md dans votre dossier marketing. Pour des workflows marketing complets qui l'utilisent, voyez Claude Code pour le marketing.

# Marque
- Marque : [NOM DE LA MARQUE]. Nous vendons [OFFRE] à [PUBLIC].
- Ton : [TROIS ADJECTIFS]. Nous sonnons comme [EXEMPLE], jamais comme [CONTRE-EXEMPLE].
- Mots que nous n'utilisons jamais : [LISTE].
- Orthographe : français de [FRANCE, BELGIQUE, SUISSE OU CANADA].

# Faits et affirmations
- Utilise uniquement les faits de /brand/facts.md et des fichiers que je te donne.
- Chaque statistique a besoin d'un lien source. Si tu n'en trouves pas, retire le chiffre.
- Ne nomme pas de concurrents sauf si je le demande.

# Canaux et formats
- LinkedIn : moins de [NOMBRE] mots, une idée par post.
- E-mail : objet de moins de [NOMBRE] caractères, un seul appel à l'action.
- Légendes Instagram : l'accroche en première ligne, moins de [NOMBRE] mots au total.

# Fichiers
- Les briefs sont dans /briefs. Les brouillons vont dans /drafts, un fichier par contenu, nommé canal_sujet_date.

# Avant de dire que c'est fini
- Vérifie chaque affirmation dans les fichiers sources et liste tout ce qui n'est pas étayé.

Modèle 3 : projet de site web

Enregistrez-le sous CLAUDE.md dans le dossier principal du site. Le guide pour créer un site avec l'IA détaille un projet complet qui va bien avec.

# Projet
- Site pour [NOM DE L'ENTREPRISE] : [À QUOI SERT LE SITE].
- La seule action attendue des visiteurs : [PAR EXEMPLE, RÉSERVER UN APPEL].
- Construit avec [TECHNOLOGIES, PAR EXEMPLE HTML ET CSS SIMPLES]. Hébergé sur [HÉBERGEUR].

# Commandes
- Aperçu en local : [COMMANDE]
- Vérification avant publication : [COMMANDE]

# Règles de design
- Couleurs : [CODES HEX]. Polices : [POLICES]. Garde beaucoup d'espace blanc.
- Mobile d'abord : vérifie chaque modification en largeur téléphone avant de dire que c'est fini.
- Chaque image a un texte alternatif. Les boutons disent ce qui se passe ensuite (« Réserver un appel », pas « Envoyer »).

# Règles de contenu
- Utilise uniquement les textes de /content et les faits que je confirme. Aucun avis, chiffre ou logo inventé.
- Chaque page a son propre titre et sa meta description.

# À ne pas faire
- N'ajoute pas de bibliothèques, plugins ou services sans me demander.
- Ne modifie pas les réglages de domaine, de DNS ou d'hébergement.

# Terminé signifie
- La commande de vérification passe, la page fonctionne en largeur téléphone, et tu listes ce que tu as modifié.

Faut-il copier le CLAUDE.md de Karpathy ?

Le fichier qu'on appelle « le CLAUDE.md de Karpathy » est un fichier communautaire construit à partir des posts d'Andrej Karpathy sur les erreurs que font les outils de code IA ; il ne l'a pas publié lui-même. Il fait 65 lignes en quatre sections (réfléchir avant de coder, la simplicité d'abord, des modifications chirurgicales, une exécution guidée par l'objectif), et son dépôt GitHub comptait environ 221 000 étoiles en octobre 2026.

Si vous écrivez du code, c'est une base solide à coller au-dessus des règles de votre projet. Sinon, deux de ses idées restent utiles : demander quand quelque chose n'est pas clair au lieu de deviner, et convenir de la façon de vérifier le succès avant de commencer. Les modèles 1 et 3 couvrent déjà les deux en langage simple, avec « pose-moi des questions avant de commencer » et la section « Terminé signifie ».

Quand CLAUDE.md ne suffit pas

Le guide pour créer un skill Claude montre comment transformer une procédure en skill. Pour les règles deny, le guide des permissions d'Anthropic donne la syntaxe, et notre aide-mémoire Claude Code inclut un fichier de paramètres de départ.

CLAUDE.md vs AGENTS.md

AGENTS.md, c'est la même idée pour d'autres outils de code, comme Codex d'OpenAI. Depuis la version 2.1.277, Claude Code lit un AGENTS.md tout seul, mais seulement quand il n'y a ni CLAUDE.md ni CLAUDE.local.md dans votre dossier ou au-dessus.

Pour garder un seul jeu de règles pour tous les outils, mettez @AGENTS.md sur la première ligne de votre CLAUDE.md et ajoutez en dessous les règles propres à Claude. Pour que Claude lise les deux fichiers sans import, ouvrez /config et réglez Project instructions sur claude-md-and-agents-md.

CLAUDE.md ne fonctionne pas ? Solutions aux problèmes courants

Si une règle doit tenir à chaque fois, transformez-la en règle de permission ou en hook au lieu de la crier plus fort.

Que faire ensuite

Ouvrez votre dossier de projet le plus utilisé, lancez /init ou le prompt d'entretien, et gardez le résultat sous 60 lignes la première semaine. Chaque fois que vous corrigez Claude, demandez-vous si cette correction a sa place dans le fichier, et retirez tout ce que Claude fait déjà de lui-même. Le tutoriel Claude Code pour débutants montre CLAUDE.md à l'œuvre dans un vrai projet, et la formation Claude Code d'ai school consacre une leçon complète au fichier CLAUDE.md, suivie d'une leçon sur les skills et MCP.