Le fichier CLAUDE.md
L'une des fonctionnalités les plus utiles de Claude Code est le fichier CLAUDE.md. Il donne à Claude Code une mémoire persistante de votre projet.
Le problème qu'il résout
Lorsque vous ouvrez Claude Code sans fichier CLAUDE.md, il repart de zéro à chaque fois. Il doit réexplorer votre base de code, déterminer les dépendances nécessaires et comprendre quelles fonctionnalités sont déjà implémentées. Il lui arrive de faire des suppositions, ce qui rend plus difficile le fait de guider Claude dans la bonne direction.
CLAUDE.md résout ce problème. C'est un fichier Markdown que vous ajoutez à la racine de votre projet, et Claude Code le lit automatiquement à chaque démarrage de session. Considérez-le comme un script d'intégration pour votre base de code. Le contenu du fichier CLAUDE.md est ajouté à la fin de votre requête.
Un exemple
Voici à quoi ressemble un fichier CLAUDE.md typique :
# Project
This is a Next.js 15 app using the App Router, Tailwind, and Drizzle ORM.
# Commands
- Dev server: `pnpm dev`
- Run tests: `pnpm test`
- Lint: `pnpm lint`
# Code Style
- Use 2-space indentation
- Prefer named exports
- All API routes go in app/api/
- Use server actions instead of API routes where possibleC'est simple. Maintenant, si vous demandez à Claude Code de créer un composant React, il sait déjà qu'il doit utiliser Tailwind pour le style et suivre vos conventions de code.

CLAUDE.md est fait pour les équipes
Vous pouvez (et devriez) valider votre fichier CLAUDE.md dans le contrôle de version pour que toute votre équipe en bénéficie. Il existe en réalité une hiérarchie de fichiers de mémoire selon à qui ils sont destinés :
-
Le CLAUDE.md au niveau du projet se trouve dans le répertoire racine de votre projet. Partagé avec l'équipe.
-
Le CLAUDE.md au niveau de l'utilisateur se trouve dans votre dossier de configuration. Celui-ci est uniquement pour vous et s'applique à tous vos projets. Placez-y vos préférences personnelles.
Astuces
Enregistrez les corrections en mémoire. Si vous vous surprenez à corriger Claude à répétition — par exemple en lui disant d'toujours utiliser des server actions plutôt que des routes API — demandez explicitement à Claude d'enregistrer cette règle en mémoire. La prochaine fois que vous ouvrirez le projet, il le saura.

Référencez la documentation du projet. Si vous disposez d'une documentation dans votre projet que vous souhaitez que Claude consulte, utilisez le symbole @ suivi du chemin du fichier :
## README.md
Please read if you need more info: @README.mdCommencez sans en avoir un. Nous recommandons de commencer un projet sans fichier CLAUDE.md afin de repérer les moments où vous devez constamment recadrer le modèle. Cela permet de garder votre CLAUDE.md compact et centré uniquement sur les informations nécessaires. Une fois prêt, exécutez /init pour que Claude en génère un pour vous.
Essayez-le maintenant
Choisissez un projet sans CLAUDE.md et exécutez /init. Lisez ce que Claude a écrit et supprimez toute ligne que vous ne prendriez pas la peine de dire à un nouveau coéquipier. Ajoutez une correction que vous vous surprenez à répéter, puis démarrez une nouvelle session et demandez quelque chose que cette correction couvre. Claude l'a-t-il respectée ?
Récapitulatif
La différence entre une session Claude Code frustrante et une session productive tient souvent au contexte — et le fichier CLAUDE.md est le moyen de fournir ce contexte. Commencez par votre stack technique, vos préférences et vos commandes, puis développez à partir de là au fil du temps.