Configuration de Claude Code

Le problème : Les nouvelles sessions Claude Code donnent des réponses génériques parce qu'elles ne connaissent rien de ton projet.

Gain rapide : Pose un CLAUDE.md à la racine de ton projet et la prochaine session le lit avant que tu tapes un mot.

Résultat : Les réponses arrêtent de ressembler à un tutoriel standard et commencent à correspondre à ta vraie stack.

Trois fichiers font l'essentiel du travail. CLAUDE.md donne le contexte à Claude. Les serveurs MCP lui donnent des outils. Les commandes slash lui donnent des workflows. Configure une fois, réutilise partout.

Créer les fichiers de config

Deux commandes pour démarrer :

touch CLAUDE.md                    # Racine du projet - requis
mkdir -p .claude/commands          # Workflows personnalisés - optionnel

C'est tout le squelette. Maintenant remplis-le.

CLAUDE.md (Requis)

Pose ça à la racine du projet. Claude le lit à chaque démarrage de session :

# [Nom du Projet] - Contexte de développement

## Ce que fait ce projet

[Description en 2 phrases de l'objectif de ton app]

## Stack technique & versions

- Frontend: React 18.2.0 with TypeScript 5.0
- Backend: Node.js with Express or Next.js App Router
- Database: PostgreSQL 15 with Prisma ORM
- Styling: Tailwind CSS 3.4

## Structure des fichiers

src/
├── app/ # Next.js pages (App Router)
├── components/ # Reusable UI components
├── lib/ # Utilities and configurations
└── types/ # TypeScript definitions

## Objectifs du sprint actuel
- [ ] Système d'authentification utilisateur
- [ ] Dashboard avec données utilisateur
- [ ] Endpoints API pour les opérations CRUD

## Ne jamais toucher sans permission
- Dépendances package.json (demander avant)
- Migrations de base de données (expliquer les changements)
- Variables d'environnement de production

Vérification : Claude mentionne ta stack et tes objectifs de sprint dans sa prochaine réponse, sans qu'on lui demande.

Serveurs MCP (fonctionnalités avancées)

Les serveurs MCP (Model Context Protocol) ajoutent de vrais outils à Claude. Place-les dans tes paramètres globaux sous ~/.claude/settings.json :

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-filesystem"],
      "env": {
        "ACCESS_DIRECTORIES": "/Users/yourname/projects"
      }
    },
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "ghp_your_token_here"
      }
    }
  }
}

Ce que ça t'apporte :

• Lecture et écriture directe de fichiers
• Recherche dans les dépôts GitHub
• Accès à la documentation du projet
• Reconnaissance de patterns dans ton code

Vérification : Claude peut maintenant ouvrir des fichiers et accéder à GitHub sans que tu colles quoi que ce soit.

Commandes Slash (workflows réutilisables)

Tout fichier markdown sous .claude/commands/ devient une commande slash. Nomme le fichier, obtiens la commande gratuitement.

Workflow de debug (.claude/commands/debug.md) :

# Workflow de Debug

Pour débugger :

1. Reproduire l'erreur en isolation
2. Vérifier la console du navigateur et l'onglet réseau
3. Ajouter des console.logs pour tracer l'exécution
4. Tester avec des données minimales
5. Vérifier les changements récents dans git log
6. Demander avant de proposer des changements d'architecture majeurs

Génération de tests (.claude/commands/test.md) :

# Directives de génération de tests

Pour les nouvelles fonctions :

1. Écrire des tests unitaires avec Jest/Vitest
2. Tester le cas normal et les cas limites
3. Simuler les dépendances externes
4. Utiliser des noms de tests descriptifs
5. Viser 80% de couverture sur les chemins critiques

Utilisation : Tape /debug ou /test dans n'importe quelle session et Claude suit le workflow.

Vérification : Claude suit les mêmes étapes documentées à chaque fois.

Corrections de configuration courantes

Quand CLAUDE.md devient lourd, divise-le. Garde le fichier racine court et pointe vers le reste :

# CLAUDE.md principal (garder court)

Voir aussi :

- .claude/database-schema.md (schéma détaillé)
- .claude/api-patterns.md (conventions des endpoints)

Le système de portée settings.json

Au-delà de CLAUDE.md, Claude Code utilise des fichiers settings.json pour les permissions, les variables d'environnement, les modèles par défaut et le comportement des outils. Quatre portées s'empilent, et la plus étroite gagne :

