GitHub リポジトリ · 投稿者 Benjamin410

token-usage

Name: token-usage
Author: Benjamin410

直近 7 日間の Token 使用量をプラン使用率（5 時間・7 日ウィンドウ）と比較して表示する Claude Code mod。ステータスバーの Sparkline、/tokens ペイン、API 価格比較、モデル別内訳を含みます。

Benjamin410@Benjamin410

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

翻訳済み

この mod について

この mod は ~/.claude/projects/**/*.jsonl（または $CLAUDE_CONFIG_DIR）にあるローカルのトランスクリプトを読み、直近 7 日間の Token 使用量を表示します。入力欄の上のステータスバーには 7 日間の推移を Sparkline で示し、合計、プラン使用率（5h/7T、70/90% から緑/黄/赤）、リセット時刻、プラン 1% あたりの Token 数を表示します。/tokens は日ごとの棒、合計（Cache-Read なし/あり）、Input/Output/Cache の内訳、モデル別の使用量を表示するペインを開きます。同じ使用量を API 公開価格で USD 換算した金額も計算します（モデル別、5 min/1 h の Cache-Write、Cache-Read、Fast Mode を含む）。ステータスバーには 7 日合計、ペインには日別・モデル別・プランウィンドウ開始以降の金額を表示し、価格表は hooks/pricing.ts にあります。5 時間と 7 日ウィンドウのプラン使用率は直近の API 応答から取得し（サブスクリプションログイン時のみ）、セッションをまたいで保存します。現在の 7 日プランウィンドウ開始後の Token と割合を比較し、1% あたりの Token 数と 100% までの推定を計算します。起動時と 10 分ごとにトランスクリプトを再読み込みます。制限：Token はこの端末のローカル記録だけで、プランの割合はすべての端末とサーフェスを数えるため、推定は下限/概算です。プランはモデルとキャッシュ Token を単純な合計とは異なる重みで扱います。4 MiB を超えるトランスクリプトは grep で絞り込んで読み（Windows で grep がなければスキップ）、インストールはリポジトリをクローンして install.sh を実行します。更新は pull + /reload-plugins、テストは claude --plugin-dir ~/claude-mods/mods/token-usage または ~/.claude/settings.json の CLAUDE_CODE_PLUGIN_DIRS で行い、claude plugin validate mods/token-usage と claude plugin test mods/token-usage で確認します。

インストール

まず作者の README で marketplace とプラグイン名を確認してください。コマンドはリポジトリの構成によって変わる場合があります。

claude plugin marketplace add Benjamin410/claude-mods
claude plugin install token-usage

原文 / 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.