Chaque session de Claude Code démarre de zéro : aucun souvenir de la conversation d'hier. CLAUDE.md compense cela, un briefing relu intégralement à chaque démarrage. Tout ce que vous y écrivez devient une consigne permanente, à deux niveaux : c'est la distinction à retenir.
Le niveau global vit dans le dossier .claude à la racine de votre espace personnel, le même quel que soit le projet : consignes de fond, langue de travail, contexte métier, niveau technique.
Le niveau projet est un fichier CLAUDE.md à la racine d'un projet, qui ne s'applique qu'à lui : ce que c'est, comment c'est organisé, ce qu'il ne faut surtout pas toucher.
Les deux se cumulent : Claude lit d'abord votre briefing global, puis celui du projet où il se trouve.
Voici un CLAUDE.md global de non-développeur, en markdown (dièses pour les titres, tirets pour les listes) : pas besoin de le maîtriser pour commencer. Quelques lignes suffisent à changer le confort de travail :
# Qui je suis
Je ne suis pas développeur. Je suis indépendant et j'utilise
Claude Code pour mon activité, pas pour apprendre à coder.
# Comment travailler avec moi
- Réponds toujours en français.
- Explique ce que tu fais en termes simples, sans jargon.
- Avant toute suppression de fichier, demande-moi confirmation
et explique pourquoi c'est nécessaire.
- Quand plusieurs approches existent, propose la plus simple.Côté projet, le briefing décrit le projet et ses règles du jeu plutôt que vous. Pour le même indépendant, le CLAUDE.md du dossier de son site ressemblerait à ceci :
# Ce projet
Mon site vitrine de photographe. Un seul fichier index.html,
les photos sont dans le dossier images/.
# Règles
- Ne jamais renommer, déplacer ni compresser les fichiers
du dossier images/.
- Tous les textes du site sont en français, vouvoiement.
- Les tarifs affichés sont en CHF.Une fois les deux fichiers en place, le cumul devient concret. Dans le dossier du site, Claude répond en français, sans jargon, demande confirmation avant toute suppression (briefing global) et ne touche pas au dossier images/ (briefing projet). Ailleurs, seul le global s'applique.
Pour vérifier que tout est bien lu : demandez « résume les consignes que tu as reçues de mes fichiers CLAUDE.md ». La réponse montre ce que Claude a retenu et révèle les consignes ambiguës à reformuler.
Dernière limite, de bon sens mais qui mérite d'être écrite : un CLAUDE.md n'est pas un coffre-fort. N'y mettez jamais de mot de passe, de clé d'accès ni de données de clients : un simple fichier texte, transmis intégralement à chaque session.
Vous n'avez pas à créer ces fichiers à la main. Demandez à Claude, en session : « Crée mon CLAUDE.md global avec les consignes suivantes... », ou plus simple, « ajoute ça à ta mémoire » quand une consigne mérite de durer. Côté projet, la commande /init demande à Claude d'examiner le dossier et de rédiger un premier CLAUDE.md tout seul. La commande /memory ouvre ces fichiers à tout moment pour les relire ou les compléter.
Deux réflexes entretiennent le briefing dans la durée : répéter la même consigne d'une session à l'autre signale qu'elle a sa place dans un CLAUDE.md ; si Claude en ignore une déjà présente, le bon réflexe est souvent de raccourcir le fichier plutôt que de l'allonger. Le cours Bien commencer avec Claude Code lui consacre une page complète au milieu du parcours.