Priorité, du haut vers le bas : Managed > Arguments de ligne de commande > Local > Project > User. Les paramètres Managed gagnent toujours, donc la politique de l'entreprise reste appliquée.

Ajoute $schema en haut de ton settings.json et VS Code, Cursor, ou tout éditeur compatible JSON schema s'activera avec l'autocomplétion et la validation en temps réel :

{
  "$schema": "https://json.schemastore.org/claude-code-settings.json",
  "permissions": {
    "allow": ["Bash(npm run lint)", "Bash(npm run test *)"],
    "deny": ["Read(./.env)", "Read(./.env.*)", "Read(./secrets/**)"]
  },
  "env": {
    "CLAUDE_CODE_ENABLE_TELEMETRY": "1"
  }
}

Claude Code horodate aussi chaque modification de fichier de config et conserve les cinq sauvegardes les plus récentes, donc une mauvaise sauvegarde ne te coûte rien.

Catégories de paramètres clés

Chaque catégorie a son propre guide dédié. Version courte :

• Permissions. Contrôle quels outils Claude utilise, quels fichiers il lit, quelles commandes il exécute. Les règles vont sous allow, deny et ask.
• Sandbox. Isole les commandes bash de ton système de fichiers et réseau, appliqué au niveau OS. Active-le avec /sandbox ou sandbox.enabled.
• Attribution. Garde ou supprime le trailer Co-Authored-By sur les commits et PR. Les commits et PR se configurent séparément.
• Plugins. Importe des skills, agents, hooks et serveurs MCP depuis des marketplaces. Contrôlé par enabledPlugins et extraKnownMarketplaces.
• Model. Fixe un modèle par défaut via la clé model plutôt que de passer --model à chaque fois.
• Status Line. Met l'utilisation du contexte en direct, la branche git, le nom du modèle ou le coût dans une barre persistante.
• Keybindings. Reconfigure les touches avec /keybindings, qui écrit dans ~/.claude/keybindings.json.

Variables d'environnement essentielles

Les variables d'env te donnent le contrôle le plus fin sur Claude Code. Définis-les dans ton profil shell, passe-les en ligne ou inclus-les dans la clé env de settings.json. Celles qui valent la peine d'être connues :

Trois façons de les appliquer. En ligne pour une session ponctuelle :

ANTHROPIC_MODEL=claude-sonnet-4-20250514 claude

De façon persistante, en ajoutant à ~/.bashrc ou ~/.zshrc :

export CLAUDE_AUTOCOMPACT_PCT_OVERRIDE=80
export MAX_THINKING_TOKENS=10000

Ou en les intégrant dans settings.json pour qu'elles s'appliquent à chaque lancement :

{
  "env": {
    "CLAUDE_AUTOCOMPACT_PCT_OVERRIDE": "80",
    "MAX_THINKING_TOKENS": "10000"
  }
}

Environ 70 variables d'env existent. La référence des paramètres a la liste complète, et le guide de configuration du terminal couvre les sauts de ligne et les notifications.

Configuration globale vs par projet

Paramètres globaux (~/.claude/settings.json) :

• Configurations des serveurs MCP
• Préférences personnelles et modèles par défaut
• Standards de code universels

Paramètres du projet (racine du projet) :

• CLAUDE.md. Contexte et règles du projet.
• .claude/commands/. Commandes slash personnalisées.
• .claude/settings.json. Permissions partagées en équipe, hooks et serveurs MCP.
• .claude/settings.local.json. Tes overrides personnels pour ce projet (gitignored).

Priorité à nouveau, brièvement : Managed > Local > Project > User. Lance /init et Claude écrit un CLAUDE.md de départ pour toi.

Tu travailles dans un monorepo ou tu partages des standards entre dépôts ? L'option --add-dir permet à Claude de charger des fichiers CLAUDE.md depuis des répertoires supplémentaires.

Prochaines étapes

Claude Code est maintenant configuré. À partir de là :

• Construis ton premier projet sur la configuration mise en place
• Apprends les techniques de contrôle du terminal
• Explore les stratégies de gestion du contexte
• Ajoute d'autres serveurs MCP depuis la liste populaire
• Consulte le guide de dépannage si quelque chose coince

Conseil pro : Garde CLAUDE.md à jour. La stack change, les priorités évoluent, les objectifs de sprint tournent. Mets à jour le fichier quand c'est le cas. Claude est seulement aussi efficace que le contexte que tu lui fournis.