用量看板出现在 · 横条 / 面板 / 弹窗收录

token-watch 用量与缓存温度

一根缓存温度管加套餐限额,告诉你现在该发、该清还是该换小模型。

token-watch 用量与缓存温度 · 效果预览 · 示意示意
> 给订单列表加上分页
⏺ 我先看看列表组件。
████████▒▒░░ WARM 38m · 212k · $2.40 to re-warm
send now: after 14:32 the next message costs $2.40
week 41% · lasts until reset · 5h 12%
[ details ] ×(示意)
❯

示意。实际效果取决于 Mod、终端和运行环境。

安装

/plugin marketplace add arviaja/token-watch
/plugin install token-watch@token-watch
/reload-plugins

在 Claude Code 会话里逐行执行这些命令。

它会碰什么

据原作者说明,收录时核对;可用 claude plugin validate 自行检查。

读取

有

读取每个请求的 token 数和模型、限额、/cost 费用、仓库文件夹名和上下文构成。

写入文件

有

在 Mod 存储(~/.claude/plugins/store)写每个会话的用量快照和开关设置,8 天后清理。

运行命令

未说明

README 未明确说明;代码中未见启动进程。

联网

有

仅 /token-watch recommend 在你确认后调用模型,发送面板中的用量数据。

介绍

token-watch 是 Claude Code 的 function hooks Mod,实时显示本机各会话的 token 用量、套餐限额和缓存温度(CLI 与桌面版均可)。作者说明它只观察,不改变、拦截或延迟任何请求。

  • 状态条:缓存“温度管”随缓存寿命(1 小时或 5 分钟)由红变蓝,配 LIVE/HOT/WARM/COOLING/COLD 阶段和剩余分钟,以及重新写缓存的费用。
  • 一次一条建议:如“5h full at 15:31: pause or use Sonnet”“send now: after 14:32 the next message costs $2.40”“/clear if the topic changed”。
  • 限额:周限额和 5 小时限额,按当前速度预测会不会提前用完;用 API key 时改显示今日花费和每小时花费。
  • 面板(/token-watch):Now、Session、Week、Why、Help 五个标签:按模型的费用、缓存写入原因、周用量曲线和上下文构成。
  • /token-watch recommend:确认费用后,把面板里的用量数据发给模型,获取省 token 建议。

缓存寿命由 /cost 费用推算。需要 Claude Code 2.1.287 或更新版本。

适合谁

  • 想知道缓存何时变冷、限额会不会提前用完的订阅用户

运行要求

  • Claude Code ≥ 2.1.287
  • 缓存寿命需模型在内置价格表中有精确价格,否则显示 cache life unknown。
  • recommend 会消耗一次模型调用,订阅用户计入套餐额度。