Un CLAUDE.md court qui marche (et le Markdown en 5 minutes)

Cette leçon est encore en test : elle s'améliore avec les retours des apprenants. Si quelque chose n'est pas clair, c'est la leçon qu'il faut corriger, pas toi.

À la fin de cette leçon, tu sauras

lire et écrire un fichier Markdown, le format texte que Claude Code lit pour ses consignes ;
écrire un CLAUDE.md d’une page qui change vraiment la façon dont Claude Code travaille avec toi ;
le tester, puis le corriger quand une consigne n’est pas suivie.

Pourquoi ça t’intéresse

Sans CLAUDE.md, tu répètes les mêmes consignes à chaque séance : « tutoie-moi », « demande avant de modifier », « fais court ». Avec lui, tu les écris une fois. C’est le fichier qui fait passer Claude Code d’un assistant générique à ton assistant.

Avant de commencer


Il te faut	Claude Code, ton dossier mon-espace-ia en mode Manuel, et la leçon 1 de ce module
Durée	40 minutes
Coût	Inclus dans ton abonnement

Comprendre en 3 minutes

Le Markdown, le format texte de tes consignes

Un fichier qui finit par .md est un simple fichier texte, lisible par toi comme par l’IA. Quelques signes suffisent pour le mettre en forme :

Tu écris	Tu obtiens
`# Titre`	Un grand titre
`## Partie`	Un titre de partie
`- une idée`	Une ligne de liste à puces
`1. une étape`	Une liste numérotée
`important`	Du texte en gras

C’est tout ce qu’il te faut pour CLAUDE.md. Tu peux l’ouvrir avec n’importe quel éditeur de texte (TextEdit sur Mac, Bloc-notes sur Windows), ou directement dans l’appli Claude.

CLAUDE.md

C’est un fichier nommé exactement CLAUDE.md, posé à la racine de ton dossier de travail. Claude Code le relit au début de chaque session. D’après la documentation (24/10/2026) :

il vaut mieux viser moins de 200 lignes : plus il est long, moins ses consignes sont bien suivies. Pour débuter, une page suffit ;
Claude le lit comme des consignes, pas comme un verrou : tes autorisations en mode Manuel restent ta protection ;
la commande /init peut en proposer un automatiquement, pensé surtout pour les projets de code. Pour ton espace de travail, le modèle de cette leçon est plus adapté.

Ce qu’on met dedans

À propos de moi : 5 lignes maximum, rien de sensible.
Comment on travaille ensemble : tes règles (tutoiement, une étape à la fois, demander avant de modifier).
Début et fin de séance : relire le journal, écrire la page du jour.

Faire ensemble

1Étape 1 : Télécharger le modèle

Télécharge le modèle de CLAUDE.md (dans les ressources ci-dessous) et lis-le : il fait une page, avec les trois parties.

2Étape 2 : Le faire installer par Claude Code

Attention : si tu as installé le kit du module 4, mon-espace-ia contient déjà un CLAUDE.md, avec ta partie « À propos de moi » et les règles de sécurité du kit. Ne le remplace pas sans le comparer.

Dans mon-espace-ia, en mode Manuel, colle le modèle dans la conversation, précédé de :

Voici un modèle de CLAUDE.md. S'il existe déjà un CLAUDE.md à la racine de ce dossier, compare-le avec ce modèle et propose-moi une version qui garde mes lignes « À propos de moi », mon niveau d'accompagnement, mes règles de sécurité et mes consignes de début et de fin de séance ; sinon, crée le fichier avec ce contenu. Montre-moi le fichier complet avant de l'écrire.

Lis le fichier proposé et la demande d’autorisation, puis autorise.

3Étape 3 : Remplir « À propos de moi »

Si ta partie « À propos de moi » est déjà remplie, relis-la et passe à l’étape 4. Sinon :

Pose-moi 3 questions, une par une, pour remplir la partie « À propos de moi » de CLAUDE.md en 5 lignes maximum. Montre-moi les lignes avant de les écrire.

4Étape 4 : Tester

Ouvre une Nouvelle session dans le même dossier, puis écris simplement : « Bonjour ». S’il suit ton CLAUDE.md, il te tutoie, résume ta dernière séance si un journal existe, et te propose une seule chose à faire.

Faire toi-même

Ta règle à toi. Ajoute à CLAUDE.md une règle qui compte pour toi, par exemple « Réponds en 10 lignes maximum », « Propose toujours deux options avant de choisir » ou « Rappelle-moi de vérifier les chiffres ». Ouvre une nouvelle session et vérifie qu’elle est suivie. Si elle ne l’est pas, rends-la plus précise : « 10 lignes maximum » marche mieux que « sois concis ».

Ressources à télécharger

Modèle de CLAUDE.md : une page, prête à adapter.

Vérifier

C’est réussi si :

CLAUDE.md existe à la racine de mon-espace-ia, fait moins d’une page et ne contient rien de sensible ;
dans une nouvelle session, Claude Code applique au moins deux de tes consignes sans que tu les répètes ;
ta règle personnelle est suivie, après une éventuelle correction.

Erreurs fréquentes :

un CLAUDE.md de trois pages, avec des consignes qui se contredisent : garde l’essentiel ;
des consignes vagues (« sois efficace ») : préfère des consignes vérifiables (« 10 lignes maximum ») ;
y écrire des informations sensibles : il est relu et transmis à chaque séance.

Conserver et reprendre

Relis ton CLAUDE.md une fois par mois : supprime ce qui ne sert plus, précise ce qui n’est pas suivi.

Pour aller plus loin

facultatif

La documentation officielle, en anglais : code.claude.com/docs/en/memory (fichiers CLAUDE.md personnels pour tous tes projets, imports, règles par dossier).

Mots nouveaux

4 mots expliqués

Mot	Ce que ça veut dire
Markdown	Une façon d’écrire du texte avec quelques signes (#, -, **) pour faire des titres, des listes et du gras
Fichier .md	Un fichier texte écrit en Markdown
Racine du dossier	Le niveau principal du dossier, hors de tout sous-dossier
/init	Une commande de Claude Code qui propose un CLAUDE.md de départ, surtout pour les projets de code

Points restant à vérifier : le test complet avec un vrai débutant, sur Mac et sur Windows.