GitHub 儲存庫 · 發布者 Benjamin410

token-usage

Name: token-usage
Author: Benjamin410

Claude Code 外掛，顯示最近 7 天的 Token 用量與方案使用量（5 小時和 7 天視窗），包括狀態列中的 Sparkline、/tokens 面板、API 價格比較和模型明細。

Benjamin410@Benjamin410

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

已翻譯

關於這個 mod

此外掛會讀取 ~/.claude/projects/**/*.jsonl（或 $CLAUDE_CONFIG_DIR）下的本機逐字稿，顯示最近 7 天的 Token 用量。提示列上方的狀態列會顯示 7 天趨勢 Sparkline、總量和方案使用百分比（5h/7T，70/90% 起分別為綠/黃/紅）、重設時間，以及每 1% 方案額度對應的 Token 數量。/tokens 會開啟面板，顯示每天的長條圖、總量（不含/含快取讀取）、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 的權重不同於單純的 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.