Budget Contexte
Analysez la surcharge en tokens de chaque composant chargé dans une session Claude Code et proposez des optimisations actionnables pour récupérer de l'espace de contexte.
Quand l'utiliser
- Les performances de la session semblent lentes ou la qualité des réponses se dégrade
- Vous avez récemment ajouté plusieurs 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 prend en charge)
Comment ça fonctionne
Phase 1 : Inventaire
Scannez tous les répertoires de composants et estimez la consommation en tokens :
Agents (agents/*.md)
- Comptez les lignes et les tokens par fichier (mots × 1.3)
- Extrayez la longueur de la description dans le frontmatter
- Drapeau : fichiers >200 lignes (lourds), description >30 mots (frontmatter gonflé)
Compétences (skills/*/SKILL.md)
- Comptez les tokens par SKILL.md
- Drapeau : fichiers >400 lignes
- Vérifiez les copies en double dans
.agents/skills/— ignorez les copies identiques pour éviter le double comptage
Règles (rules/**/*.md)
- Comptez les tokens par fichier
- Drapeau : fichiers >100 lignes
- Détectez les chevauchements de contenu entre fichiers de règles dans le même module linguistique
Serveurs MCP (.mcp.json ou configuration MCP active)
- Comptez les serveurs configurés et le nombre total d'outils
- Estimez la surcharge du schéma à ~500 tokens par outil
- Drapeau : serveurs avec >20 outils, serveurs qui encapsulent des commandes CLI simples (
gh,git,npm,supabase,vercel)
CLAUDE.md (projet + utilisateur)
- Comptez les tokens par fichier dans la chaîne CLAUDE.md
- Drapeau : total combiné >300 lignes
Phase 2 : Classification
Classez chaque composant dans un groupe :
| Groupe | Critère | Action |
|---|---|---|
| Toujours nécessaire | Référencé dans CLAUDE.md, prend en charge 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 à la demande |
Phase 3 : Détection des problèmes
Identifiez les motifs problématiques suivants :
- Descriptions d'agents gonflées — description >30 mots dans le frontmatter chargée à chaque invocation de l'outil Task
- Agents lourds — fichiers >200 lignes qui gonflent le contexte de l'outil Task à chaque déclenchement
- Composants redondants — compétences qui dupliquent la logique d'un agent, règles qui dupliquent CLAUDE.md
- Souscription excessive MCP — >10 serveurs, ou serveurs encapsulant des outils CLI disponibles gratuitement
- Gonflement CLAUDE.md — explications verbeuses, sections obsolètes, instructions qui devraient être des règles
Phase 4 : Rapport
Produisez le rapport de budget contexte :
Rapport de Budget Contexte
═══════════════════════════════════════
Surcharge totale estimée : ~XX,XXX tokens
Modèle de contexte : Claude Sonnet (fenêtre de 200K)
Contexte disponible effectif : ~XXX,XXX tokens (XX%)
Répartition des composants :
┌─────────────────┬────────┬───────────┐
│ 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, affichez également le nombre 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 la taille du schéma par outil.
Exemples
Audit de base
Utilisateur : /context-budget
Compétence : Scanne 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 la 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 extension
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 → pousse à 45% de surcharge
Recommandation : supprimer d'abord 2 serveurs remplaçables par CLI pour rester sous les 40%
Bonnes Pratiques
- Estimation des tokens : utilisez
mots × 1.3pour le texte,caractères / 4pour les fichiers contenant 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 combinées
- 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 de l'outil Task
- Mode verbeux pour le débogage : utilisez-le lorsque vous devez identifier exactement les fichiers responsables de la surcharge, pas pour des audits réguliers
- Auditez après les changements : exécutez après avoir ajouté un agent, une compétence ou un serveur MCP pour détecter la dérive tôt