Agent Battery：Claude Code 与 Codex 用量监控工具
软件介绍
Agent Battery 是 macOS 菜单栏应用，用电量式提示呈现 Claude Code 与 Codex 的本地用量信息，并显示重置时间。它是状态查看工具，不会增加额度或绕过服务限制。
项目当前支持 macOS 14 或更高版本。配额字段和上游产品规则可能变化，显示结果应与对应工具及账户页面交叉核对。
本地用量信息
项目说明 Codex 信息从本地会话记录读取；Claude Code 则通过 statusLine hook 将用量写入本机文件。应用不要求用户输入 API Key，但它读取的本地记录仍可能包含敏感上下文，应限制设备账户访问并保护备份。
数据缺失、过期或格式变化时，界面可能无法反映当前真实额度。不要把状态栏数字当作计费凭证或服务承诺。
Claude Code 配置变更与备份
启用 Claude Code 收集时，项目会在用户目录写入辅助脚本，并修改 ~/.claude/settings.json 中的 statusLine.command。项目说明会备份原设置并尝试保留既有命令，但这是对开发工具配置的实际变更。
- 安装前手动复制并妥善保存
~/.claude/settings.json，确认备份可恢复。 - 阅读项目关于 hook、wrapper 和卸载步骤的说明，核对将写入的脚本位置。
- 仅在理解变更并同意后启用设置；使用后若要撤销，按仓库当前卸载说明恢复配置，并检查脚本与生成的数据文件。
适用限制
Agent Battery 依赖本地文件格式和命令行工具输出。Claude Code 或 Codex 更新后，字段结构可能改变，进而导致读数暂时不可用或滞后。
安装包目前可能未签名或未公证。首次启动遇到系统警告时，不要全局关闭安全保护；先确认下载来自官方仓库，并查看发布说明、校验信息及源码。
项目与下载
| 地址 | 链接 |
|---|---|
| GitHub 项目 | |
| Releases 下载 |
使用声明
本文由 MENTUKEJI 根据项目官网、官方文档及公开资料整理。工具功能、价格、授权方式及服务条款可能随时调整，请以官方最新信息为准。
引用本文内容请注明来源并保留原文链接；如需全文转载，或发现内容错误、版权及授权问题，请联系：[email protected]。