CLAUDE.md : le fichier qui change tout

CLAUDE.md est un fichier Markdown placé à la racine de ton projet. Claude Code le lit automatiquement à chaque session — c'est ton contexte permanent.

Ce qu'il faut y mettre :

L'architecture technique du projet (stack, conventions de nommage, structure des dossiers)
Les règles de codage (style, patterns à suivre, ce qu'il ne faut jamais faire)
Les commandes utiles (npm run dev, scripts de test, etc.)
Les erreurs passées et comment les éviter

La règle d'or de l'équipe Anthropic : à chaque fois que Claude fait une erreur et qu'on le corrige, on lui demande d'écrire une règle dans CLAUDE.md pour que ça ne se reproduise pas. AI Agent News Le fichier s'améliore seul au fil du temps.

Garde-le court : le créateur de Claude Code, Boris Cherny, maintient son fichier autour de 2 500 tokens (~100 lignes). AI Agent News Un fichier trop long dilue le contexte.

Plan Mode : planifier avant de coder

Le Plan Mode permet à Claude de lire des fichiers et répondre à des questions sans faire de modifications. Claude C'est l'étape de réflexion avant l'exécution.

Active-le avec Shift+Tab pour cycler entre les modes (Normal → Plan → Auto-Accept).

Le workflow recommandé en 4 étapes :

Entre en Plan Mode
Demande à Claude d'explorer les fichiers concernés
Demande un plan d'implémentation détaillé, édite-le si besoin (Ctrl+G)
Repasse en mode Normal et laisse Claude coder en suivant le plan

Les tests internes d'Anthropic montrent que les tentatives non guidées réussissent environ 33% du temps. La planification réduit drastiquement les décisions ambiguës. Smart WebTech

À utiliser pour : changements multi-fichiers, décisions d'architecture, code non familier. À sauter pour : modifications simples et claires que tu peux décrire en une phrase.

Gestion du contexte

Le contexte est ta ressource la plus précieuse. Quand il se remplit, Claude commence à "oublier" les instructions du début de session.

Les commandes essentielles :

CommandeUsage/clearRepart de zéro (contexte vierge)/compactCondense la session sans tout effacer/contextVisualise et audite le contexte actuel/rewindRevient à un checkpoint antérieur

Bonne pratique : utilise /compact en cours de longue session, /clear pour passer à une nouvelle tâche distincte.

Ne balance pas d'informations "au cas où" — chaque fichier lu, chaque output de commande consomme du contexte. AI Agent News

Les slash commands personnalisées

Crée des slash commands pour chaque workflow que tu fais plusieurs fois par jour — ça évite de retaper les mêmes prompts. Elles se placent dans .claude/commands/ et sont versionnées dans git. GitHub

Exemple de commande /fix-issue :

markdown

---
name: fix-issue
description: Corriger un issue GitHub
---
Analyse et corrige l'issue GitHub : $ARGUMENTS.
1. Lis les détails avec `gh issue view`
2. Trouve les fichiers concernés
3. Implémente le fix
4. Écris et lance les tests
5. Crée un commit descriptif et ouvre une PR

Lance avec /fix-issue 1234. Crée tes propres commandes pour tes workflows récurrents : review de code, génération de tests, mise à jour de doc, etc.

/btw : les questions rapides sans interrompre

/btw (by the way) permet de poser une question rapide pendant que Claude travaille, sans interrompre sa tâche ni polluer l'historique. La réponse s'affiche dans un overlay, et Claude continue comme si de rien n'était. XDA Developers

Utile pour : vérifier un détail de syntaxe, demander l'explication d'une fonction, clarifier un comportement — sans casser le fil de la session.

Sessions parallèles et Git Worktrees

Boris Cherny lance 10 à 15 sessions Claude Code en parallèle. Chaque session travaille sur son propre git worktree pour éviter les conflits. AI Agent News

bash

git worktree add ../feature-auth feature/auth
git worktree add ../feature-api feature/api

Tu lances une session Claude Code dans chaque dossier. Les branches restent isolées, les agents travaillent en parallèle. Particulièrement efficace pour comparer plusieurs implémentations d'une même feature.

Hooks : automatiser les vérifications

Les hooks exécutent des scripts à des points précis du workflow de Claude. Contrairement aux instructions dans CLAUDE.md qui sont consultatives, les hooks sont déterministes — ils garantissent que l'action se produit à chaque fois. Claude

Exemples pratiques :

Hook post-édition : lance ESLint/Prettier après chaque modification de fichier
Hook pre-commit : vérifie les types TypeScript avant de committer
Hook bloquant : empêche toute écriture dans le dossier /migrations

Claude peut écrire les hooks lui-même — essaie des prompts comme "Écris un hook qui lance eslint après chaque édition de fichier". Claude

Choisir le bon modèle et le bon effort

Par défaut, Claude Code utilise Opus 4.6 ou Opus 4.7. Pour les tâches simples, passe sur Sonnet 4.6 pour économiser du quota.

Le mot-clé think dans ton prompt active un effort élevé et déclenche le raisonnement adaptatif sur Opus. Claude alloue dynamiquement sa réflexion selon la complexité du problème. Builder.io

Tu peux aussi régler l'effort de façon permanente avec /effort (low / medium / high / xhigh). Règle xhigh pour les décisions d'architecture complexes, medium pour les tâches de routine.

/schedule et /loop : automatiser en arrière-plan

/loop lance une tâche répétitive à intervalle régulier pendant que ta session est ouverte. /schedule va plus loin : les tâches persistent même quand le terminal est fermé. Les "Cloud tasks" tournent sur les serveurs d'Anthropic même quand ton appareil est éteint. XDA Developers

Exemples d'usage : surveiller des PRs stales, traiter des notifications Slack en batch, générer des rapports automatiques.

Claude in Chrome : donner des yeux à Claude Code

L'extension Claude in Chrome donne à ta session Claude Code un vrai navigateur : elle peut voir, interagir et tester ce qu'elle construit en temps réel. L'extension et Claude Code "fonctionnent ensemble pour un workflow build-test-verify". XDA Developers Disponible en beta sur tout plan payant.

/teleport : changer d'appareil sans perdre sa session

/teleport permet de transférer une session cloud vers ta machine locale et de continuer à coder. Tu peux aussi commencer sur mobile (app Claude iOS/Android, onglet Code) et reprendre sur desktop. XDA Developers

Erreurs fréquentes à éviter

Lancer Claude sans contexte — démarre toujours depuis la racine du projet, avec un CLAUDE.md à jour.

Sauter le Plan Mode sur des tâches complexes — les 5 minutes de planification évitent 30 minutes de refactoring.

Laisser le contexte se remplir sans jamais utiliser /compact ou /clear — la qualité des réponses dégrade progressivement.

Mettre des instructions dans CLAUDE.md qui devraient être dans settings.json — pour les comportements déterministes (permissions, attribution git), utilise la config, pas du texte consultatif.