Agent Battery 是一个轻量的 macOS 菜单栏应用，把 Claude Code 和 Codex 的剩余额度显示成类似电池的百分比。对经常在一天里切换 Claude Code、Codex 的人来说，它解决的是一个很具体的小痛点：不用再凭感觉猜 5 小时窗口还剩多少，也不用翻日志找 weekly quota 的重置时间。
把 AI 编程额度放到菜单栏
它的菜单栏图标可以常驻显示主工具的 5h 剩余额度，并在低于阈值时变色提醒。点开弹窗后，可以同时看到 Claude Code / Codex 的 5h 和 weekly remaining quota、重置时间，以及一段历史趋势图。README 里还展示了并列显示模式：可以把 Claude 和 Codex 的百分比一起放进菜单栏，像看电池一样扫一眼就知道该不该换工具。
设置项也比较实用：开机启动、刷新间隔、警告阈值、显示模式都能改。默认 30 秒刷新，也可以调到 1 / 3 / 5 分钟；界面支持中英文。
它不登录账号，只读本地文件
Agent Battery 的设计重点是本地读取。它不会主动连接账号或 API，也不依赖浏览器登录态。Claude Code 的数据来自 statusLine hook：第一次使用时，应用会在设置里提供一键 setup，把 wrapper 和 collector 脚本写到 ~/.agent-battery/，备份并更新 ~/.claude/settings.json，同时保留你原本已有的 statusLine command。
Codex 这边更省事：如果本地存在 ~/.codex/sessions/**/*.jsonl rollout 文件，应用会直接读取其中的 rate-limit event。它会按修改时间倒序扫描最多 80 个文件，只读尾部 1MB，找最新的额度事件，避免把很大的会话日志整份加载进来。
当前版本和安装门槛
项目是 MIT 开源，Swift 约 92.3%，另有少量 Python 和 Shell。仓库目前约 32 stars，最新稳定 release 是 v1.2.5，提供 agent-battery-1.2.5-universal-unsigned.dmg，Apple Silicon 和 Intel Mac 都能用；要求 macOS 14.0 或更高。
需要注意的是，目前 release 还是 unsigned / 未 notarized，首次启动可能会被 Gatekeeper 拦下，需要到 System Settings → Privacy & Security 里点 Open Anyway。还有一点：Claude Code 额度需要先完成 statusLine setup；Codex 则依赖本地已有 session 事件。
项目地址
https://github.com/geebos/agent-battery
原创文章，如若转载，请注明出处：https://wefound.cc/p/2700.html
