Ajouter du contexte

Quand vous travaillez avec Claude sur un projet de code, la gestion du contexte est essentielle. Votre projet peut contenir des dizaines ou des centaines de fichiers, mais Claude n’a besoin que des bonnes informations pour vous aider efficacement. Le réflexe intuitif — « donnons-lui tout, il triera » — est précisément le mauvais : trop de contexte non pertinent diminue ses performances. Un dépôt entier chargé pour corriger une fonction de trois lignes noie le signal utile sous du bruit. Savoir guider Claude vers les fichiers et la documentation pertinents est, pour cette raison, la compétence la plus rentable de tout ce cours.

La commande /init

Quand vous lancez Claude pour la première fois dans un nouveau projet, exécutez la commande /init. Claude analyse alors l’ensemble de votre codebase pour en dégager trois choses : l’objectif et l’architecture du projet, les commandes importantes et les fichiers critiques, puis les patterns de code et la structure. Concrètement, il repère que votre application est un service Node, que les tests se lancent avec une commande précise, que la logique métier vit dans un dossier donné, et que vos composants suivent une convention de nommage particulière.

Après l’analyse, Claude rédige un résumé et l’écrit dans un fichier CLAUDE.md. Quand il vous demande la permission de créer ce fichier, appuyez sur Entrée pour approuver, ou sur Shift+Tab pour laisser Claude écrire librement pendant toute la session. Prenez ensuite le temps de relire ce qu’il a produit. C’est un brouillon fidèle à ce qu’il a compris, pas une vérité établie, et la moindre erreur qui s’y glisse vous suivra dans toutes les conversations à venir puisque le fichier sera relu à chaque fois.

Le fichier CLAUDE.md

Ce fichier remplit deux rôles distincts qu’il vaut mieux ne pas confondre. Le premier est descriptif : il guide Claude dans votre codebase en lui rappelant les commandes importantes, l’architecture et le style de code. Le second est prescriptif : il donne des directives spécifiques, c’est-à-dire vos préférences, vos conventions et vos interdictions. Une phrase comme « n’installe jamais de nouvelle dépendance sans demander » relève clairement de cette seconde catégorie — elle ne décrit rien, elle impose une limite.

Le fichier est inclus dans chaque requête envoyée à Claude. C’est, dans les faits, un prompt système permanent pour votre projet, et cela explique la seule contrainte de rédaction qui compte vraiment : il doit rester court et précis, parce que chaque ligne inutile est payée à chaque message.

Les emplacements de CLAUDE.md

Claude reconnaît trois fichiers CLAUDE.md à des emplacements différents, dont la portée et le partage diffèrent :

Fichier	Emplacement	Partagé
`CLAUDE.md`	Racine du projet	Commité, partagé avec l’équipe
`CLAUDE.local.md`	Racine du projet	Personnel, non commité
`~/.claude/CLAUDE.md`	Dossier utilisateur	Global, pour tous vos projets

Le choix de l’emplacement est une décision d’équipe autant que technique. Une convention d’architecture que tout le monde doit respecter appartient au fichier commité, où elle profitera aux nouveaux arrivants. Un chemin propre à votre machine ou une préférence personnelle de style relève du CLAUDE.local.md, sans quoi vous imposez vos habitudes à vos collègues. Une règle que vous voulez voir appliquée partout, comme votre langue de travail, va dans le fichier utilisateur.

Ajouter des instructions personnalisées

Utilisez la commande # pour entrer en « mode mémoire ». Elle vous permet d’éditer vos fichiers CLAUDE.md de façon intelligente, sans quitter la conversation ni ouvrir un éditeur :

# Utilise les commentaires avec parcimonie. Commente uniquement le code complexe.

Claude fusionnera cette instruction dans votre fichier CLAUDE.md automatiquement. Tout l’intérêt du geste tient dans sa rapidité : au moment précis où vous constatez un comportement à corriger, vous l’inscrivez en une ligne, et la correction devient permanente au lieu d’être répétée à chaque nouvelle session.

Mentionner des fichiers avec @

Quand vous avez besoin que Claude regarde des fichiers spécifiques, utilisez le symbole @ suivi du chemin. Le contenu est alors automatiquement inclus dans votre requête, ce qui vous fait gagner l’étape de recherche et supprime le risque qu’il ouvre le mauvais fichier :

Comment fonctionne le systeme d'auth ? @auth

Référencer des fichiers dans CLAUDE.md

La même syntaxe fonctionne à l’intérieur de votre CLAUDE.md, et c’est là qu’elle prend toute sa valeur pour les fichiers pertinents dans de nombreux contextes :

Le schema de base de donnees est defini dans @prisma/schema.prisma.
Consulte-le des que tu as besoin de comprendre la structure des donnees.

Quand vous mentionnez un fichier de cette façon, son contenu est automatiquement inclus dans chaque requête. Réservez donc ce mécanisme aux fichiers réellement transverses — un schéma de données, un fichier de types partagés. Un fichier volumineux accroché en permanence consomme du contexte à chacun de vos messages, y compris ceux qui n’ont strictement rien à voir avec lui.