GitHub 仓库 · 发布者 Benjamin410

token-usage

Name: token-usage
Author: Benjamin410

Claude Code mod，显示最近 7 天的 Token 消耗与套餐使用量（5 小时和 7 天窗口），包括状态栏中的 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 会打开一个面板，显示每天的柱状图、总量（不含/含缓存读取）、Input/Output/Cache 分项和各模型的消耗。它还会计算同一消耗按 API 列表价在 USD 中的成本（按模型计算，包括 5 min/1 h 的 Cache-Write、Cache-Read 和 Fast Mode）；状态栏显示 7 天总额，面板则按天、按模型和从套餐窗口开始计算的金额显示，价格表位于 hooks/pricing.ts。5 小时和 7 天窗口的套餐使用量取自最近一次 API 回应（只有订阅登录可用），并跨工作阶 session 保存。比较方式是将当前 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.