1. Das Problem: AI-Kosten im Blick behalten
Wer Claude Code intensiv nutzt, kennt das Problem: Die Token-Limits sind ein ständiger Begleiter. Je nach Tarif kriegst du bis zu 880.000 Token pro 5-Stunden-Fenster – eine Session. Im Peak sind das 50 Sessions pro Monat. Die entscheidende Frage war also immer: Wie ist der aktuelle Stand meines Kontingents?
⚠️ Die Überraschung: Claude's Logs sind unvollständig!
Nach tagelanger Frustration kam die Erkenntnis: Claude meldet "50% erreicht, wechsle zu Sonnet" bei 440k Tokens, aber die Logs zeigen nur 200-340k. Nach intensiver Analyse stellte sich heraus: ~47% der Tokens fehlen in den JSONL-Logs!
🚨 Was ich wissen wollte:
- Wann beginnt die neue 5-Stunden-Session?
- Wie viele Tokens habe ich noch (ungefähr)?
- Welche AI nutze ich gerade? (Opus oder Sonnet)
- Ab 50% Token-Nutzung wirst du in den default Einstellungen erstmal auf Sonnet zurückgestuft!
- Wie viele Sessions habe ich diesen Monat schon verbraucht?
Also entschied ich: Ich baue mir mein eigenes Monitoring-Tool. Aber nicht irgendein langweiliges Script - es sollte Style haben, im Terminal laufen und mich mit einem Blick informieren!
2. Die Idee: Terminal-Tool mit Style
Design-Prinzipien:
- Cyberpunk-Ästhetik: Neon-Grün auf Schwarz
- ASCII-Art: Weil Terminal-Tools mit ASCII einfach cooler sind
- Übersichtlichkeit: Alle wichtigen Infos auf einen Blick
- Echtzeit-Updates: Live-Refresh alle 3 Sekunden
- Wolf-Branding: Der WolfCoder ASCII-Wolf darf nicht fehlen!
Die Vision war klar: Ein Tool, das ich im Terminal laufen lasse und das mir sofort zeigt, wo ich stehe. Mit Farben, die den Status signalisieren, und genug Details für fundierte Entscheidungen.
3. Tech Stack & Design
🛠️ Technologie-Stack:
- Python 3.8+ - Die Basis
- ANSI Escape Codes - Flackerfreie Terminal-Grafik
- Click - CLI Framework
- TOML - Konfigurationsdateien
- PyInstaller - Standalone Executables
- wcwidth - Unicode-Breiten-Berechnung
🎨 Design-Elemente:
- Box-Drawing Characters - Für die UI-Rahmen
- Progress Bars - Visuelles Token-Level
- Farbcodierung - Grün/Gelb/Rot Status
- ASCII Wolf - Das Markenzeichen
- Live Clock - Echtzeit-Updates
- Responsive Layout - Passt sich an Terminal an
✅ Warum ANSI Codes statt Frameworks?
Erste Version nutzte Rich Framework - sah geil aus, flackerte aber bei jedem Update. Die Lösung: Kompletter Rewrite mit reinen ANSI Escape Codes. Kein Framework-Overhead = butterweiche Updates ohne Flackern!
4. Features im Detail
⚠️ Switch-Warnsystem (NEU!)
Das größte Problem war gelöst: Der Monitor warnt dich rechtzeitig vor dem Opus→Sonnet Switch:
- Lernt aus deiner Historie: Analysiert vergangene Switches
- Berechnet Korrekturfaktor: Typisch 1.24-1.29 (24-29% fehlende Tokens)
- Mehrstufige Warnungen: 77% (gelb), 90% (rot), 95% (kritisch)
- Model-Erkennung: Zeigt aktuelles Modell (OPUS/SONNET) im Timer
📊 Hybrid Token-Tracking
Zwei Systeme arbeiten zusammen für maximale Genauigkeit:
- Smart Sessions: Erkennt Claude's 5-Stunden-Resets automatisch
- Rolling Window: Berechnet gewichtete Tokens präzise
- Korrektur-System: Kompensiert fehlende ~47% Tokens
- Multi-Plan Support: Pro (44k), Max5 (220k), Max20 (880k)
💰 Kosten-Tracking
Zeigt dir nicht nur die Kosten, sondern auch was du sparst:
- Session-, Tages- und Monatskosten
- Hochrechnung basierend auf 7-Tage-Durchschnitt
- Vergleich mit API-Kosten (was wäre teurer)
- Budget-Warnungen bei hohen Ausgaben
📁 Export-Funktionen
Daten für weitere Analyse exportieren:
- JSON Export für Automatisierung
- CSV Export für Excel/Sheets
- Historische Daten sammeln
📐 Adaptive Terminal-Layouts
Passt sich automatisch an deine Terminalgröße an:
- Normal Layout: Volle Details bei >120 Zeichen Breite
- Compact Layout: Optimiert für 80-119 Zeichen
- Very Compact: Minimale Ansicht für <80 Zeichen
- ANSI-aware Formatting für perfekte Box-Ausrichtung
5. Die Implementierung
Code-Struktur:
wolfcoder-claude-monitor/
├── src/
│ ├── monitor.py # Haupt-Monitoring-Logik
│ ├── ui.py # Rich UI Komponenten
│ ├── api_client.py # Claude API Integration
│ ├── config.py # Konfiguration
│ └── utils.py # Helper-Funktionen
├── assets/
│ └── ascii_wolf.txt # ASCII-Art Wolf
├── config.toml # User-Konfiguration
├── requirements.txt # Dependencies
└── build.py # PyInstaller Build-ScriptDie Architektur ist modular aufgebaut: Die API-Client-Klasse handled die Kommunikation mit Claude, die UI-Klasse baut das Terminal-Interface mit Rich auf, und der Monitor orchestriert alles zusammen.
💡 Pro-Tipp: ANSI-aware Formatting
Mit reinen ANSI Escape Codes hat man volle Kontrolle über das Terminal. Die Herausforderung: Box-Alignment trotz Farben und Emojis korrekt zu berechnen. wcwidth hilft dabei, die tatsächliche Breite von Unicode-Zeichen zu ermitteln!
6. Zukunftspläne
🚀 Geplante Features:
- Historische Graphen (7/30 Tage)
- Multi-Account Support
- Webhook-Notifications bei Limits
- Docker Container Version
- Web-Dashboard (optional)
- Andere AI-Provider (OpenAI, Gemini)
- Cost-Optimizer Vorschläge
- Team-Sharing Features
- Plugin-System für Erweiterungen
- Mobile App (Terminal Emulator)
Das Tool ist Open Source und lebt von der Community. Pull Requests sind willkommen! Besonders interessant wären Integrationen für andere AI-Services.
7. Fazit & Download
✅ Was das Tool kann:
- Echtzeit Token-Monitoring für Claude AI
- Burn-Rate und Prognosen
- Stylisches Terminal UI im Cyberpunk-Look
- Export-Funktionen für weitere Analyse
- Komplett offline nach Initial-Setup
Der Wolfcoder Claude Monitor ist mein täglicher Begleiter geworden. Kein böses Erwachen mehr, wenn plötzlich das Token-Limit erreicht ist. Stattdessen habe ich immer im Blick, wo ich stehe und kann meine AI-Nutzung optimieren.
PS: Ja, dieser Blogartikel wurde teilweise mit Claude geschrieben. Der Monitor zeigt mir gerade: Noch 487,395 Token Reserve. Alles im grünen Bereich! 🟢