usage-meter 用量账本
每个 token 花在哪：限额、token 与美元，外加缓存到期倒计时。
> 给订单列表加上分页
⏺ 我先看看列表组件。
5h 41% · week 63% · budget left ≈ $38 Opus-eq
◷ cache expires in 12m · 352k context · auto-compacts in 7m
/burn → machines · sessions · subagents · models（示意）
❯
示意。实际效果取决于 Mod、终端和运行环境。
安装
安装方式比较特殊，请按原作者说明
查看原作者说明 ↗它会碰什么
据原作者说明，收录时核对；可用 claude plugin validate 自行检查。
读取
有采集器读 ~/.claude/projects 会话记录、Codex 日志和已配置的 stream-json 日志；Mod 读汇总文件。
写入文件
有在 ~/.claude/usage-meter 写账本、限额读数和停止请求；安装脚本建链接并装后台服务。
运行命令
有常驻 Python 采集器；调用 ssh 同步、claude auth status；停止 Codex 时发 SIGINT/SIGTERM。
联网
有配置多机时采集器每 20 秒经 SSH 同步；开启空闲压缩后，压缩会发一次模型请求。
介绍
usage-meter 是 Claude Code 的 function hooks Mod，配一个后台 Python 采集器，实时显示你的套餐限额百分比、token 和按 API 价格折算的美元，并按机器、会话、子代理、提示和模型拆分。
- 显示位置：状态行、输入框上方的实时状态条，以及
/burn面板。 - 从你自己的数据学习限额：拟合各模型消耗 5 小时和每周额度的速度，剩余预算更贴近真实。
- API 等价费用：按标价计算每个请求，缓存写入按 TTL 计价。
- 多台机器一处看：每台机器一个采集器，经 SSH 同步；也看 Codex。
- v0.3.0 缓存倒计时：会话空闲 10 分钟后，状态条显示提示缓存还剩多久到期（默认开启）。
- v0.3.0 空闲自动压缩（默认关闭）：上下文 ≥15 万 token 的会话，在缓存到期前 5 分钟压缩一次。
- v0.3.0 无头运行：配置
streamLogs后，统计claude -p的 stream-json 日志。
需 Python 3.9+，Linux 或 macOS，克隆后运行 deploy/install.sh；设置用 /plugin configure usage-meter。作者未写明 Claude Code 版本。
适合谁
- 多台机器、同时用 Claude Code 和 Codex、想精确掌握额度消耗的重度用户
运行要求
- 需 Python 3.9+，Linux 或 macOS；用 deploy/install.sh 安装，不走 marketplace。
- 作者未写明 Claude Code 版本；多机同步需基于密钥的 SSH。
- 空闲压缩默认关闭，经 /plugin configure usage-meter 开启。