Bien parler à Claude Code : contexte, CLAUDE.md et instructions qui changent tout

Vous avez testé Claude Code quelques jours. Le code fonctionne, mais les noms de fichiers ne suivent pas vos conventions, les textes produits n'ont pas votre style, et vous passez votre temps à corriger. Vous vous demandez si l'outil est vraiment fait pour vous.

En bref : quand Claude Code déçoit, c'est le plus souvent parce qu'il manque de contexte. Le fichier CLAUDE.md, chargé au début de chaque session, sert à lui donner une fois pour toutes votre projet, vos conventions et vos interdits. Des instructions précises, courtes et cohérentes entre elles sont mieux suivies que de longues consignes vagues.

Mise à jour : octobre 2026

Pourquoi vos premiers résultats déçoivent-ils ?

Parce que l'outil ne sait rien de vous. Si vous ne lui dites pas qui vous êtes, ce que vous construisez et quelles règles vous respectez, il comble les blancs avec des choix génériques. Le résultat est correct, mais étranger à votre façon de travailler.

La documentation d'Anthropic propose une image utile : considérer Claude comme un nouvel employé brillant qui ne connaît pas encore vos usages. Imaginez écrire à un développeur indépendant : « Faites-moi un formulaire de contact », sans lui donner votre environnement technique, votre charte graphique ni vos contraintes légales. Il produira quelque chose, mais pas ce que vous vouliez. Si vous découvrez l'outil, commencez par qu'est-ce que Claude Code ?

Qu'est-ce que le fichier CLAUDE.md ?

C'est un fichier texte d'instructions que Claude Code lit au début de chaque session. Selon la documentation officielle, chaque session démarre avec une mémoire vierge, et le CLAUDE.md fait partie des mécanismes qui transportent vos consignes d'une session à l'autre. Il peut se placer à plusieurs niveaux :

Pour démarrer, la commande /init génère un premier CLAUDE.md à partir de l'analyse de votre projet ; vous l'affinez ensuite avec ce que l'outil ne peut pas deviner. Un CLAUDE.md peut aussi importer d'autres fichiers avec la syntaxe @chemin/du/fichier.

Ce fichier n'est pas réservé aux développeurs. Un dirigeant ou un opérationnel peut le rédiger : l'enjeu est de donner les bonnes informations.

Que mettre dans un bon CLAUDE.md ?

1. Le contexte du projet : qui vous êtes, l'objectif, le public visé.
2. Les conventions techniques : langage, framework, structure des dossiers, nommage.
3. Les règles de style : langue des commentaires, gestion des erreurs, registre des textes.
4. Les interdits explicites : ce que Claude ne doit jamais faire dans ce projet.
5. Le niveau de détail attendu : réponses courtes orientées action ou explications pédagogiques.

Exemple, pour une agence qui utilise Claude Code afin de produire des fiches produit :

Projet : génération de fiches produit pour un e-commerce alimentaire breton.
Langue : français, style chaleureux et local, sans jargon marketing.
Structure imposée : titre, accroche de 2 phrases, liste de 5 bénéfices, appel à l'action.
Interdit : aucun superlatif (« le meilleur », « incroyable »).
Format de sortie : Markdown uniquement.

Ces quelques lignes suffisent à cadrer chaque réponse du projet.

Quelles erreurs éviter en le rédigeant ?

• Les consignes vagues : « sois professionnel » n'apporte rien. La documentation recommande des instructions concrètes et vérifiables, par exemple indiquer dans quel dossier vivent les fichiers plutôt que « garder les fichiers organisés ».
• Le fichier trop long : la documentation conseille de viser moins de 200 lignes par fichier ; au-delà, il consomme plus de contexte et les consignes sont moins bien suivies.
• Les contradictions : si deux instructions s'opposent, Claude peut en retenir une arbitrairement. Relisez régulièrement vos fichiers.
• Le fichier jamais mis à jour : votre projet évolue, le CLAUDE.md doit suivre.
• Le confondre avec un verrou : Claude traite le CLAUDE.md comme du contexte, pas comme une configuration imposée. Pour bloquer une action quoi qu'il arrive, la documentation renvoie vers les hooks.

Cette logique de cadrage dépasse Claude Code : c'est le cœur du prompt engineering appliqué à ChatGPT ou Claude.

Comment bien ouvrir chaque session ?

Le CLAUDE.md pose le cadre permanent ; le premier message pose le cadre du jour. Avant votre première demande, rappelez :

• où en est le projet et ce qui a déjà été fait ;
• l'objectif précis de la session ;
• les contraintes propres à cette tâche.

Comment aller plus loin ?

• Découper par dossier : un fichier racine pour les règles globales, un autre dans un sous-dossier pour un module.
• Versionner le CLAUDE.md avec Git pour suivre l'évolution des règles et revenir en arrière.
• Garder un modèle de référence si vous menez plusieurs projets, adapté à chaque nouveau projet.
• Noter le pourquoi des règles : la documentation d'Anthropic indique qu'expliquer la raison d'une consigne aide Claude à mieux viser.

Côté accès, Claude Code est inclus dans les offres payantes de Claude et non dans l'offre gratuite : le détail est dans Claude Code est-il gratuit ?

À lire aussi : Formation Claude Code en entreprise : le programme pour non-développeurs.

Sources

• Documentation Claude Code, How Claude remembers your project (CLAUDE.md)
• Anthropic, Prompting best practices (documentation officielle)
• Documentation Claude Code, vue d'ensemble

Article rédigé par Aurélien Page, fondateur d'Audiaa, agence IA et No Code à Rennes.