Articles
OutilsPar Kemy Guerouine12 novembre 20266 min de lecture

C'est quoi CLAUDE.md, et comment l'écrire quand on débute ?

CLAUDE.md est un fichier texte que Claude Code lit à chaque session. Lance /init, relis le résultat et ajoute des consignes courtes, sous 200 lignes.

En clair, en 30 secondes

  • CLAUDE.md est un fichier texte que tu écris une fois. Claude Code le lit au début de chaque session, donc tu n'as plus à répéter tes consignes [1] [3].
  • Pour en obtenir un, lance /init dans ton dossier de projet : Claude Code analyse le dossier et écrit un premier fichier, que tu relis ensuite [1] [2].
  • Garde-le court (moins de 200 lignes) et concret. Claude le lit comme du contexte, ce n'est pas une règle qu'il est obligé d'appliquer [1].

CLAUDE.md est un fichier au format markdown, placé dans ton dossier de projet, où tu notes ce que Claude Code doit savoir à chaque session. Quand tu débutes, le plus simple est de taper /init, de relire le résultat, puis d'ajouter quelques consignes courtes écrites avec tes mots.

En bref

  • Ce que c'est : un fichier de texte brut que Claude lit au début de chaque session. Sans lui, chaque session démarre avec un contexte vide [1].
  • Où le mettre : CLAUDE.md à la racine du projet pour le projet, ~/.claude/CLAUDE.md pour tes préférences sur tous tes projets [1].
  • Comment l'écrire : des phrases assez précises pour qu'on puisse vérifier si Claude les a suivies, et moins de 200 lignes [1].

Pourquoi un fichier de consignes ?

Chaque session de Claude Code commence avec une fenêtre de contexte vierge. Rien de ce que tu as dit hier n'est connu aujourd'hui, sauf ce que tu as écrit dans un fichier que Claude relit [1].

La documentation officielle décrit CLAUDE.md comme l'endroit où noter ce que tu devrais sinon réexpliquer. Elle conseille d'y ajouter une ligne dans deux cas qui parlent à un débutant : Claude refait la même erreur une deuxième fois, ou tu retapes la même correction que la session précédente [1].

Où ranger le fichier

PortéeEmplacementPour qui
Projet./CLAUDE.md ou ./.claude/CLAUDE.mdToi, et l'équipe si le projet est partagé
Toi, sur tous tes projets~/.claude/CLAUDE.mdToi seul
Toi, sur ce projet seulement./CLAUDE.local.mdToi seul, à ajouter au fichier .gitignore si tu utilises Git

Source : [1]. Le ./ veut dire « dans le dossier où tu lances Claude Code ». Pour un premier essai, prends le premier : CLAUDE.md à la racine de ton dossier de test.

Créer ton premier CLAUDE.md, pas à pas

  1. Ouvre Claude Code dans le dossier de ton projet. Si ce n'est pas encore fait, le pas à pas est dans Comment installer Claude Code dans VS Code quand on débute ?.
  2. Tape /init. Claude Code analyse le dossier et crée un fichier avec les commandes de build, les instructions de test et les conventions qu'il découvre. Si un CLAUDE.md existe déjà, /init propose des améliorations au lieu de l'écraser [1] [2]. Dans l'application de bureau, tu peux aussi écrire dans la zone de message « Create a CLAUDE.md with instructions for this codebase » [5].
  3. Ouvre le fichier avec /memory. La commande liste tes fichiers CLAUDE.md, y compris ceux qui n'existent pas encore. Quand tu en choisis un qui n'existe pas, Claude Code le crée, puis tu l'ouvres dans ton éditeur [1] [2].
  4. Relis le texte et ajoute trois à cinq consignes à toi (voir plus bas).
  5. Vérifie que le fichier est bien chargé : lance /context all et cherche-le dans la liste « Memory files ». Si le fichier n'y est pas, Claude ne peut pas le voir [1].

Tu peux aussi laisser Claude faire : demande-lui directement « ajoute ceci à CLAUDE.md », suivi de ta consigne [1].

Comment écrire de bonnes consignes

