ccusage ist der Zähler, den jeder intensive Agenten-Nutzer laufen lassen sollte, sofern er die Dollar-Spalte als das liest, was die Arbeit über die API gekostet hätte, nicht als das, was er bezahlt hat. Wir bewerten es mit 4.4 von 5.

Kostenlos und Open Source (MIT).

Welche Nachteile hat ccusage?

Kosten sind API-äquivalente Schätzungen ohne Websuche; Historie begrenzt auf das, was der Agent auf der Festplatte behält (bei Claude Code standardmäßig 30 Tage); Kein Team- oder Server-Modus.

Was kostet ccusage für ein Team oder im Produktivbetrieb?

Kostenlos, ohne kostenpflichtige Edition; finanziert über Sponsoren. Der einzige Aufwand ist, es auf jedem Rechner laufen zu lassen, der mitgezählt werden soll.

Ist ccusage sicher für Firmendaten?

Die Analyse ist lokal, und Nutzungsdaten werden laut Doku nicht hochgeladen; Preisdaten werden abgerufen und zwischengespeichert, solange du nicht --offline übergibst. MIT-Lizenz, kommerzielle Nutzung also uneingeschränkt.

Was sind die besten Alternativen zu ccusage?

Die nächsten Alternativen, die wir getestet haben, sind rtk (Rust Token Killer), Claude Code Router und mindwalk.

ccusage GitHub-Repo im Test (2026)

Was ist ccusage?

ccusage liest die Nutzungslogs, die Claude Code und andere Agenten-CLIs auf deinem Rechner ablegen, und weist Tokens und geschätzte Kosten pro Tag, Woche, Monat oder Session aus. Für Claude Code zeigt es außerdem die 5-Stunden-Abrechnungsblöcke in einer Live-Ansicht und bietet eine kompakte Statusline (in Beta) für die Statusleiste von Claude Code.

Es läuft mit `npx ccusage@latest` (oder bunx, pnpm dlx, Nix) und braucht weder Konto noch API-Key. Das README nennt 18 Quellen, darunter Claude Code, Codex, OpenCode, Amp, Goose, Kilo, Gemini CLI und GitHub Copilot CLI. Die Preise stammen von LiteLLM, models.dev und eingebauten historischen Preistabellen, lokal zwischengespeichert, mit einem `--offline`-Modus.

Lohnt sich ccusage?

ccusage ist zum Standard-Zähler für die lokale Nutzung von Coding-Agenten geworden. Es hat rund 19.100 GitHub-Sterne, npm zählte in den 30 Tagen bis zum 18. Oktober 2026 etwa 871.000 Downloads, und es erscheinen fast täglich neue Versionen: von v20.0.34 am 15. Oktober bis v20.0.41 am 22. Oktober. Gestartet hat es ryoppippi, inzwischen liegt es unter einer ccusage-Organisation, und die Codebasis ist Rust, weiterhin über npm verteilt.

Die Kostenspalte musst du genau lesen. Im Standardmodus auto nutzt es den costUSD-Wert, den Claude Code speichert, wo vorhanden, und multipliziert sonst Tokens mit veröffentlichten Preisen pro Token. Die Doku sagt klar, dass die Kosten "may not reflect actual billing" und dass Tool-Aufrufe wie die Websuche nicht enthalten sind. Mit einem Pro- oder Max-Abo ist die Zahl nicht deine Rechnung, sondern das, was dieselbe Arbeit zu Pay-as-you-go-Tarifen gekostet hätte.

Die weniger offensichtliche Grenze ist die Historie. Claude Code behält lokale Transkripte standardmäßig 30 Tage (die Einstellung cleanupPeriodDays), und ccusage kann nur zählen, was noch auf der Festplatte liegt. Wer einen Quartalstrend sehen will, muss diese Einstellung vorher erhöhen oder regelmäßig `--json`-Snapshots exportieren.

Nutzungsdaten verlassen laut Doku nie den Rechner, aber standardmäßig aktualisiert ccusage seinen Preis-Cache über das Netzwerk; `--offline` unterbindet das. Die Berichte trennen Input-, Output-, Cache-Creation- und Cache-Read-Tokens pro Modell. Genau diese Aufschlüsselung brauchst du, um zu erkennen, ob eine Änderung beim Prompt Caching oder ein Plugin zum Token-Sparen tatsächlich geholfen hat.

Der Rahmen ist ein einzelner Rechner. Einen dokumentierten Server oder eine Team-Ansicht gibt es nicht. Ein Manager, der zehn Entwickler vergleicht, sammelt und summiert also zehn JSON-Dateien von Hand, und jede ist nur so vollständig wie die Log-Aufbewahrung auf diesem Laptop.

Wo es sich lohnt

