Chapitre 3 · Le contexte et la mémoire
CLAUDE.md : la mémoire que tu écris
Suis cette formation dans ton espace : ta progression est gardée, et la communauté répond à tes questions.
Suivre gratuitementCe qu'il doit savoir à chaque fois
Le pourquoi
D'après la documentation, chaque session de Claude Code commence avec un contexte vide. Deux mécanismes transportent des connaissances d'une session à l'autre :
- CLAUDE.md : un fichier d'instructions que tu écris ;
- la mémoire automatique : des notes que Claude prend lui-même à partir de tes corrections et de tes préférences. Elle est activée par défaut en local, et tu la gères avec
/memory.
Les deux sont chargés au début de chaque conversation. Une esthéticienne qui écrit une fois dans son CLAUDE.md « tutoiement, ton chaleureux, jamais de promesse de résultat sur la peau » n'a plus à le répéter à chaque nouvelle conversation.
Le comment : où le ranger
CLAUDE.mdà la racine de ton projet : les règles de ce projet.~/.claude/CLAUDE.md: tes préférences pour tous tes projets. Le signe~désigne ton dossier personnel (C:\Users\[ton nom]sur Windows,/Users/[ton nom]sur Mac).CLAUDE.local.mdà la racine du projet : tes notes personnelles sur ce projet, à ne pas partager (ajoute-le au.gitignore, la liste des fichiers que Git ne doit pas enregistrer).
Le comment : le créer
- Tape
/init. Claude analyse ton dossier et rédige un premier CLAUDE.md. S'il en existe déjà un, il propose des améliorations au lieu de l'écraser. - Complète avec ce qu'il ne peut pas deviner : ton public, ton ton, tes interdits, la façon de vérifier un résultat.
- Tape
/memorypour l'ouvrir et le modifier, et/contextpour vérifier qu'il est chargé.
Ce que recommande la documentation
- Court : moins de 200 lignes par fichier. Plus il est long, plus il consomme de contexte et moins il est suivi.
- Seulement ce qu'il ne peut pas trouver seul. Pas besoin de décrire l'organisation de tes dossiers : il les lit.
- Précis : « phrases de 15 mots maximum » plutôt que « écris bien ».
Un point important : la documentation précise que Claude traite CLAUDE.md comme du contexte, pas comme une règle imposée. Il le suit presque toujours, mais pas avec une garantie absolue. Pour ce qui ne doit jamais arriver (lire ton .env), utilise une règle deny (leçon 4).
Exemple à copier : un modèle de départ
# Projet : [nom du projet]
## Qui je suis
[Ton métier, ta ville, ce que tu proposes, en 2 lignes.]
## Mon public
[Qui sont tes clients, comment ils te trouvent.]
## Ton et style
- Tutoiement, phrases courtes, ton [chaleureux / direct / expert].
- Aucun chiffre, avis client ou résultat inventé : mets [à compléter].
## Règles de travail
- Mode plan pour toute tâche qui touche plusieurs fichiers.
- Après chaque étape validée, un commit avec un message clair en français.
- Pour vérifier une page : [comment tu veux qu'il vérifie, ex. aperçu en largeur téléphone].
## Sécurité
- Les clés et mots de passe vivent dans .env, jamais envoyé sur Git.
- Demande-moi toujours avant de publier, d'envoyer ou de supprimer quoi que ce soit.
Les erreurs à éviter
- Un CLAUDE.md de 400 lignes. Les règles importantes s'y noient.
- Ajouter « IMPORTANT » partout. Si une ligne est ignorée, la documentation explique que c'est souvent que le fichier est trop long, ou que c'est une règle sans exception, à confier à un réglage (une règle deny, ou un « hook », un script que Claude Code lance automatiquement).
- Y mettre une clé ou un mot de passe. Jamais.
À toi de jouer
Tape /init dans ton projet. Lis ce qu'il propose, puis complète avec le modèle ci-dessus (ton public, ton ton, tes deux règles de sécurité). Tape /clear, puis /context : vérifie que ton CLAUDE.md apparaît. Enfin, demande-lui « résume-moi les règles de ce projet » : s'il les retrouve sans que tu les répètes, ta mémoire fonctionne.