CLAUDE.md : le fichier de consignes de Claude Code expliqué

À quoi sert le fichier CLAUDE.md ?

Imaginez qu'un collaborateur compétent arrive chaque matin sans aucun souvenir de la veille. Vous lui laisseriez une note sur le bureau : qui est le client, quel ton employer, ce qu'il ne faut surtout pas toucher. CLAUDE.md est exactement cette note.

C'est un fichier texte ordinaire, écrit en français, que Claude Code lit au début de chaque session. Tout ce qui s'y trouve s'applique à toutes vos demandes, sans que vous ayez à le répéter. Vous écrivez une fois « vouvoiement dans tous les textes » ou « ne jamais inventer d'avis client », et la règle tient pour toutes les séances suivantes.

Le nom s'écrit en majuscules, suivi de « .md », l'extension des fichiers au format Markdown : un format de texte très simple où un dièse en début de ligne marque un titre et un tiret marque un élément de liste. Aucune connaissance technique n'est nécessaire pour le lire ou le modifier.

Où placer le fichier CLAUDE.md ?

Il existe deux emplacements, qui se complètent.

Le signe ~ désigne votre dossier personnel d'utilisateur sur l'ordinateur. Dans la pratique, commencez par le fichier du projet : c'est lui qui fait la différence. Le fichier général viendra plus tard, quand vous aurez repéré les préférences qui reviennent d'un projet à l'autre.

Comment créer et modifier son CLAUDE.md

Trois façons de faire, de la plus automatique à la plus libre :

1. Tapez /init dans Claude Code : il étudie le dossier et propose un CLAUDE.md adapté au projet. C'est la bonne méthode pour un dossier qui contient déjà un site.
2. Demandez-le en français, en décrivant votre projet. C'est la bonne méthode pour un dossier vide.
3. Ouvrez le fichier avec n'importe quel éditeur de texte et écrivez-le vous-même.

Pour le modifier ensuite, tapez /memory, ou demandez simplement à Claude d'ajouter une règle. Voici une demande type pour un projet qui démarre :

Crée le fichier CLAUDE.md de ce projet. Pose-moi d'abord, une par une, les questions nécessaires : nom et activité de l'entreprise, public visé, ton souhaité, pages prévues, règles à ne jamais enfreindre, informations pratiques (adresse, horaires, contact). Rédige ensuite le fichier en phrases courtes, en français, avec des intertitres clairs, et montre-le-moi avant de l'enregistrer.

Que mettre dans un CLAUDE.md ?

Un bon fichier de consignes répond à six questions :

• Le projet : de quoi s'agit-il, pour quelle entreprise, avec quelle technique.
• Le public : à qui s'adressent les pages, avec quel niveau de langage.
• Le ton : vouvoiement ou tutoiement, style, mots à éviter.
• Les règles intouchables : ce que Claude ne doit jamais faire sans votre accord.
• Les informations de référence : adresse, horaires, contact, que Claude reprendra sans les réinventer.
• La méthode : demander un plan avant les grosses modifications, vérifier sur téléphone, résumer ce qui a changé.

Modèle complet pour le site d'un commerçant

Voici un modèle à copier puis à adapter. Il concerne une épicerie fine fictive ; remplacez chaque information par la vôtre et supprimez ce qui ne vous concerne pas.

# Consignes permanentes : site de « Lenoir Épicerie fine »

## Le projet
Site vitrine de Lenoir Épicerie fine, épicerie indépendante à Tours.
Pages : accueil, nos produits, nos producteurs, venir à la boutique, contact,
mentions légales, politique de confidentialité.
Site en HTML et CSS simples, en français, sans outil à installer.

## Le public
Habitants de Tours et des environs, de tous âges, souvent sur téléphone.
Phrases courtes, vocabulaire courant, aucun jargon.

## Le ton
- Vouvoiement dans tous les textes.
- Chaleureux et précis, jamais racoleur.
- Pas de superlatifs gratuits (« le meilleur », « unique en France »).

## Règles à ne jamais enfreindre
- Ne jamais inventer de chiffre, d'avis client, de label, de récompense
  ou de provenance. Si une information manque, écrire [À COMPLÉTER]
  et me le signaler.
- Ne jamais supprimer un fichier sans mon accord explicite.
- Ne jamais changer l'adresse d'une page déjà en ligne sans me demander.
- Ne jamais écrire de mot de passe, de clé ou de code d'accès dans
  les fichiers du projet.
- Ne pas ajouter de service extérieur (statistiques, carte, polices,
  réseaux sociaux) sans mon accord : chacun concerne la vie privée
  des visiteurs.
- Ne jamais modifier les photos d'origine : travailler sur des copies.

## Informations de référence
- Adresse : [À COMPLÉTER]
- Horaires : du mardi au samedi, de 9 h 30 à 19 h ; dimanche de 9 h à 13 h.
- Téléphone : [À COMPLÉTER]
- E-mail de contact : [À COMPLÉTER]

## Style visuel
- Couleurs : bordeaux profond et crème.
- Texte très lisible, contrastes suffisants, boutons faciles à toucher.
- Chaque page doit être parfaite sur téléphone avant de l'être sur ordinateur.

## Méthode de travail
- Pour toute modification qui touche plus d'une page, proposer un plan
  et attendre ma validation.
- Après chaque modification, vérifier l'affichage sur téléphone et sur
  ordinateur, et vérifier que tous les liens fonctionnent.
- Terminer chaque tâche par un résumé en français simple de ce qui a changé.
- Me poser une question plutôt que de deviner.

Ce modèle tient sur une page, et c'est voulu : Claude applique mieux dix règles claires que cinquante règles diluées.

Les erreurs fréquentes

• Un fichier trop long. Au-delà de l'essentiel, les règles importantes se perdent dans la masse. Gardez ce qui sert à chaque séance.
• Des consignes vagues. « Fais un beau site » ne guide rien. « Contrastes suffisants, boutons faciles à toucher sur téléphone » se vérifie.
• Des règles contradictoires. « Textes courts » en haut, « textes détaillés » plus bas : Claude devra choisir à votre place. Relisez le fichier d'une traite.
• Des secrets dans le fichier. Le CLAUDE.md du projet peut être partagé : aucun mot de passe, aucune clé d'accès, aucune donnée personnelle de client.
• Des tâches ponctuelles. « Corriger le titre de la page Contact » relève d'une demande, pas d'une consigne permanente.
• Un fichier jamais mis à jour. Quand vous répétez la même remarque deux fois, ajoutez-la au fichier avec /memory. Quand une règle ne sert plus, retirez-la.

Pour les tâches qui reviennent avec une procédure précise, comme rédiger une fiche produit selon un gabarit, une Skill est souvent plus adaptée qu'un CLAUDE.md : voir Les Skills de Claude. Pour passer du fichier de consignes à un site complet, lisez Créer un site vitrine. La liste des commandes citées ici se trouve dans l'aide-mémoire des commandes, et le guide Le mode plan de Claude Code montre comment faire respecter la règle « plan d'abord ».

Pour aller plus loin : le parcours Claude Code sans coder.