Skip to content
Floskool

Chapter 2 · Chapitre 2 · Découvrir CLAUDE.md

2.2 Où placer CLAUDE.md ?

Free lesson 6 minGroup Claude Code & IA

Follow this course in your space: your progress is saved, and the community answers your questions.

Follow for free

Où placer CLAUDE.md : quatre emplacements

Il y a plusieurs emplacements possibles, et chacun a un rôle précis. Choisir le bon, c'est éviter que tes préférences perso se retrouvent chez tes collaborateurs, ou que tes règles de projet te suivent partout.

Les quatre emplacements à connaître

1. Le fichier personnel : ~/.claude/CLAUDE.md

  • Pour qui : toi, dans tous tes projets.
  • Pour quoi : tes préférences personnelles (langue, ton, façon de travailler).
  • Partagé ? Non.
  • Exemple : « Réponds en français. Explique simplement. Demande avant de supprimer un fichier. »

2. Le fichier du projet : ./CLAUDE.md ou ./.claude/CLAUDE.md

  • Pour qui : le projet, et toutes les personnes qui y travaillent.
  • Pour quoi : règles, conventions, organisation des dossiers.
  • Partagé ? Oui, si le projet est partagé (par exemple avec git, l'outil qui garde l'historique d'un projet).
  • Exemple : « Public : débutants en IA. Vidéos de 40 à 55 secondes. »

3. Le fichier local : ./CLAUDE.local.md

  • Pour qui : toi, dans ce projet uniquement.
  • Pour quoi : tes notes perso qui ne concernent pas les autres.
  • Partagé ? Non : ajoute-le à ton .gitignore (la liste des fichiers que git doit ignorer).
  • Exemple : « Mes rushs sont sur le disque D:. »

4. Le fichier de sous-dossier : ./un-sous-dossier/CLAUDE.md

  • Pour qui : une partie du projet.
  • Pour quoi : des règles qui ne valent que là.
  • Partagé ? Selon le projet.
  • Exemple : site/CLAUDE.md avec « Une seule balise h1 par page. »

~ désigne ton dossier personnel (par exemple C:\Users\toi sur Windows, /Users/toi sur Mac).

Il existe aussi un emplacement géré par les entreprises (règles imposées à tous les postes par le service informatique) : tu n'en auras pas besoin pour un usage personnel.

Et le dossier .claude/rules/ ?

Pour un projet plus gros, tu peux découper tes règles en plusieurs fichiers .md dans .claude/rules/, un sujet par fichier (style.md, securite.md…). Sans précision, ils sont chargés au démarrage comme CLAUDE.md. Avec un en-tête paths (une liste de motifs de chemins), une règle ne se charge que quand Claude travaille sur les fichiers concernés :

---
paths:
  - "site/**/*.html"
---
# Règles pour les pages du site
- Une seule balise h1 par page.

Ici, site/**/*.html veut dire « tous les fichiers .html dans site/ et ses sous-dossiers ». Il existe aussi ~/.claude/rules/ pour des règles personnelles valables dans tous tes projets.

Le cas mes-videos-ia

Voici une installation simple et propre :

~/.claude/CLAUDE.md        Réponds en français, explique simplement.
mes-videos-ia/
  CLAUDE.md                Audience, ton, format des vidéos, dossiers.
  CLAUDE.local.md          Mon dossier de rushs est sur D:.

Pas besoin de plus pour commencer.

Créer le bon fichier avec /memory

La commande /memory liste tes fichiers d'instructions, personnels et de projet, y compris ceux qui n'existent pas encore. Choisis-en un : il s'ouvre dans ton éditeur, et s'il n'existait pas, il est créé. C'est la façon la plus sûre de ne pas se tromper d'emplacement.

Le bon réflexe pour débuter

Commence par un seul fichier : CLAUDE.md à la racine de ton projet. Ajoute le fichier personnel quand tu remarques des préférences que tu répètes dans tous tes projets, et les autres seulement quand tu en ressens le besoin.

Si ça coince

  • Tes préférences perso apparaissent chez un collègue : elles sont dans le CLAUDE.md du projet. Déplace-les dans ~/.claude/CLAUDE.md ou CLAUDE.local.md.
  • Une règle te suit dans tous tes projets alors qu'elle ne devrait pas : elle est dans ~/.claude/CLAUDE.md. Ouvre-le avec /memory et déplace-la dans le bon projet.
  • Ta règle .claude/rules/ avec paths ne s'applique pas : elle se charge seulement quand Claude ouvre un fichier qui correspond au motif. Vérifie le motif et le chemin du fichier.

À retenir

  • ~/.claude/CLAUDE.md : toi, partout.
  • ./CLAUDE.md : le projet, partagé avec l'équipe.
  • ./CLAUDE.local.md : toi, dans ce projet, à mettre dans .gitignore.
  • .claude/rules/ avec paths : des règles qui ne se chargent que pour certains fichiers.
  • Pour débuter, un seul CLAUDE.md à la racine du projet suffit.