Chaque longue session Claude Code se termine de la même façon : vous perdez des heures de travail et repartez de zéro.
La solution n'est pas un modèle plus intelligent, mais un système que l'équipe Claude Code utilise en interne et pour lequel elle n'a jamais écrit de guide.
La plupart des développeurs ne l'ont pas et ne savent même pas qu'il existe.
Voici le système complet 👇
🧠Avant de plonger, je partage des notes quotidiennes sur l'IA et le vibe coding dans ma chaîne Telegram : https://t.me/zodchixquant
Ce que signifie réellement l'ingénierie du contexte
Claude lit des milliers de lignes à chaque session. La plupart sont du bruit, et les 5 % qui comptent sont enterrés au bout de deux heures.
C'est là que Claude commence à inventer des fonctions et à corriger des bugs que vous n'avez jamais écrits. La solution n'est pas un modèle plus gros, c'est de contrôler ce qui entre dans la session.
Voici les 6 modèles que l'équipe Claude Code utilise sur son propre monorepo.
Modèle 1 : CLAUDE.md en couches (Étapes 1 à 3)
Un seul CLAUDE.md ne suffit pas. L'équipe Claude Code utilise trois couches, chacune dédiée à un niveau différent.
Étape 1 : CLAUDE.md racine avec les règles générales du projet
Placez un CLAUDE.md à la racine de votre dépôt. Gardez-le en dessous de 100 lignes. Il doit répondre à quatre questions que Claude se pose à chaque prompt :
1# Projet : [nom]23## Stack4- Runtime : Node 22, TypeScript 5.55- Framework : Next.js 15, React 196- Base de données : Postgres 16, Drizzle ORM7- Tests : Vitest, Playwright89## Conventions10- Imports : chemins absolus depuis `@/` uniquement11- Composants : fichiers en kebab-case, exports en PascalCase12- Tests : colocalisés en `[fichier].test.ts`13- Commits : commits conventionnels, pas de pied de co-auteur1415## Ne pas toucher16- `infra/terraform/` (géré par ops)17- `migrations/` (généré, jamais modifié à la main)18- `vendor/` (dépendances commitées)1920## Par défaut21- Exécutez `npm test` avant de déclarer une tâche terminée22- Vérifiez les types avec `tsc --noEmit` à chaque modification23- Formatez avec Prettier à la sauvegarde
Étape 2 : CLAUDE.md de sous-répertoire pour le contexte spécifique au module
Ajoutez CLAUDE.md dans tout dossier où les règles changent. Claude lit le plus proche lorsqu'il travaille dans ce dossier, en plus de celui de la racine.
Exemple, src/auth/CLAUDE.md :
1# Module Auth23Ce module gère la gestion des sessions et les flux OAuth.45## Règles6- Ne jamais journaliser les jetons, même tronqués7- Toutes les lectures de session passent par `getSession()`, jamais les cookies bruts8- Les nouveaux fournisseurs nécessitent une revue de sécurité avant fusion910## Fichiers à lire en premier11- `session.ts` pour le contrat12- `providers/index.ts` pour le motif d'enregistrement
Étape 3 : CLAUDE.md personnel dans ~/.claude/CLAUDE.md
C'est votre couche de préférences globales. Réside en dehors de tout dépôt, s'applique partout.
1## Mes préférences - Expliquez ce que vous allez faire avant de le faire sur les modifications multi-fichiers - Opposez-vous si ma demande semble casser quelque chose - Préférez la composition à l'héritage - Je travaille sous zsh sur macOS
Les trois couches s'empilent : préférences globales + règles du projet + règles du module. Claude les lit toutes à chaque prompt sans avoir à les re-télécharger dans votre contexte.
Modèle 2 : Références de fichiers chirurgicales (Étapes 4 et 5)
Le défaut « laisse Claude décider quels fichiers sont importants » est la façon la plus lente et la plus stupide d'utiliser le contexte.
Étape 4 : Références avec @fichier et autocomplétion
Quand vous tapez @ dans un prompt, Claude ouvre un sélecteur de fichiers flou. Utilisez-le plutôt que de décrire les fichiers en prose.
Mauvais : « regarde le code d'authentification utilisateur et l'aide de session »
Bon : « regarde
@src/auth /session.ts et
@src/auth /providers/google.ts, corrige le rafraîchissement du jeton »
Les références chirurgicales chargent exactement ces fichiers. Les descriptions en prose forcent Claude à chercher, lire 4 ou 5 fichiers candidats, et choisir le mauvais la moitié du temps.
Étape 5 : /focus pour cadrer tout un workflow
Pour les tâches plus longues, limitez toute la session de Claude à des dossiers spécifiques :
1/focus src/auth src/api/auth-routes
Désormais, chaque recherche, grep et lecture opère uniquement dans ces deux dossiers.
Réduit l'utilisation du contexte de 60 à 80 % sur les tâches ciblées, et Claude cesse de lire « utilement » des fichiers non liés pour un contexte dont il n'a pas besoin.
Exécutez /focus clear pour réinitialiser.
Modèle 3 : Compacter et continuer (Étapes 6 à 8)
Les longues sessions atteignent la limite de contexte et plantent. L'astuce n'est pas d'éviter les longues sessions, mais de les faire passer par un compactage contrôlé.
Étape 6 : Surveiller l'utilisation du contexte avec /stats
Exécutez /stats régulièrement.
Quand vous dépassez 70 % d'utilisation du contexte, vous êtes dans la zone dangereuse. Au-dessus de 85 %, Claude commence à supprimer les premiers messages sans vous le dire.
Étape 7 : /compact avec instructions de conservation
/compact seul résume la conversation. Avec des instructions, vous dites à Claude ce qu'il doit conserver textuellement :
1/compact conserve : plan de la tâche en cours, toutes les décisions concernant le refactoring de l'auth, le résultat du test échoué de l'étape 3
Étape 8 : /resume pour les sessions qui s'étalent sur plusieurs jours
Si une tâche s'étend sur plusieurs jours, terminez chaque session par /compact conserve: ... et commencez la suivante par :
1claude --resume [id-de-session]
Ou simplement claude --continue pour la session la plus récente. Reprend exactement là où vous vous êtes arrêté avec l'état compacté intact.
Modèle 4 : Lecture en mode plan d'abord (Étapes 9 et 10)
La plus grande fuite de contexte est Claude qui modifie des fichiers avant de les comprendre. Le mode plan l'oblige à lire d'abord, écrire ensuite.
Étape 9 : Activer le mode plan pour chaque tâche risquée
Appuyez sur Shift+Tab pour passer en mode plan avant toute tâche qui touche plus d'un fichier.
En mode plan, Claude ne peut que lire. Il explique ce qu'il ferait, liste chaque fichier qu'il prévoit de toucher et montre les modifications proposées. Rien n'est exécuté tant que vous n'approuvez pas.
Les économies sont réelles : une lecture, une modification, au lieu de lire 8, modifier 3 de travers, annuler, relire, modifier à nouveau.
Étape 10 : Verrouiller le mode plan pour les chemins sensibles via des hooks
Rendez le mode plan obligatoire pour les zones risquées. Dans .claude/settings.json :
1{2 "hooks": {3 "PreToolUse": [4 {5 "matcher": "Edit(src/auth/**)|Edit(migrations/**)",6 "hooks": [7 {8 "type": "command",9 "command": "claude-require-plan-mode"10 }11 ]12 }13 ]14 }15}
Toute tentative de modification dans src/auth/*\ ou migrations/\\* déclenche une exigence de mode plan. Claude ne peut pas contourner cela.
Modèle 5 : Isolation du contexte des sous-agents (Étapes 11 à 13)
Les sous-agents sont le moyen le plus propre de garder votre contexte principal petit. Chaque sous-agent s'exécute dans sa propre fenêtre, donc la session parent ne voit jamais le bruit.
Étape 11 : Concevoir des sous-agents avec une surface d'outils minimale
Limitez les outils à ce dont le travail a besoin.
Un réviseur de code n'a pas besoin d'écrire ou de modifier.
Un mett à jour de documentation n'a pas besoin de Bash. Moins de surface, moins de contexte brûlé sur des documents et descriptions d'outils non pertinents.
1---2name: réviseur-de-code3description: Examiner les modifications de code pour détecter les bugs et les problèmes de sécurité4tools: Read, Grep, Glob5model: sonnet6---
Étape 12 : Ne passer que les références de fichiers dont l'agent a besoin
Ne dites pas « révise les modifications récentes ». Dites « révise [@src/auth](https://x.com/@src/auth)/session.ts et [@src/auth](https://x.com/@src/auth)/providers/google.ts.** »
Le sous-agent ne lit que ceux-ci, pas sa meilleure estimation de ce que « récent » signifie.
Étape 13 : Utiliser des modèles moins chers pour les sous-agents
Définissez le modèle par agent en fonction de la tâche.
Sonnet pour les tâches de révision et de test, Haiku pour les mises à jour de documentation et les lintings, Opus uniquement pour les audits d'architecture ou de sécurité où un raisonnement approfondi est nécessaire.
Définissez globalement si nécessaire :
1export CLAUDE_CODE_SUBAGENT_MODEL="claude-sonnet-4-6"
Des sous-agents moins chers = plus d'appels de sous-agents par dollar = plus d'isolation = contexte principal plus petit.
Le démarrage en 30 minutes de l'ingénierie du contexte
10 minutes : écrivez un CLAUDE.md racine serré avec la stack, les conventions, la liste « ne pas toucher » et les valeurs par défaut.
5 minutes : ajoutez un CLAUDE.md de sous-répertoire dans vos 2 à 3 modules les plus modifiés.
5 minutes : déposez un CLAUDE.md personnel dans ~/.claude/CLAUDE.md avec vos préférences.
5 minutes : créez une compétence dans .claude/skills/ pour le workflow que vous faites le plus souvent.
5 minutes : ancrez le réflexe Shift+Tab dans votre mémoire musculaire et commencez chaque tâche multi-fichiers en mode plan.
Terminé !
Votre prochaine session utilisera 50 à 70 % de contexte en moins pour la même quantité de travail. À la session 5, les modèles deviennent un réflexe, et vous cessez complètement d'atteindre la limite.
Le contexte n'est pas quelque chose que Claude gère pour vous. C'est quelque chose que vous ingéniez.
Maintenant vous avez le système.
Merci d'avoir lu !
Je partage des notes quotidiennes sur l'IA, la finance et le vibe coding dans ma chaîne Telegram : https://t.me/zodchixquant
