Agent Battery 是一个 macOS 状态栏小工具，用来查看 Claude Code 用量监控 信息。它主要是把 Claude Code 和 Codex 还剩多少用量，显示成 Mac 右上角类似电量百分比的提示。
用 Claude Code 写代码时，很多人需要一个更直观的 Claude Code 用量监控 提醒。5 小时窗口、7 天滚动额度这些规则看起来不复杂，但真正写代码时，没人会一直盯着后台算。等终端突然提示限流，调试思路往往也被打断了。
Agent Battery 是什么：把 AI 编程额度变成状态栏电量
Agent Battery 装好后会常驻在 Mac 状态栏里，菜单栏主要显示当前工具的 5 小时剩余用量；点开弹窗后，还能对比 Claude Code 和 Codex 的 5 小时额度、周额度以及对应的重置时间。
Claude Code 用量监控：它和常见 API 看板差别在哪
如果你之前折腾过各种 API 额度监控看板，你会发现它们大多有个通病：需要你交出 API Key 或者是访问令牌，然后定时去官方接口抓取数据。这不仅有凭证泄露的安全隐患，高频查询接口本身也可能产生额外的网络开销。
Agent Battery 比较有意思的一点，是没有走常见的 API 查询路线，而是通过本地文件读取用量信息。用户不需要额外输入 API Key，也不用把账号凭证交给第三方服务，这对重度使用 Claude Code 或 Codex 的开发者会更安心。
它是怎么读取 Claude Code 和 Codex 用量的
不走网络接口，那数据从哪来？它采取的是一种本地日志读取策略。
Agent Battery 真正有用的地方，在于它不会主动连接账号或 API，核心数据来自本地文件。
对于 Codex：它会读取本地
~/.codex/sessions/**/*.jsonl 日志文件，从其中解析最新的 rate-limit 事件，不需要额外配置。对于 Claude Code：它需要一次性设置。应用会写入 collector 与 wrapper 两个本地脚本，并备份、更新
~/.claude/settings.json，把 statusLine.command 指向 wrapper。Claude Code 刷新状态行时，相关 rate limit 信息会被写入本地 JSON 文件，供 Agent Battery 读取。装之前先看清：它会改 Claude Code 的本地配置
Agent Battery 不是那种下载后点开就完全无感运行的小工具。对 Claude Code 用户来说，它需要写入本地脚本，并修改 ~/.claude/settings.json 里的 statusLine.command。不过会自动备份原配置，但安装前自己看一眼配置文件，还是更稳妥。
这不是跨平台工具，只能跑在 macOS 14.0 或更新版本 上，Windows、Linux 和旧版 Mac 用户可以直接跳过。
还有一个小麻烦：应用目前没有苹果签名与公证，第一次打开大概率会被 Gatekeeper 拦一下。去“系统设置 → 隐私与安全性”里点“仍要打开”，一般就能继续使用。
另外，对于 Claude Code 用户来说，它在初始化配置时会修改本地的 settings.json 文件以植入 hook 脚本。虽然会尝试备份和保留你原有的自定义配置，但动手前最好自己先看一眼配置文件结构。同时，这类基于日志格式截取的工具，一旦上游官方改了数据输出结构，显示可能就会暂时失效，需要等待作者更新。
哪些人适合用 Agent Battery
Agent Battery 更适合已经把 Claude Code 或 Codex 当成日常开发工具的人。比如你经常在终端里连续跑任务、排查 Bug、改项目代码，又经常遇到用量突然见底，那状态栏里的这个小提示就有意义。
如果你只是偶尔用网页端问几句，或者平时很少碰 Claude Code，这类工具就没必要专门安装。它解决的是“我还剩多少用量、什么时候恢复”的可见性问题，不是让额度变多，也不是绕过官方限制。
如果你平时也在折腾终端和代码编辑器的效率优化，可以顺便翻翻 同类的 AI 编程项目，合理搭配才能提升整体体验。
Agent Battery项目主页与源码入口
免责声明：本文基于 GitHub 仓库、公开文档和项目说明整理，更偏向工具特性观察。声明本站不提供侵权资源或绕过官方限速规则的引导。GitHub 公开仓库不等同于成熟商业软件，该工具的实际截取稳定性、系统占用及配置修改风险，请以您的本地运行环境和官方最新说明为准。安装前建议自行备份核心配置文件。