SuperAPI AI 工具集

claude-lens

claude-pace(仓库名 claude-lens)是一个轻量级的 Claude Code 状态栏与速率限制追踪工具,可在终端实时显示 5 小时和 7 天配额使用情况,并给出重置倒计时。它最大的特点是“节奏感知”配额监控:不仅告诉你已用多少,还会把当前消耗速度与窗口剩余时间对比,用 ⇡ 或 ⇣ 显示是否超支。工具采用纯 Bash + jq 编写,单文件、零 npm,可通过 Claude Code 插件、npx 或脚本安装。

访问官网

工具介绍

用途

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 文件,可自行审阅。