# ccusage – Claude Code Nutzung analysieren
## Was ist ccusage?
CLI-Tool zur Analyse von Token-Verbrauch und geschätzten Kosten aus lokalen JSONL-Dateien von Claude Code und anderen Coding-Agents.
Entwickelt von [ryoppippi](https://github.com/ryoppippi/ccusage) (Open Source).
## Installation & Aufruf
Keine globale Installation nötig – direkt per `npx` ausführen:
```bash
npx ccusage@latest
```
Alternativ:
```bash
bunx ccusage # empfohlen (schneller)
pnpm dlx ccusage # falls pnpm genutzt wird
```
Globale Installation (optional):
```bash
npm install -g ccusage
```
> Voraussetzung: Node.js 22+
## Befehle & Ansichten
| Befehl | Beschreibung |
|--------|-------------|
| `ccusage` | Tagesübersicht (Standard) |
| `ccusage --monthly` | Monatsübersicht |
| `ccusage --session` | Nach Session gruppiert |
| `ccusage --window` | 5-Stunden Abrechnungsfenster |
| `ccusage --json` | JSON-Ausgabe |
### Nützliche Optionen
| Option | Beschreibung |
|--------|-------------|
| `--from YYYY-MM-DD` | Ab Datum filtern |
| `--to YYYY-MM-DD` | Bis Datum filtern |
| `--model` | Aufschlüsselung pro Modell |
| `--timezone Europe/Berlin` | Zeitzone setzen |
## Unterstützte Tools
Neben Claude Code werden auch analysiert:
Codex, OpenCode, Amp, Droid, CodeBuff, Hermes Agent, Goose, OpenClaw, Kilo, Kimi, Qwen, GitHub Copilot CLI, Gemini CLI
## Funktionsweise
ccusage liest die lokalen JSONL-Session-Dateien, die Claude Code automatisch speichert (z.B. unter `~/.claude/projects/`), und berechnet daraus:
- Verbrauchte Tokens (Input, Output, Cache)
- Geschätzte Kosten pro Tag/Monat/Session
- Cache Creation vs. Cache Read (getrennt ausgewiesen)
## Links
- [GitHub Repository](https://github.com/ryoppippi/ccusage)
- [Dokumentation](https://ccusage.com/)
- [npm Package](https://www.npmjs.com/package/ccusage)
---
*Erstellt: 2026-06-09*