Configuration des fichiers CLAUDE.md
Configurez les paramètres et le contexte spécifiques au projet pour maximiser l'efficacité de Claude Code pour vos projets spécifiques.
Qu'est-ce que CLAUDE.md ?
CLAUDE.md est un fichier de configuration spécial qui vous permet de fournir un contexte persistant et des paramètres spécifiques au projet à Claude Code. Il aide Claude à mieux comprendre votre projet et à fournir une assistance plus précise.
Avantages Clés
- Contexte de projet persistant entre les sessions
- Configuration personnalisée pour les besoins spécifiques au projet
- Recommandations de code améliorées
- Meilleure compréhension de l'architecture du projet
- Besoin réduit d'explications répétitives
Création d'un Fichier CLAUDE.md de Base
Commençons par une structure de fichier CLAUDE.md de base :
Étape 1 : Créer le Fichier
Créez un fichier nommé CLAUDE.md dans le répertoire racine de votre projet :
# Project: My Awesome App ## Project Description A brief description of what your project does and its main features. ## Tech Stack - Frontend: React, TypeScript - Backend: Node.js, Express - Database: MongoDB - Testing: Jest, React Testing Library ## Code Conventions - We use Prettier for formatting - ESLint for linting - Functional components with hooks for React - 2-space indentation - camelCase for variables and functions - PascalCase for components and classes ## Project Structure - /src - Main source code - /components - React components - /pages - Page components - /api - API routes - /utils - Utility functions - /hooks - Custom React hooks - /styles - CSS/SCSS files - /public - Static assets - /tests - Test files
Étape 2 : Ajouter des Sections Spécifiques au Contexte
Améliorez votre CLAUDE.md avec un contexte plus spécifique :
## Important Notes - User authentication uses JWT stored in HttpOnly cookies - API calls should use the client utility in /src/utils/api.ts - New components should have a companion test file - State management uses React Context + useReducer ## Known Issues - Performance issues with large data sets in the dashboard component - Mobile menu animation is choppy on older iOS devices ## Future Plans - Implementing real-time updates with WebSockets - Adding a dark mode theme - Migrating to Next.js for improved SEO
Configuration Avancée
Faites passer votre fichier CLAUDE.md au niveau supérieur avec ces fonctionnalités avancées :
Instructions Personnalisées
Ajoutez des instructions spécifiques sur la façon dont Claude doit se comporter lors du travail avec votre projet :
## Instructions for Claude - Always suggest TypeScript types for new functions - Prioritize performance optimizations - Use React Query for data fetching - Follow the existing error handling pattern - Include JSDoc comments for public functions - Prefer functional programming approaches
Configuration d'Environnement
Fournissez des informations sur l'environnement de développement :
## Environment Setup - Node.js v16+ - npm scripts: - `npm start` - Start development server - `npm test` - Run tests - `npm run build` - Build for production - `npm run lint` - Run linter - Environment variables (examples, not actual values): - API_URL=http://localhost:3001 - DEBUG=false - FEATURE_FLAGS_ENABLED=true
Diagrammes d'Architecture
Incluez des diagrammes Mermaid pour visualiser l'architecture :
## Architecture
```mermaid
graph TD
A[Client] --> B[API Gateway]
B --> C[Auth Service]
B --> D[User Service]
B --> E[Content Service]
C --> F[(Auth DB)]
D --> G[(User DB)]
E --> H[(Content DB)]
```
## Component Relationships
```mermaid
graph TD
A[App] --> B[Layout]
B --> C[Header]
B --> D[Main Content]
B --> E[Footer]
D --> F[Dashboard]
F --> G[UserStats]
F --> H[ActivityFeed]
F --> I[Recommendations]
```Bonnes Pratiques
Suivez ces bonnes pratiques pour maintenir des fichiers CLAUDE.md efficaces :
Maintenez à Jour
- Mettez à jour CLAUDE.md chaque fois que l'architecture du projet change
- Ajoutez de nouvelles sections à mesure que la complexité du projet augmente
- Supprimez les informations obsolètes
- Traitez-le comme une documentation vivante
Utilisez Plusieurs Fichiers CLAUDE.md
Pour les projets plus importants, envisagez d'utiliser plusieurs fichiers CLAUDE.md dans différents répertoires :
/CLAUDE.md- Contexte du projet racine/frontend/CLAUDE.md- Détails spécifiques au frontend/backend/CLAUDE.md- Détails spécifiques au backend/docs/CLAUDE.md- Directives de documentation
Contrôle de Version
- Committez CLAUDE.md dans votre dépôt
- Révisez les modifications de CLAUDE.md lors des révisions de code
- Envisagez d'ajouter les mises à jour de CLAUDE.md à votre Définition de Terminé
Tutoriels Connexes
Explorez ces tutoriels connexes pour améliorer votre flux de travail Claude Code :
- Apprenez à utiliser efficacement la commande /clear pour la gestion du contexte
- Maîtrisez les bonnes pratiques d'intégration Git avec Claude Code
- Découvrez les techniques avancées de gestion du contexte