用途
claude-pace 面向使用 Claude Code 的开发者,用于在状态栏中实时监控账户的配额消耗情况。它专门解决“只显示已用百分比、没有时间上下文”的问题:例如已用 60%,若窗口只剩 30 分钟则没问题,但若还剩 4 小时则可能即将触顶。
主要能力
- 在 Claude Code 状态栏显示 5 小时与 7 天窗口的配额使用百分比。
- 显示每个窗口的重置倒计时(如 3h)。
- 节奏感知:把当前燃烧速率与窗口已过时间比例对比,输出节奏差值。⇣15% 绿色表示比预期少用 15%(有余量);⇡15% 红色表示比可持续速度多烧 15%(需放慢)。
- 顶行显示模型、effort、项目(分支)以及 git diff 统计(如 3f +24 -7)。
- 读取 Claude Code 2.1.80+ 状态栏 stdin 中的 rate_limits 字段;若该字段缺失(旧版或提供商不提供),5h/7d 配额显示 --,会话成本若可得则显示,不显示缓存的过期配额。
- git 缓存文件存放在用户私有目录($XDG_RUNTIME_DIR/claude-pace 或 ~/.cache/claude-pace,权限 700),读取前会校验,不写入共享 /tmp。
使用方式
可在 Claude Code 内通过插件安装(推荐),使用 /plugin marketplace add 与 /plugin install 命令后重启;也可用 npx claude-pace@latest 运行;或按手动方式在 ~/.claude/settings.json 添加 statusLine 配置。移除时删除该 statusLine 块即可。更新:插件用 /plugin marketplace update 和 /plugin update,npx 重新运行即可,手动则重跑 curl 命令。所有渠道安装的都是带 tag 的发布版本,不从 main 安装。
适用场景与限制
适用于希望精细管理 Claude Code 配额、避免在窗口结束前突然触顶的用户,尤其适合长时间编码、需要判断“还能不能继续用”的场合。工具本身不发起网络请求,配额数据完全来自 stdin。运行需依赖 jq(可通过 brew install jq 或包管理器安装),不需要 Node.js。执行与内存数据基于 Apple Silicon、300 次运行、相同 stdin JSON 测得。若需要主题、powerline 样式或 TUI 配置,可考虑 ccstatusline。源码为单个 Bash 文件,可自行审阅。