Comment créer CLAUDE.md, le deuxième cerveau IA de votre entreprise ?
Le fichier CLAUDE.md est un fichier texte que Claude Code lit au début de chaque session : en y décrivant votre entreprise, votre voix, vos offres, votre charte graphique et vos façons de travailler, vous n’avez plus à tout réexpliquer, et l’IA travaille à votre manière. C’est le point de départ d’un deuxième cerveau, une mémoire persistante faite de fichiers qui restent sur votre ordinateur, que Claude relit à chaque conversation et complète à chaque correction. La documentation d’Anthropic décrit surtout CLAUDE.md pour un projet de code. Chez Story B, nous l’utilisons pour piloter une agence entière, de la gestion du site aux visuels des réseaux sociaux, avec un CLAUDE.md de 138 lignes et une poignée de dossiers. Voici comment construire le vôtre, sans être développeur, avec nos fichiers en exemple.
À retenir en 30 secondes
- CLAUDE.md est un fichier texte que Claude Code lit au début de chaque session : ce qui y est écrit n'a plus à être réexpliqué.
- Pour une entreprise, il sert de chef d'orchestre : il renvoie vers vos fichiers d'identité, de voix, de charte graphique et de procédures.
- Anthropic recommande moins de 200 lignes par fichier CLAUDE.md ; le nôtre en compte 138 et renvoie vers les autres fichiers au lieu de les recopier.
- La mémoire automatique de Claude Code note vos corrections : une remarque faite une fois devient une règle appliquée ensuite.
- Pas besoin d'être développeur : un dossier, quelques fichiers en français et une première tâche suffisent pour démarrer.
C’est quoi CLAUDE.md et où se trouve le fichier ?
CLAUDE.md est un fichier Markdown, donc un document de texte simple et structuré, qui donne à Claude Code des instructions persistantes : Claude le lit automatiquement au début de chaque session, avant votre premier message. Chaque conversation avec Claude Code démarre sans souvenir de la précédente. Le fichier CLAUDE.md comble ce vide : tout ce qui y est écrit entre dans la fenêtre de contexte de chaque session, sans que vous ayez à le coller dans le chat.
Le fichier se place à la racine du projet, c’est-à-dire dans le dossier (ou répertoire) où vous lancez Claude Code, depuis le terminal (Claude Code CLI) ou VS Code. Placé directement dans ce répertoire de travail, il sert de contexte permanent au projet. D’autres emplacements existent, chacun avec sa portée :
| Emplacement | Ce qu’il contient | Pour qui |
|---|---|---|
| CLAUDE.md à la racine du dossier de travail | Les règles du projet : votre entreprise, vos procédures | Toute personne qui ouvre ce dossier |
| ~/.claude/CLAUDE.md dans votre profil utilisateur | Vos préférences personnelles au niveau utilisateur, valables dans tous vos projets : votre workflow personnel | Vous seul |
| CLAUDE.local.md à la racine du dossier | Des préférences personnelles pour ce seul projet | Vous seul |
Source : documentation de Claude Code, page Comment Claude se souvient de votre projet, relevée le 18 novembre 2026.
Les fichiers CLAUDE.md des dossiers parents sont chargés eux aussi, et leurs instructions s’ajoutent les unes aux autres. Si vous lancez Claude Code dans le dossier d’un client, il lit CLAUDE.md dans ce dossier, puis celui de votre entreprise au-dessus. Claude Code prend aussi en charge le fichier AGENTS.md, un autre nom de fichier d’instructions utilisé par d’autres outils d’IA.
Parmi les commandes de Claude Code, la commande init (/init) génère un CLAUDE.md de départ en analysant la base de code du dossier. Dans un dossier vide ou pour une entreprise sans code, elle n’a presque rien à analyser : il est plus simple de demander à Claude, en français, de rédiger le fichier à partir d’une présentation de votre activité (voir la dernière section).
Pourquoi CLAUDE.md sert-il de deuxième cerveau à une entreprise ?
Un second cerveau IA (second brain IA en anglais) est un système externe, souvent numérique, qui centralise vos notes, idées, références et projets pour alléger votre charge mentale et retrouver l’information facilement. CLAUDE.md et les fichiers qu’il référence jouent ce rôle : ils gardent par écrit ce que vous savez de votre entreprise, et Claude les relit à chaque session. Dans la fenêtre de chat d’une IA, vous réexpliquez votre activité, votre ton et vos contraintes à chaque nouvelle conversation. Dans un dossier piloté par Claude Code, ces informations restent dans des fichiers que vous pouvez relire, corriger et enrichir. Avec Claude Code en entreprise, chaque collaborateur qui ouvre le dossier part donc des mêmes règles.
Rien n’est entraîné : le modèle d’IA reste le même pour tout le monde, et seules les lectures préalables diffèrent d’une entreprise à l’autre. Un deuxième cerveau se construit donc avec des fichiers courts, rangés par sujet, que Claude retrouve facilement.
Chez Story B, ce système de mémoire suit une architecture modulaire en six couches :
| Couche | Fichiers chez Story B | Rôle |
|---|---|---|
| 1. Le chef d’orchestre | CLAUDE.md, status.md | Les règles, l’endroit où trouver chaque information, les chantiers en cours |
| 2. L’identité | Dossier identite/ : positionnement, personas, voix, formulations, offres, preuves, objections | Qui vous êtes, à qui vous parlez, comment vous le dites |
| 3. La charte | Dossier design-system/ : couleurs, polices, logos, photos | Des visuels aux couleurs de la marque |
| 4. Les savoir-faire | 23 skills : rédiger un article, un post, un audit… | Les procédures, écrites une fois |
| 5. Les canaux | Règles de LinkedIn, Instagram, fiche Google, site | Les codes de chaque plateforme |
| 6. La mémoire | Mémoire automatique, apprentissages.md, historique de chaque contenu | Ce que l’IA apprend de vos corrections |
Organisation de notre dossier de travail au 18 novembre 2026.

