ClaudeMods
☰
EN
● 0 online · Views 0 times
SponsorsSubmit a project
GitHub repositories · by Benjamin410

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.

Benjamin410@Benjamin410

Benjamin410/claude-mods/tree/main/mods/token-usage

Translated

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. /tokens oeffnet 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 grep gefiltert gelesen (unter Windows ohne grep uebersprungen).

Pruefen: claude plugin validate mods/token-usage und claude plugin test mods/token-usage.

Similar projects