Utilisez CLAUDE.md pour conserver les conventions de projet entre les sessions Claude AI

Un utilisateur de Reddit rapporte que l'ajout d'un fichier CLAUDE.md à la racine du projet est le changement le plus impactant qu'il ait fait avec Claude Code. Claude lit ce fichier au début de chaque session, vous n'avez donc jamais besoin de réexpliquer des conventions comme l'utilisation de TypeScript, Tailwind vs CSS modules, la structure des dossiers de test ou les relations entre modèles de données.

Détails clés

• Emplacement : Créez un fichier nommé CLAUDE.md à la racine de votre répertoire de projet.
• Ce qu'il faut inclure : Conventions de codage (par exemple, « Nous utilisons TypeScript, toujours. Pas d'exports par défaut. Tailwind, pas de CSS modules. Les tests vont dans des dossiers tests. »), ainsi que le contexte architectural du projet — comment les modules sont connectés, les modèles de données, et quels fichiers sont critiques vs superflus.
• Comportement : Le fichier est lu automatiquement au début de chaque session Claude. Aucune invocation manuelle nécessaire. Les conventions sont appliquées sans qu'on les demande.
• Résultat : L'utilisateur a remarqué que « les modifications de Claude se sont nettement améliorées une fois que ce contexte était intégré dès le début de la session. »

Exemple pratique

# CLAUDE.md

Conventions

Langage : TypeScript
Exports : exports nommés uniquement (pas d'exports par défaut)
Style : Tailwind CSS (pas de CSS modules)
Tests : les tests vont dans des dossiers tests/ dédiés

Architecture

Frontend : React avec React Router
Couche API : routes Express dans /api
Modèles de données : schéma Prisma dans /prisma
Fichiers critiques : /src/app.ts, /src/config.ts

Après avoir ajouté ce fichier, l'utilisateur déclare ne plus jamais avoir à retaper ces règles par session.

À qui cela s'adresse

Les développeurs utilisant Claude Code ou tout agent de codage alimenté par Claude qui souhaitent un comportement cohérent entre les sessions de chat sans répéter les instructions.