Que mettre dans CLAUDE.md pour une entreprise ?
Pour une entreprise, CLAUDE.md contient ses règles générales et indique où se trouve chaque information : il sert de sommaire au deuxième cerveau. Anthropic recommande de viser moins de 200 lignes par fichier CLAUDE.md, car un fichier plus long occupe plus de place dans la fenêtre de contexte et ses instructions sont moins bien suivies. Pour optimiser le contexte, le plus simple est de choisir ce qui doit être lu à chaque session et de renvoyer le reste vers d’autres fichiers. Le nôtre compte 138 lignes pour faire tourner toute l’agence.
Pour rester court, notre CLAUDE.md suit un principe simple : une information vit dans un seul fichier. La voix de la marque et les règles de LinkedIn ont chacune leur fichier, et CLAUDE.md indique lequel lire pour chaque tâche. En voici une version simplifiée, réécrite pour l’article (le vrai fichier compte 138 lignes) :
# Story B
Agence Web & IA à Bordeaux : sites WordPress sur mesure,
SEO, SEA et email pour les TPE et PME.
## Où trouver quoi
- Qui nous sommes et nos offres : identite/noyau.md, identite/offres.md
- Notre ton et nos mots interdits : identite/voice.md
- Nos couleurs et nos polices : design-system/tokens.json
- Comment écrire un article de blog : le skill article-blog
## Règles
- Vouvoyer le lecteur, phrases courtes.
- Aucun chiffre sans source.
- Ne jamais afficher les clés du fichier .env.
Un CLAUDE.md d’entreprise efficace contient, dans cet ordre :
- Une phrase sur l’activité : ce que fait l’entreprise et pour qui.
- Le routage : quel fichier lire pour quelle tâche (un article, un devis, un post).
- L’ordre de priorité entre les sources, pour trancher les contradictions. Chez nous, la voix de la marque l’emporte sur les règles d’un canal, qui l’emportent sur une procédure.
- Les règles de rigueur : par exemple, aucun chiffre sans source, et les fichiers bruts ne sont jamais modifiés.
- Les règles de sécurité : où se trouvent les clés d’accès et les données sensibles, et l’interdiction de les afficher.
- Les conventions de style : l’écriture des prix, des dates, des titres, des noms de marques.
- La structure des dossiers : où ranger les brouillons, les visuels, les exports, pour que chaque flux de travail retrouve ses fichiers.
Pour ne pas tout mettre dans un seul fichier, CLAUDE.md peut en importer d’autres avec la syntaxe @chemin/du/fichier. Par exemple, cette ligne placée dans CLAUDE.md charge le fichier de voix au début de chaque session :
@identite/voice.md
Parmi les meilleures pratiques de la documentation d’Anthropic, un repère aide à savoir quand compléter le fichier : quand Claude fait la même erreur une deuxième fois, quand vous tapez la même correction qu’à la session précédente, ou quand un nouveau membre de l’équipe aurait besoin de la même explication.
Un deuxième cerveau IA formé à votre entreprise
Nous construisons avec vous les fichiers qui apprennent votre voix, vos offres et votre charte à Claude Code.
Comment mettre votre identité et votre voix dans CLAUDE.md ?
En les écrivant dans des fichiers dédiés que CLAUDE.md désigne, un sujet par fichier : votre positionnement, vos clients types, votre ton, vos formules validées. Chez Story B, le dossier identite/ compte neuf éléments, des fichiers Markdown d’environ 900 lignes au total :
| Fichier | Ce qu’il contient |
|---|---|
| noyau.md | Le positionnement, les différences avec les concurrents, les promesses interdites |
| personas.md | Les clients types, leurs problèmes dans leurs propres mots, leurs objections |
| voice.md | Le ton, les pronoms selon le support, les mots et tournures interdits |
| formulations.md | Les phrases validées à reprendre telles quelles : signatures, accroches, baseline |
| offres.md, preuves.md, objections.md, concurrence.md | Les prestations et leurs prix, les résultats chiffrés, les réponses aux doutes, le marché |
| cas-clients/ | Un fichier par réalisation, avec ses chiffres |
Le fichier le plus utile au quotidien est celui de la voix. Il décrit le ton avec des règles permanentes et vérifiables, que Claude peut contrôler phrase par phrase. Extrait de notre voice.md :
- Site et supports de l'agence : « nous ». Exception : la page À propos est au « je ».
- LinkedIn : « vous » pour les posts d'expertise, « je » pour les posts personnels.
- Vouvoiement systématique de l'audience.
- Pas de cadratin (—) dans les posts LinkedIn, Instagram et articles de blog.
Pour démarrer, trois fichiers suffisent, ce sont les fondamentaux : une présentation de l’activité, un portrait de vos clients et la voix. Les autres viennent avec l’usage. Pensez à leur mise à jour quand une offre ou un prix change.
Comment faire respecter votre charte graphique avec CLAUDE.md ?
En décrivant la charte dans des fichiers lisibles par une machine : les couleurs et les polices avec leurs valeurs exactes, puis les règles d’usage de chaque couleur. Claude Code peut alors produire des visuels en code (pages HTML transformées en images) qui respectent la charte au pixel près, sans passer par un outil de design.
Chez Story B, le dossier design-system/ contient un fichier de configuration des couleurs et des polices (tokens.json, un format standard), les règles des visuels pour les réseaux sociaux, les logos, les photos et les mascottes de la marque. Chaque couleur y est décrite avec son usage. Extrait simplifié :
{
"name": "sb-mint",
"value": "#00ffaa",
"usage": "Mint, accent signature : liens, numéros de cartes, icônes."
}

