Budget Contexte
Analyse la surcharge en tokens de chaque composant chargé dans une session Claude Code et propose des optimisations concrètes pour récupérer de l'espace de contexte.
Quand l'utiliser
- Les performances de la session semblent lentes ou la qualité des résultats se dégrade
- Vous avez récemment ajouté de nombreuses compétences, agents ou serveurs MCP
- Vous voulez savoir combien de marge de contexte il vous reste réellement
- Vous prévoyez d'ajouter plus de composants et devez savoir s'il y a de la place
- Exécution de la commande
/context-budget(cette compétence la supporte)
Fonctionnement
Phase 1 : Inventaire
Parcourir tous les répertoires de composants et estimer la consommation de tokens :
Agents (agents/*.md)
- Compter les lignes et les tokens par fichier (mots × 1,3)
- Extraire la longueur de la métadonnée
description - Drapeau : fichiers >200 lignes (lourd), description >30 mots (métatdonnée gonflée)
Compétences (skills/*/SKILL.md)
- Compter les tokens par SKILL.md
- Drapeau : fichiers >400 lignes
- Vérifier les copies dupliquées dans
.agents/skills/— ignorer les copies identiques pour éviter le double comptage
Règles (rules/**/*.md)
- Compter les tokens par fichier
- Drapeau : fichiers >100 lignes
- Détecter le chevauchement de contenu entre fichiers de règles d'un même module linguistique
Serveurs MCP (.mcp.json ou configuration MCP active)
- Compter les serveurs configurés et le nombre total d'outils
- Estimer la surcharge de schéma à ~500 tokens par outil
- Drapeau : serveurs avec >20 outils, serveurs enveloppant des commandes CLI simples (
gh,git,npm,supabase,vercel)
CLAUDE.md (niveaux projet et utilisateur)
- Compter les tokens par fichier dans la chaîne CLAUDE.md
- Drapeau : total combiné >300 lignes
Phase 2 : Classification
Trier chaque composant dans un seau :
| Seau | Critère | Action |
|---|---|---|
| Toujours nécessaire | Référencé dans CLAUDE.md, supporte une commande active, ou correspond au type de projet actuel | Conserver |
| Parfois nécessaire | Spécifique à un domaine (ex. motifs linguistiques), non référencé dans CLAUDE.md | Envisager une activation à la demande |
| Rarement nécessaire | Aucune référence de commande, contenu en double, ou aucune correspondance évidente avec le projet | Supprimer ou charger paresseusement |
Phase 3 : Détection des problèmes
Identifier les motifs problématiques suivants :
- Descriptions d'agents gonflées — description >30 mots dans les métadonnées chargée à chaque invocation d'outil Task
- Agents lourds — fichiers >200 lignes gonflent le contexte de l'outil Task à chaque création
- Composants redondants — compétences qui dupliquent la logique d'un agent, règles qui dupliquent CLAUDE.md
- Sur-souscription MCP — >10 serveurs, ou serveurs enveloppant des outils CLI disponibles gratuitement
- Gonflement CLAUDE.md — explications verbeuses, sections obsolètes, instructions qui devraient être des règles
Phase 4 : Rapport
Produire le rapport de budget de contexte :
Rapport de Budget Contexte
═══════════════════════════════════════
Surcharge totale estimée : ~XX,XXX tokens
Modèle de contexte : Claude Sonnet (fenêtre 200K)
Contexte disponible effectif : ~XXX,XXX tokens (XX%)
Ventilation par composant :
┌─────────────────┬────────┬───────────┐
│ Composant │ Nb │ Tokens │
├─────────────────┼────────┼───────────┤
│ Agents │ N │ ~X,XXX │
│ Compétences │ N │ ~X,XXX │
│ Règles │ N │ ~X,XXX │
│ Outils MCP │ N │ ~XX,XXX │
│ CLAUDE.md │ N │ ~X,XXX │
└─────────────────┴────────┴───────────┘
ATTENTION : Problèmes trouvés (N) :
[classés par économie de tokens]
Top 3 Optimisations :
1. [action] → économie ~X,XXX tokens
2. [action] → économie ~X,XXX tokens
3. [action] → économie ~X,XXX tokens
Économies potentielles : ~XX,XXX tokens (XX% de la surcharge actuelle)
En mode verbeux, afficher en plus les comptes de tokens par fichier, la ventilation ligne par ligne des fichiers les plus lourds, les lignes redondantes spécifiques entre composants qui se chevauchent, et la liste des outils MCP avec l'estimation de taille de schéma par outil.
Exemples
Audit de base
Utilisateur : /context-budget
Compétence : Analyse la configuration → 16 agents (12 400 tokens), 28 compétences (6 200), 87 outils MCP (43 500), 2 CLAUDE.md (1 200)
Drapeaux : 3 agents lourds, 14 serveurs MCP (3 remplaçables par CLI)
Économie principale : supprimer 3 serveurs MCP → -27 500 tokens (47% de réduction de surcharge)
Mode verbeux
Utilisateur : /context-budget --verbose
Compétence : Rapport complet + ventilation par fichier montrant planner.md (213 lignes, 1 840 tokens),
liste des outils MCP avec tailles par outil, lignes de règles dupliquées côte à côte
Vérification avant expansion
Utilisateur : Je veux ajouter 5 serveurs MCP supplémentaires, ai-je de la place ?
Compétence : Surcharge actuelle 33% → ajouter 5 serveurs (~50 outils) ajouterait ~25 000 tokens → passe à 45% de surcharge
Recommandation : supprimer d'abord 2 serveurs remplaçables par CLI pour rester sous 40%
Bonnes pratiques
- Estimation des tokens : utiliser
mots × 1,3pour la prose,caractères / 4pour les fichiers avec beaucoup de code - MCP est le plus gros levier : chaque schéma d'outil coûte ~500 tokens ; un serveur de 30 outils coûte plus que toutes vos compétences réunies
- Les descriptions d'agents sont toujours chargées : même si l'agent n'est jamais invoqué, son champ description est présent dans chaque contexte d'outil Task
- Mode verbeux pour le débogage : à utiliser lorsque vous devez identifier exactement les fichiers responsables de la surcharge, pas pour des audits réguliers
- Auditer après chaque modification : exécuter après avoir ajouté un agent, une compétence ou un serveur MCP pour détecter la dérive tôt