Context Budget
Analysiere den Token-Overhead jeder geladenen Komponente in einer Claude Code Sitzung und decke umsetzbare Optimierungen auf, um Kontextspeicherplatz zurückzugewinnen.
Wann verwenden
- Die Sitzungsleistung 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 Kontextspielraum du tatsächlich hast
- Du planst, weitere Komponenten hinzuzufügen und musst wissen, ob noch Platz ist
- Ausführen des Befehls
/context-budget(diese Skill unterstützt ihn)
Funktionsweise
Phase 1: Bestandsaufnahme
Scanne alle Komponentenverzeichnisse und schätze den Tokenverbrauch:
Agents (agents/*.md)
- Zähle Zeilen und Tokens pro Datei (Wörter × 1,3)
- Extrahiere Länge der
descriptionFrontmatter - Markieren: Dateien >200 Zeilen (schwer), Beschreibung >30 Wörter (aufgeblähte Frontmatter)
Skills (skills/*/SKILL.md)
- Zähle Tokens pro SKILL.md
- Markieren: Dateien >400 Zeilen
- Prüfe auf doppelte Kopien in
.agents/skills/– überspringe identische Kopien, um Doppelzählung zu vermeiden
Regeln (rules/**/*.md)
- Zähle Tokens pro Datei
- Markieren: 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 Gesamtzahl der Tools
- Schätze Schema-Overhead mit ~500 Tokens pro Tool
- Markieren: Server mit >20 Tools, Server die einfache CLI-Befehle wrappen (
gh,git,npm,supabase,vercel)
CLAUDE.md (Projekt- und Benutzerebene)
- Zähle Tokens pro Datei in der CLAUDE.md-Kette
- Markieren: Gesamtsumme >300 Zeilen
Phase 2: Klassifizieren
Ordne jede Komponente einem Eimer zu:
| Eimer | Kriterium | Aktion |
|---|---|---|
| Immer benötigt | Referenziert in CLAUDE.md, unterstützt einen aktiven Befehl oder entspricht aktuellem 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-Load |
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-Kontext bei jedem Start auf
- Redundante Komponenten – Skills, die Agentenlogik duplizieren, Regeln, die CLAUDE.md duplizieren
- MCP-Überabonnement – >10 Server oder Server, die CLI-Tools wrappen, die kostenlos verfügbar sind
- CLAUDE.md-Blahung – Ausführliche Erklärungen, veraltete Abschnitte, Anweisungen, die Regeln sein sollten
Phase 4: Bericht
Erstelle den Context Budget Bericht:
Context Budget Bericht
═══════════════════════════════════════
Geschätzter Gesamt-Overhead: ~XX,XXX Tokens
Kontextmodell: Claude Sonnet (200K Fenster)
Effektiv verfügbarer Kontext: ~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 Tokeneinsparung geordnet]
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 zusätzlich ausgeben: Tokenanzahl pro Datei, zeilenweise Aufschlüsselung der schwersten Dateien, spezifische redundante Zeilen zwischen überlappenden Komponenten und MCP-Tool-Liste mit geschätzter Schemagröße pro Tool.
Beispiele
Einfache Prüfung
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)
Größte Einsparung: 3 MCP-Server entfernen → -27.500 Tokens (47% Overhead-Reduktion)
Ausführlicher Modus
Benutzer: /context-budget --verbose
Skill: Vollständiger Bericht + Aufschlüsselung pro Datei, die planner.md (213 Zeilen, 1.840 Tokens) zeigt,
MCP-Tool-Liste mit Größen pro Tool, duplizierte 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-Kontext vorhanden
- Ausführlicher Modus zum Debuggen: verwende ihn, wenn du die genauen Dateien identifizieren musst, die den Overhead verursachen, nicht für regelmäßige Prüfungen
- Prüfung nach Änderungen: führe sie nach dem Hinzufügen von Agenten, Skills oder MCP-Servern aus, um ein frühzeitiges Anwachsen zu erkennen