Sans visuels à produire, un fichier court suffit : vos couleurs en code hexadécimal, vos polices, votre logo et trois exemples de visuels que vous aimez.
Comment l’IA apprend-elle à chaque correction ?
Claude Code tient une mémoire automatique : quand vous le corrigez, exprimez une préférence ou lui demandez de retenir quelque chose, il l’écrit dans un fichier de notes qu’il relit aux sessions suivantes. Ces notes sont rangées dans votre profil, dans un répertoire de mémoire (memory) propre à chaque projet (sous ~/.claude/projects/), avec un index (MEMORY.md) dont les 200 premières lignes sont chargées à chaque session. La commande /memory affiche ces fichiers et permet de les ouvrir pour les relire, les corriger ou supprimer une note devenue fausse.
Un exemple réel : la veille de la publication d’un post, nous avons précisé que le lien de la bio Instagram ne devait pas changer à chaque publication. Claude l’a noté une fois :
Anaïs ne veut pas modifier le lien de sa bio Instagram pour chaque post.
Légende Instagram sans « lien en bio » ; Facebook a sa propre légende, avec un lien dédié, cliquable dans le texte.
Les posts suivants appliquent la règle sans qu’il faille la répéter. La mémoire automatique contient aujourd’hui 10 notes de ce type chez nous. Nous ajoutons deux mémoires écrites à la main :
- apprentissages.md : ce qui marche d’après les statistiques, par exemple le format qui obtient le plus de vues sur LinkedIn.
- brief.md dans le dossier de chaque contenu : les décisions prises, les versions refusées et pourquoi.
La différence entre les deux systèmes est simple : vous écrivez CLAUDE.md, Claude écrit sa mémoire automatique. Quand une note de mémoire devient une règle importante, nous la déplaçons dans le fichier concerné (la voix, la charte, la procédure), pour qu’elle vive au bon endroit.
Faut-il des skills en plus de CLAUDE.md ?
Oui, dès qu’une tâche se répète : CLAUDE.md dit qui vous êtes, un skill dit comment exécuter une tâche précise, du début à la fin : c’est un workflow écrit. Un skill est un fichier de procédure, rédigé en français, que Claude Code charge seulement quand vous l’appelez ou quand il le juge utile. La documentation d’Anthropic conseille d’ailleurs de déplacer vers un skill toute procédure en plusieurs étapes, pour garder CLAUDE.md court.
Chez Story B, 23 skills couvrent la prospection, l’analyse, le cadrage d’un nouveau client et la production de contenus : article de blog, post LinkedIn, légende Instagram, visuel, vidéo. Chaque skill commence par sa recette, la liste des fichiers d’identité et de charte à charger. C’est ce lien qui donne leur cohérence aux contenus : le skill d’article demande de lire voice.md, où se trouve la voix de la marque.
Les skills méritent un guide complet, que nous préparons : comment les écrire, les ranger et les faire évoluer.
Comment créer son CLAUDE.md sans être développeur ?
Pour un non-développeur, le plus simple est de commencer par un dossier, un CLAUDE.md rédigé avec Claude en français et un premier fichier de voix, puis une vraie tâche : votre deuxième cerveau se construit en l’utilisant. S’il vous faut d’abord installer Claude Code sur votre ordinateur, notre tutoriel d’installation de Claude Code sous Windows couvre cette étape.
- Créez un dossier pour votre entreprise, ouvrez-le dans VS Code et lancez Claude Code dedans.
- Demandez CLAUDE.md en français. Collez votre page À propos ou présentez votre activité en quelques lignes, sans aucune configuration technique, puis demandez : crée un CLAUDE.md qui décrit mon entreprise et liste les fichiers d’identité à créer.
- Créez le fichier de voix. Donnez à Claude trois textes que vous avez écrits et que vous aimez, et demandez-lui d’en tirer des règles concrètes : pronoms, longueur des phrases, mots à éviter, conventions d’écriture des prix et des dates.
- Lancez une vraie tâche : un post, un e-mail à un client, une page de votre site.
- Corrigez, et faites noter la correction. À chaque reprise, demandez à Claude d’ajouter la règle au bon fichier, pour ne pas la répéter à la tâche suivante.
Trois erreurs courantes ralentissent les débuts : un CLAUDE.md trop long, des consignes vagues, et la même information recopiée dans plusieurs fichiers, qui finissent par se contredire.
Vos fichiers restent du texte que vous lisez et modifiez vous-même. Si vous changez d’outil d’IA un jour, ce travail d’écriture sur votre entreprise vous suit.
Conclusion
Un fichier CLAUDE.md transforme Claude Code en deuxième cerveau de votre entreprise : il relit vos règles à chaque session, renvoie vers votre identité, votre voix et votre charte, et retient vos corrections. Le plus long est d’écrire ces fichiers une première fois. Si vous préférez que nous construisions avec vous ce deuxième cerveau, nous le faisons avec notre offre d’assistant IA.
Sources
Fonctionnement de CLAUDE.md et de la mémoire automatique relevé le 18 novembre 2026 dans la documentation officielle de Claude Code. Chiffres de notre organisation (lignes, fichiers, skills, notes de mémoire) relevés le même jour dans notre dossier de travail.
- Anthropic, Comment Claude se souvient de votre projet (CLAUDE.md, emplacements, imports, taille recommandée, mémoire automatique, /memory)
Un deuxième cerveau IA formé à votre entreprise
Nous construisons avec vous les fichiers qui apprennent votre voix, vos offres et votre charte à Claude Code.