Chaque session de Claude Code démarre de zéro : il ne se souvient pas d'hier. Le fichier CLAUDE.md compense cela. C'est le briefing que vous donneriez à un collaborateur le premier jour, sauf qu'il le relit intégralement à chaque session. Tout ce que vous y écrivez devient une consigne permanente.
Ce briefing existe à deux niveaux : la distinction à retenir.
Le niveau global vit dans .claude à la racine de votre espace personnel, le même quel que soit le projet : vos consignes de fond (langue, contexte métier, niveau technique).
Le niveau projet est un fichier CLAUDE.md à la racine du projet, qui ne s'applique que là : ce que c'est, comment c'est organisé, ce qu'il ne faut pas toucher.
Les deux se cumulent : Claude lit d'abord le global, puis celui du projet.
Vous croiserez aussi un dossier .claude dans vos projets, sa boîte à réglages : pas besoin d'y entrer, juste de ne pas le supprimer en rangeant.
Voici à quoi pourrait ressembler votre CLAUDE.md global de non-développeur. 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.Le plus beau : pas besoin de créer ces fichiers à la main. Demandez à Claude, en session : « Crée mon CLAUDE.md global avec les consignes suivantes... ». Pour le niveau projet, /init lui demande d'examiner le dossier et de rédiger un premier CLAUDE.md tout seul. /memory ouvre ces fichiers à tout moment.
Prenez l'habitude d'enrichir votre briefing au fil de l'eau : chaque consigne répétée d'une session à l'autre a sa place dans un CLAUDE.md.