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 marketplace add arviaja/token-watch
claude plugin install token-watch@token-watch然后在会话里执行 /reload-plugins,或开一个新会话。
请帮我安装 Claude Code Mod「token-watch 用量与缓存温度」(https://github.com/arviaja/token-watch)。安装前先阅读仓库 README 的 Security 和 Requirements 部分,告诉我它会读写哪些内容、运行什么命令、是否联网,以及对 Claude Code 版本、系统和终端的要求。确认没有问题后,运行 claude plugin marketplace add arviaja/token-watch 和 claude plugin install token-watch@token-watch 完成安装,最后提醒我在会话里执行 /reload-plugins。把这段话发给 Claude Code,它会先读原作者说明再安装。
git clone https://github.com/arviaja/token-watch
cd token-watch
claude --plugin-dir .克隆仓库后用 --plugin-dir 在本地会话中试用。
它会碰什么
据原作者说明,收录时核对;可用 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 会消耗一次模型调用,订阅用户计入套餐额度。