The CLAUDE.md file

Concepts clés

Objectif

• Fournit à Claude Code une mémoire persistante sur votre projet
• Élimine le besoin de réexplorer la base de code à chaque début de session
• Agit comme un « script d'intégration » pour votre base de code

Fonctionnement

• Fichier Markdown placé à la racine du projet
• Automatiquement lu par Claude Code au démarrage de la session
• Le contenu est ajouté à votre prompt
• Peut être généré automatiquement à l'aide de la commande /slash init

Contenu à inclure

• Stack technologique (frameworks, bibliothèques, outils)
• Préférences de style de code (indentation, conventions de nommage, types d'export)
• Structure du projet (où placer les fichiers/routes)
• Commandes (serveur de développement, tests, lint)
• Bonnes pratiques (préférer les server actions aux routes API, etc. )

Hiérarchie de la mémoire

• **Claude. md au niveau du projet** (répertoire racine) - partagé avec l'équipe via le contrôle de version
• **Claude. md au niveau utilisateur** (dossier de configuration) - préférences personnelles pour tous les projets

Bonnes pratiques

• Commencez sans Claude. md pour identifier où vous devez corriger la trajectoire
• Gardez le fichier compact avec uniquement les informations essentielles
• Demandez explicitement à Claude de sauvegarder les corrections en mémoire pour les sessions futures
• Référencez la documentation du projet en utilisant le symbole @ avec les chemins de fichiers
• Construisez progressivement au fur et à mesure que vous découvrez ce que Claude doit savoir

Avantage clé

• Transforme Claude Code de frustrant (corrections constantes) à productif (contexte approprié dès le départ)

Points clés à retenir

• **Claude. md fournit une mémoire persistante** pour votre projet, automatiquement lue à chaque démarrage de session pour éliminer la réexploration répétitive de la base de code

• Incluez le contexte essentiel : stack technologique, préférences de style de code, structure du projet, commandes et bonnes pratiques pour guider le travail de Claude dès le départ

• Système de mémoire à deux niveaux : Claude. md au niveau du projet (partagé via le contrôle de version) + Claude. md au niveau utilisateur (préférences personnelles pour tous les projets)

• Construisez progressivement et gardez-le compact—commencez sans lui, identifiez les lacunes, puis ajoutez uniquement les informations critiques ; demandez explicitement à Claude de sauvegarder les corrections pour les sessions futures

• Transforme la productivité : un contexte approprié en amont élimine les corrections constantes et rend Claude Code véritablement utile plutôt que frustrant