CLAUDE.md est un simple fichier texte, placé dans le dossier d’un projet, que Claude Code lit au début de chaque séance de travail. Chaque séance démarre en effet sur une conversation vierge : ce fichier sert de mémoire écrite, pour que Claude retrouve à chaque fois les règles que vous lui avez données. Claude Code prend aussi ses propres notes au fil du travail, mais CLAUDE.md reste le fichier que vous gardez sous contrôle.

On y note ce que Claude doit toujours savoir sur le projet :

  • à quoi sert l’outil et pour qui ;
  • les règles métier, par exemple « les jours fériés ne comptent pas dans les congés » ;
  • les préférences, comme des écrans entièrement en français ;
  • ce qu’il ne doit jamais faire.

Vous n’avez pas besoin de l’écrire vous-même. Demandez à Claude de noter les règles importantes dans CLAUDE.md, ou tapez /init pour qu’il en prépare une première version. Relisez-le de temps en temps : c’est un bon résumé de votre projet. Codex et plusieurs autres agents suivent le même principe avec un fichier appelé AGENTS.md, que Claude Code sait aussi lire.

Deux erreurs à éviter. D’abord, un fichier trop long : plus il est court et précis, mieux Claude le suit. Ensuite, y écrire des mots de passe ou des codes d’accès, car ce fichier voyage avec le reste du projet. Gardez enfin en tête que ce sont des indications pour l’IA, pas des verrous : une règle de sécurité doit aussi être appliquée par l’outil lui-même.

Exemple

Pour l’outil de planning des astreintes de son équipe, Franck, responsable maintenance dans une usine, a demandé à Claude Code d’écrire les règles de rotation dans CLAUDE.md ; à chaque nouvelle demande, Claude les respecte sans qu’il ait à les rappeler.