Benjamin410/claude-mods/tree/main/mods/token-usage
token-usage
Claude-Code-Mod, der den Token-Verbrauch der letzten 7 Tage im Vergleich zur Plan-Auslastung (5h- und 7-Tage-Fenster) anzeigt – inkl. Sparkline in der Statusleiste, /tokens-Pane, API-Preisvergleich und Modell-Aufschlüsselung.
About this mod
Der Mod liest die lokalen Transkripte unter ~/.claude/projects/**/*.jsonl (bzw. $CLAUDE_CONFIG_DIR) und zeigt den Token-Verbrauch der letzten 7 Tage an. In der Leiste oberhalb der Eingabe erscheint ein 7-Tage-Verlauf als Sparkline mit Summe und Plan-Auslastung in Prozent (5h/7T, grün/gelb/rot ab 70/90 %), Reset-Zeitpunkt und Tokens je 1 % Plan. „Details“ bzw. /tokens öffnet ein Pane mit Balken je Tag, Summe (ohne/mit Cache-Reads), Aufteilung Input/Output/Cache und Verbrauch je Modell. Zusätzlich wird berechnet, was derselbe Verbrauch nach API-Listenpreis in USD gekostet hätte (je Modell, inkl. Cache-Write 5 min/1 h, Cache-Read und Fast Mode), in der Leiste als 7-Tage-Summe und im Pane je Tag, je Modell und seit Beginn des Plan-Fensters; die Preistabelle liegt in hooks/pricing.ts. Die Plan-Auslastung für 5-Stunden- und 7-Tage-Fenster wird aus der letzten API-Antwort übernommen (nur mit Abo-Login) und sitzungsübergreifend gespeichert. Vergleich: Tokens seit Beginn des aktuellen 7-Tage-Plan-Fensters gegen dessen Prozentwert, daraus Tokens je 1 % und eine Hochrechnung bis 100 %. Transkripte werden beim Start und alle 10 Minuten neu eingelesen. Grenzen: Tokens stammen nur aus den lokalen Transkripten dieses Geräts, der Plan-Prozentwert zählt dagegen alle Geräte und Oberflächen, die Hochrechnung ist daher eine Untergrenze/Schätzung; der Plan gewichtet Modelle und Cache-Tokens anders als eine reine Token-Summe; Transkripte über 4 MiB werden per grep gefiltert gelesen (unter Windows ohne grep übersprungen). Installation: Repository klonen, install.sh ausführen, zum Aktualisieren pull + /reload-plugins; zum Testen claude --plugin-dir ~/claude-mods/mods/token-usage oder CLAUDE_CODE_PLUGIN_DIRS in ~/.claude/settings.json setzen. Prüfen mit claude plugin validate mods/token-usage und claude plugin test mods/token-usage.
Installation
Check the author's README for the marketplace and plugin name first. Commands may change as the repository evolves.
claude plugin marketplace add Benjamin410/claude-mods claude plugin install token-usage
Original text / README
claude-mods
Eigene Claude-Code-Mods (Plugins mit Function-Hooks), privat geteilt ueber alle Geraete.
Das Repo ist zugleich ein Plugin-Marketplace (.claude-plugin/marketplace.json).
Einrichten auf einem Geraet
git clone [email protected]:<dein-user>/claude-mods.git ~/claude-mods
~/claude-mods/install.sh
Aktualisieren: git -C ~/claude-mods pull, danach in einer laufenden Sitzung /reload-plugins.
Nur fuer eine Sitzung testen, ohne Installation: claude --plugin-dir ~/claude-mods/mods/token-usage.
Fuer Desktop-App/SDK-Sitzungen alternativ CLAUDE_CODE_PLUGIN_DIRS im env-Block von
~/.claude/settings.json auf die Mod-Ordner setzen.
Mods
token-usage
Zeigt den Token-Verbrauch der letzten 7 Tage im Vergleich zur Plan-Auslastung.
- Leiste oberhalb der Eingabe: Verlauf der 7 Tage als Sparkline, Summe, Plan 5h/7T in Prozent (gruen/gelb/rot ab 70/90 %), Reset-Zeitpunkt und Tokens je 1 % Plan. Knopf „Details“.
- „Details“ bzw.
/tokensoeffnet ein Pane: Balken je Tag, Summe (ohne/mit Cache-Reads), Aufteilung Input/Output/Cache, Verbrauch je Modell. - API-Preis: was derselbe Verbrauch nach API-Listenpreis in USD gekostet haette (je Modell, inkl.
Cache-Write 5 min/1 h, Cache-Read und Fast Mode), in der Leiste als Summe der 7 Tage, im Pane je
Tag, je Modell und seit Beginn des Plan-Fensters. Preistabelle:
hooks/pricing.ts. - Plan-Auslastung: 5-Stunden- und 7-Tage-Fenster in Prozent mit Reset-Zeitpunkt, so wie die letzte API-Antwort sie meldet (nur mit Abo-Login, nicht mit API-Key). Der letzte Stand wird sitzungsuebergreifend gespeichert.
- Vergleich: Tokens seit Beginn des aktuellen 7-Tage-Plan-Fensters gegen dessen Prozentwert, daraus Tokens je 1 % und eine Hochrechnung bis 100 %.
- Transkripte werden beim Start und alle 10 Minuten neu eingelesen.
Grenzen:
- Tokens stammen aus den lokalen Transkripten (
~/.claude/projects/**/*.jsonl, bzw.$CLAUDE_CONFIG_DIR) dieses Geraets. Der Plan-Prozentwert zaehlt dagegen alle Geraete und Oberflaechen (claude.ai, Cloud-Sitzungen). Die Hochrechnung ist daher eine Untergrenze/Schaetzung. - Der Plan gewichtet Modelle und Cache-Tokens anders als eine reine Token-Summe; als Vergleichsbasis dienen Tokens ohne Cache-Reads.
- Transkripte ueber 4 MiB werden per
grepgefiltert gelesen (unter Windows ohne grep uebersprungen).
Pruefen: claude plugin validate mods/token-usage und claude plugin test mods/token-usage.

