写代码的时候，最怕不是思路断了，而是 Claude Code 刚写到一半，触达5小时用量限额被限流。这一停，再捡回来可能已经忘了之前在想什么。新型 AI 编程工具的额度问题，产出了一种新的小工具需求——Agent Battery 就是冲着这个场景来的。
Agent Battery 是什么
Agent Battery 是一个 macOS 状态栏小工具，把 Claude Code 和 OpenAI Codex 的剩余用量，实时显示成 Mac 右上角类似磁电百分比的提示。无需手动去后台查看额度或打开终端，抬头瞟一眼状态栏就够了。点开弹窗还能对比5小时基线、周滚动额度以及对应重置时间。
读取 Claude Code 用量数据
传统的用量监控工具通常是定时去调官方 API，但这需要用户提供 API Key，存在凭证泄露的风险。Agent Battery 不存在这个问题——它直接读取本地文件，全程不上传统 API。
for Claude Code，它会一次性设置 collector 与 wrapper 两个本地脚本，并将 ~/.claude/settings.json 里的 statusLine.command 修改指向 wrapper。每次 Claude Code 刷新状态行时，rate limit 事件会被写入本地 JSON，Agent Battery 再从中解析展示。
for Codex 更省事儿，直接扫描 ~/.codex/sessions/**/*.jsonl 中的文档，从中提取最新的 rate-limit 事件。不需要额外配置，安装后就能自动找到数据源。
装之前先确认几件事
Agent Battery 并不是下载解压就能完全无感运行的小工具， Claude Code 用户来说，它会修改本地的 settings.json 文件。建议操作前先备份自己想保护的配置内容（毕竟安全第一）。
另一个约束是系统版本：仅支持 14.0 及以上版本，Windows、Linux 以及旧版 Mac 用户暂时没有，等作者后续适配。另外，它目前没有苹果签名，第一次打开大概率会被系统拦截，去”系统设置→隐私与安全性”点”仍要打开”即可继续，这点不像原生安装的 App 那么顺畅。
基于日志格式的开发工具都有一个共同问题：一旦官方改了输出格式，显示可能暂时失效，到时候需要等作者更新才能恢复。如果你天天重度依赖它，得接受偶尔可能不准的风险。
谁适合用 Agent Battery
如果你每天在终端连续跑 AI 编程任务，又经常遇到用量突然见底的情况，这个小工具就非常有意义。你不需要在脑子里记着”现在是第4个token”，而是让状态栏替你管理这些信息。
如果你只是偶尔在网页端与 AI 问答几次、或者很少碰 Claude Code，就没必要专门安装。它解决的是”我还剩多少额度、什么时候恢复”的可见性问题，效率上比让消失前自我作流量员审重要的多。
项目信息
GitHub：https://github.com/geebos/agent-battery
开源免费工具，下方可以 Releases 下载，安装体验完全免费。
