Un fichier CLAUDE.md pour que Claude connaisse votre activité

Outil

Claude Code

Prix

Inclus dans un abonnement Claude payant

Temps

15 min

Niveau

Débutant

Chaque session de Claude Code démarre sans souvenir de la précédente. Le fichier CLAUDE.md sert de mémoire écrite : la documentation d'Anthropic conseille d'y noter tout ce que vous auriez sinon à réexpliquer. Pour un indépendant, ce n'est pas que du code : votre offre, votre façon de nommer les devis, le ton de vos mails clients, ce qui demande votre accord.

Où placer le fichier

• CLAUDE.md à la racine du dossier de travail (par exemple le dossier de votre activité) : les règles de ce dossier.
• ~/.claude/CLAUDE.md : vos préférences personnelles, valables dans tous vos dossiers.
• CLAUDE.local.md : des notes privées pour ce dossier seulement, à exclure du partage (fichier .gitignore si le dossier est sur GitHub).

Créer la première version

1. Ouvrir Claude Code dans le dossierDans le Terminal, placez-vous dans le dossier de votre activité et lancez Claude Code.

   TerminalCopier

   cd ~/Documents/mon-activite
   claude

2. Générer un brouillon avec /initClaude parcourt le dossier et propose un CLAUDE.md de départ. S'il en existe déjà un, il suggère des améliorations au lieu de l'écraser.

   Claude CodeCopier

   /init

3. Ajouter ce que Claude ne peut pas devinerOuvrez le fichier avec la commande /memory et complétez-le. Voici un modèle à adapter, à remplir avec vos propres informations :

   CLAUDE.mdCopier

   # Mon activité
   
   ## Qui je suis
   - [Prénom], indépendant en [métier], clients : [type de clients].
   - Offre et tarifs : voir @offre.md
   
   ## Ton
   - Réponses en français, courtes, sans jargon.
   - Documents clients : vouvoiement, sans emoji.
   
   ## Où ranger quoi
   - Devis : devis/ (nom : DEV-AAAA-NNN_Client.md)
   - Factures : factures/ (une facture émise ne se modifie jamais)
   - Un dossier par client : clients/<nom-du-client>/
   
   ## Toujours demander avant
   - Envoyer un mail, publier, facturer, supprimer un fichier.
   
   ## Jamais
   - Écrire un mot de passe, une clé ou un IBAN dans un fichier.
   - Inventer une information légale : écrire [INFO MANQUANTE].

4. Vérifier qu'il est bien chargéLa commande /context affiche la liste des fichiers mémoire chargés dans la session. Si le vôtre n'y est pas, Claude ne le voit pas.

   Claude CodeCopier

   /context

Les règles qui font la différence

• Concret et vérifiable. « Devis dans devis/, numérotés DEV-AAAA-NNN » fonctionne mieux que « sois organisé ».
• Court. Anthropic recommande moins de 200 lignes par fichier : au-delà, il prend plus de place et il est moins bien suivi.
• Sans contradiction. Si deux consignes se contredisent, Claude peut en choisir une au hasard. Relisez le fichier de temps en temps.
• Importer plutôt que tout copier. La syntaxe @chemin/fichier.md charge un autre fichier (votre offre, votre grille tarifaire). Attention, il compte quand même dans la place utilisée.
• L'enrichir au fil de l'eau. Quand Claude fait deux fois la même erreur, ajoutez une ligne.

À savoir. CLAUDE.md est une consigne, pas un verrou : Claude la suit en général, sans garantie. Pour bloquer vraiment une action, Claude Code propose des réglages de permissions et des « hooks » (scripts qui s'exécutent avant une action). Et n'y mettez jamais de mot de passe ni de clé API : ce fichier est du texte lisible, souvent partagé.

Sources

• Documentation Claude Code : How Claude remembers your project
• Documentation Claude Code : Quickstart (installation et abonnements)

Vous voulez aller plus loin, avec un agent qui prépare vos devis ou vos relances à partir de ces règles ? C'est ce que je construis dans mes agents IA.