Ein Entwickler, der ein Plugin zum Token-Sparen wie RTK testet
Belegen, ob es den Verbrauch tatsächlich senkt
Lass `ccusage daily --json` eine Woche vor und eine Woche nach der Installation laufen und vergleiche Input- und Cache-Read-Tokens pro Modell. Dauert Minuten und kostet nichts; der Vergleich ist nur so fair wie die Arbeitslast der beiden Wochen.
Ein Engineering-Manager, der Claude Max-Plätze bezahlt
Entscheiden, ob ein Wechsel des Teams zur API-Abrechnung günstiger wäre
Jeder Entwickler führt `ccusage monthly --json` aus und teilt die Datei; die Summen zeigen, was dieselbe Nutzung zu API-Tarifen kosten würde. Weil es keine gemeinsame Ansicht gibt, ist das Sammeln und Summieren der Dateien Handarbeit.
Eine freiberufliche Entwicklerin, die mehrere Kunden abrechnet
Agenten-Ausgaben dem jeweiligen Kundenprojekt zuordnen
`ccusage claude daily --instances --project <name>` gruppiert die Nutzung von Claude Code nach Projekt; die API-äquivalente Zahl ist ein vertretbarer Rechnungsposten, wenn der Vertrag Tools zum Selbstkostenpreis abrechnet.

Bevor du dich festlegst

Einrichtung: `npx ccusage@latest` gibt in Sekunden einen Tagesbericht aus; bunx speichert das Paket zwischen, sodass wiederholte Läufe schneller sind. Füge `ccusage statusline` in den Statusline-Hook von Claude Code ein, um eine Live-Zahl zu sehen.
Integrationen: Liest lokale Logs von 18 Agenten-CLIs, darunter Claude Code (~/.claude und ~/.config/claude/projects), Codex, OpenCode, Gemini CLI und Copilot CLI; gibt Tabellen oder JSON aus; Preisüberschreibungen gehören in ccusage.json.
Daten und Datenschutz: Die Analyse ist lokal, und Nutzungsdaten werden laut Doku nicht hochgeladen; Preisdaten werden abgerufen und zwischengespeichert, solange du nicht --offline übergibst. MIT-Lizenz, kommerzielle Nutzung also uneingeschränkt.
Kosten im großen Maßstab: Kostenlos, ohne kostenpflichtige Edition; finanziert über Sponsoren. Der einzige Aufwand ist, es auf jedem Rechner laufen zu lassen, der mitgezählt werden soll.
Grenzen: Dollarbeträge sind Schätzungen ohne Websuche; Claude Code löscht Transkripte nach 30 Tagen, wenn cleanupPeriodDays nicht erhöht wird; keine Team-Aggregation. Bei der letzten Prüfung nur 4 offene Issues.

Was gut ist

Vollständig lokale Berichte ohne Konto
18 Agenten-CLIs in einem Bericht
Trennt Cache-Creation- und Cache-Read-Tokens pro Modell
Ansicht nach 5-Stunden-Blöcken, Statusline und --json-Ausgabe

Was nicht

Kosten sind API-äquivalente Schätzungen ohne Websuche
Historie begrenzt auf das, was der Agent auf der Festplatte behält (bei Claude Code standardmäßig 30 Tage)
Kein Team- oder Server-Modus

Am besten für

Alle, die ihren Token-Verbrauch über Agenten-Sessions hinweg verfolgen oder vergleichen wollen.

Alternativen zu ccusage

rtk (Rust Token Killer)

Skills & pluginsRust85k stars

3.4/5

Rust CLI proxy whose hook rewrites agent shell commands to compress their output; a JetBrains benchmark found no bill savings.

Claude Code Router

Skills & pluginsTypeScript38k stars

4.0/5

Local gateway that routes Claude Code, Codex and other agents to any model provider, with fallbacks, key pools and cost logs.

mindwalk

Skills & pluginsGo1.4k stars

3.6/5

Local Go tool that replays Claude Code, Codex and pi sessions as light moving across a 3D map of your repository.

ccusage: häufige Fragen

Lohnt sich ccusage?: ccusage ist der Zähler, den jeder intensive Agenten-Nutzer laufen lassen sollte, sofern er die Dollar-Spalte als das liest, was die Arbeit über die API gekostet hätte, nicht als das, was er bezahlt hat. Wir bewerten es mit 4.4 von 5.
Was kostet ccusage?: Kostenlos und Open Source (MIT).
Welche Nachteile hat ccusage?: Kosten sind API-äquivalente Schätzungen ohne Websuche; Historie begrenzt auf das, was der Agent auf der Festplatte behält (bei Claude Code standardmäßig 30 Tage); Kein Team- oder Server-Modus.
Für wen eignet sich ccusage?: Alle, die ihren Token-Verbrauch über Agenten-Sessions hinweg verfolgen oder vergleichen wollen.
Was kostet ccusage für ein Team oder im Produktivbetrieb?: Kostenlos, ohne kostenpflichtige Edition; finanziert über Sponsoren. Der einzige Aufwand ist, es auf jedem Rechner laufen zu lassen, der mitgezählt werden soll.
Ist ccusage sicher für Firmendaten?: Die Analyse ist lokal, und Nutzungsdaten werden laut Doku nicht hochgeladen; Preisdaten werden abgerufen und zwischengespeichert, solange du nicht --offline übergibst. MIT-Lizenz, kommerzielle Nutzung also uneingeschränkt.
Was sind die besten Alternativen zu ccusage?: Die nächsten Alternativen, die wir getestet haben, sind rtk (Rust Token Killer), Claude Code Router und mindwalk.

Antworten geprüft am 23. Okt. 2026.