La documentation donne la règle : écris des instructions assez concrètes pour être vérifiées. Ses exemples, traduits ici :

Trop vagueConcret
Formate bien le codeUtilise 2 espaces d'indentation
Teste tes changementsLance npm test avant de valider
Garde les fichiers rangésLes gestionnaires d'API sont dans src/api/handlers/

Source : [1]. Voici un exemple de CLAUDE.md pour un tout premier projet de page web. C'est une illustration à adapter, pas un modèle officiel :

```markdown

Ma page de présentation

  • Le site tient en une page : index.html, avec style.css à côté.
  • Écris en français et tutoie-moi.
  • Avant de modifier un fichier, dis-moi en une phrase ce que tu vas changer.
  • Ne supprime aucun fichier sans me le demander.

```

Trois habitudes à prendre, toujours d'après la documentation [1] :

  • Reste sous 200 lignes. Un fichier plus long consomme plus de contexte et Claude le suit moins bien.
  • Range les consignes sous des titres et des puces, plutôt que dans de gros paragraphes.
  • Relis le fichier de temps en temps. Si deux consignes se contredisent, Claude peut en choisir une au hasard.

Pour laisser une note à toi-même sans que Claude la lise, la documentation indique que les commentaires HTML de bloc (<!-- note -->) sont retirés avant l'envoi à Claude [1].

Ce que CLAUDE.md ne fait pas

  • Il n'oblige pas. La documentation précise que Claude lit ces fichiers comme du contexte, pas comme une configuration appliquée de force. Pour bloquer une action quoi qu'il arrive, elle renvoie vers les hooks, un sujet pour plus tard [1].
  • Il n'est pas fait pour les longues procédures. Une marche à suivre en plusieurs étapes, ou une règle qui ne sert que pour une partie du projet, vaut mieux dans un skill [1] [4]. Notre article C'est quoi un skill dans Claude Code ? explique la différence.
  • Il n'est pas la mémoire automatique. Celle-ci, ce sont des notes que Claude écrit lui-même à partir de tes corrections. Tu peux l'activer ou la couper depuis /memory [1].

Pour mettre tout cela en pratique, le module 1 du kit débutant est gratuit et sans compte. Pour la suite, la page Kit débutant montre le parcours complet.

Questions fréquentes

CLAUDE.md et AGENTS.md, c'est la même chose ?

Presque. Si un projet contient déjà un fichier AGENTS.md écrit pour d'autres assistants de code, Claude Code peut le lire à la place d'un CLAUDE.md [1] [3].

Quelle est la différence avec la mémoire automatique ?

CLAUDE.md, c'est toi qui l'écris : instructions et règles. La mémoire automatique, c'est Claude qui l'écrit : ce qu'il retient de tes corrections. Les deux sont chargées au début de chaque conversation [1].

Comment savoir si Claude lit bien mon fichier ?

Lance /context all et regarde la liste « Memory files ». Tu peux aussi ouvrir /memory, qui liste les fichiers de mémoire de tes projets [1].

Sources

Pages consultées le 12 novembre 2026.

[1] Anthropic. How Claude remembers your project, sections CLAUDE.md vs auto memory, CLAUDE.md files, Choose where to put CLAUDE.md files, Set up a project CLAUDE.md, Write effective instructions, Import additional files et View and edit with /memory. Claude Code Docs. https://code.claude.com/docs/en/memory

[2] Anthropic. Commands, entrées /init et /memory. Claude Code Docs. https://code.claude.com/docs/en/commands

[3] Anthropic. Overview, section What you can do (Customize with instructions, skills, and hooks). Claude Code Docs. https://code.claude.com/docs/en/overview

[4] Anthropic. Manage costs effectively, section Move instructions from CLAUDE.md to skills. Claude Code Docs. https://code.claude.com/docs/en/costs

[5] Anthropic. Get started with the desktop app, section Start your first session. Claude Code Docs. https://code.claude.com/docs/en/desktop-quickstart

Par Kemy Guerouine, le 12 novembre 2026. Cet article a été rédigé pour Formez-vous à l'IA (FVIA).