Context Budget
Analysiert den Token-Overhead aller geladenen Komponenten in einer Claude Code-Session und zeigt umsetzbare Optimierungen zur Rückgewinnung von Context-Speicherplatz auf.
Verwendung
- Die Session fühlt sich träge an oder die Ausgabequalität lässt nach
- Du hast kürzlich viele Skills, Agents oder MCP-Server hinzugefügt
- Du möchtest wissen, wie viel Context-Spielraum du tatsächlich hast
- Du planst, weitere Komponenten hinzuzufügen und musst wissen, ob Platz ist
- Ausführung des
/context-budget-Befehls (dieses Skill unterstützt ihn)
Funktionsweise
Phase 1: Inventarisierung
Scanne alle Komponenten-Verzeichnisse und schätze den Tokenverbrauch:
Agents (agents/*.md)
- Zähle Zeilen und Tokens pro Datei (Wörter × 1,3)
- Extrahiere die Länge der
description-Frontmatter - Markiere: Dateien >200 Zeilen (schwer), Beschreibungen >30 Wörter (aufgeblähte Frontmatter)
Skills (skills/*/SKILL.md)
- Zähle Tokens pro SKILL.md
- Markiere: Dateien >400 Zeilen
- Prüfe auf doppelte Kopien in
.agents/skills/— überspringe identische Kopien, um Doppelzählungen zu vermeiden
Regeln (rules/**/*.md)
- Zähle Tokens pro Datei
- Markiere: Dateien >100 Zeilen
- Erkenne inhaltliche Überschneidungen zwischen Regeldateien im selben Sprachmodul
MCP-Server (.mcp.json oder aktive MCP-Konfiguration)
- Zähle konfigurierte Server und die Gesamtanzahl der Tools
- Schätze den Schema-Overhead mit ~500 Tokens pro Tool
- Markiere: Server mit >20 Tools, Server die einfache CLI-Befehle kapseln (
gh,git,npm,supabase,vercel)
CLAUDE.md (Projekt- und Benutzerebene)
- Zähle Tokens pro Datei in der CLAUDE.md-Kette
- Markiere: Gesamtsumme >300 Zeilen
Phase 2: Klassifizieren
Ordne jede Komponente in einen Behälter ein:
| Behälter | Kriterium | Aktion |
|---|---|---|
| Immer benötigt | In CLAUDE.md referenziert, unterstützt einen aktiven Befehl oder passt zum aktuellen Projekttyp | Behalten |
| Manchmal benötigt | Domänenspezifisch (z. B. Sprachmuster), nicht in CLAUDE.md referenziert | Über bedarfsgesteuerte Aktivierung nachdenken |
| Selten benötigt | Keine Befehlsreferenz, überlappender Inhalt oder keine offensichtliche Projektübereinstimmung | Entfernen oder Lazy-Loading |
Phase 3: Probleme erkennen
Identifiziere die folgenden Problem-Muster:
- Aufgeblähte Agentenbeschreibungen — Beschreibung >30 Wörter in der Frontmatter wird bei jedem Task-Tool-Aufruf geladen
- Schwere Agents — Dateien >200 Zeilen blähen den Task-Tool-Context bei jedem Spawn auf
- Redundante Komponenten — Skills, die Agentenlogik duplizieren, Regeln, die CLAUDE.md duplizieren
- MCP-Überabonnement — >10 Server oder Server, die CLI-Tools kapseln, die kostenlos verfügbar sind
- CLAUDE.md-Bloat — ausführliche Erklärungen, veraltete Abschnitte, Anweisungen, die Regeln sein sollten
Phase 4: Bericht erstellen
Erstelle den Context-Budget-Bericht:
Context Budget Report
═══════════════════════════════════════
Geschätzter Gesamt-Overhead: ~XX.XXX Tokens
Context-Modell: Claude Sonnet (200K Fenster)
Effektiv verfügbarer Context: ~XXX.XXX Tokens (XX%)
Komponentenaufschlüsselung:
┌─────────────────┬────────┬───────────┐
│ Komponente │ Anzahl │ Tokens │
├─────────────────┼────────┼───────────┤
│ Agents │ N │ ~X.XXX │
│ Skills │ N │ ~X.XXX │
│ Regeln │ N │ ~X.XXX │
│ MCP-Tools │ N │ ~XX.XXX │
│ CLAUDE.md │ N │ ~X.XXX │
└─────────────────┴────────┴───────────┘
WARNUNG: Gefundene Probleme (N):
[nach Tokeneinsparungen sortiert]
Top 3 Optimierungen:
1. [Aktion] → spare ~X.XXX Tokens
2. [Aktion] → spare ~X.XXX Tokens
3. [Aktion] → spare ~X.XXX Tokens
Mögliche Einsparungen: ~XX.XXX Tokens (XX% des aktuellen Overheads)
Im ausführlichen Modus werden zusätzlich Tokenanzahlen pro Datei, eine zeilenweise Aufschlüsselung der schwersten Dateien, spezifische redundante Zeilen zwischen überlappenden Komponenten und die MCP-Tool-Liste mit geschätzten Schema-Größen pro Tool ausgegeben.
Beispiele
Basis-Audit
Benutzer: /context-budget
Skill: Scannt Setup → 16 Agents (12.400 Tokens), 28 Skills (6.200), 87 MCP-Tools (43.500), 2 CLAUDE.md (1.200)
Markiert: 3 schwere Agents, 14 MCP-Server (3 CLI-ersetzbar)
Top-Einsparung: 3 MCP-Server entfernen → -27.500 Tokens (47% Overhead-Reduzierung)
Ausführlicher Modus
Benutzer: /context-budget --verbose
Skill: Vollständiger Bericht + Aufschlüsselung pro Datei mit planner.md (213 Zeilen, 1.840 Tokens),
MCP-Tool-Liste mit Größen pro Tool, doppelte Regelzeilen nebeneinander
Prüfung vor Erweiterung
Benutzer: Ich möchte 5 weitere MCP-Server hinzufügen, habe ich Platz?
Skill: Aktueller Overhead 33% → Hinzufügen von 5 Servern (~50 Tools) würde ~25.000 Tokens hinzufügen → steigt auf 45% Overhead
Empfehlung: zuerst 2 CLI-ersetzbare Server entfernen, um unter 40% zu bleiben
Best Practices
- Tokenschätzung: verwende
Wörter × 1,3für Prosa,Zeichen / 4für code-lastige Dateien - MCP ist der größte Hebel: jedes Tool-Schema kostet ~500 Tokens; ein Server mit 30 Tools kostet mehr als alle deine Skills zusammen
- Agentenbeschreibungen werden immer geladen: selbst wenn der Agent nie aufgerufen wird, ist sein Beschreibungsfeld in jedem Task-Tool-Context vorhanden
- Ausführlicher Modus zum Debuggen: verwende ihn, um die genauen Dateien zu identifizieren, die den Overhead verursachen, nicht für regelmäßige Audits
- Audit nach Änderungen: führe ihn nach dem Hinzufügen von Agents, Skills oder MCP-Servern aus, um ein frühzeitiges Anwachsen zu erkennen