2026-08-11 · 13 Min. Lesezeit · tikr
tikr: ich habe mir selbst über meine Token-Verbrennung gelogen
Lokales, verschlüsseltes, append-only Usage-Tracking für Claude Code, Codex und Copilot CLI — und der 2.2x-Doppelzähl-Bug.
Ich laufe Claude Code viel. Irgendwann war „keine Ahnung, was das in API-Dollars kostet“ nicht mehr witzig.
Cloud-Dashboards sind langsam, unvollständig oder nicht für die Tools, die ich wirklich nutze. Also baute ich tikr: ein lokales Token-Ledger. Nichts wird irgendwohin geschickt. MIT. Solo.
Das Problem der meisten Tracker
Claude Code löscht alte Transcripts (cleanupPeriodDays, default 30). Jedes Tool, das „wie viel habe ich genutzt?“ mit aktuellen Dateien auf Disk beantwortet, meldet eine Zahl, die mit der Zeit fällt.
tikr ist ein eigenes append-only Ledger. Transcript einmal lesen ab Byte-Offset. Gelöschte Transcripts subtrahieren nie.
Der 2.2x-Bug
Eine API-Message wird zu mehreren JSONL-Einträgen. Jeder trägt eine volle Kopie von message.usage.
Naive Summe → Output-Tokens ~2.2x aufgeblasen.
Fix: Deduplizierung per message.id. Innerhalb einer Message max pro Feld, nie summieren.
Open source
github.com/mubashirjamali101/tikr
curl -fsSL https://raw.githubusercontent.com/mubashirjamali101/tikr/main/install.sh | bash
tikr start
tikr stats