Agent Battery
Agent Battery

Agent Battery最新版

官方版无广告322

Agent Battery是一个 macOS 状态栏小工具,用「电量百分比」的形式展示 Claude Code 与 Codex 的 usage 剩余额度,让你随时知道 5 小时窗口和每周额度还剩多少。

更新日期:
2026年5月9日
语言:
中文
平台:

2.1MB0 人已下载 手机查看

在使用 Claude Code 或 Codex 等 AI 编程助手时,我们常面临一个隐形焦虑:我的额度还剩多少? 是接近 5 小时窗口的上限,还是周额度即将耗尽?传统方式需要频繁打开终端或网页查询,既打断思路又不够直观。

Agent Battery 是一款专为 macOS 设计的状态栏小工具,它创造性地用“电池电量”的形式,实时展示 Claude Code 与 Codex 的剩余额度百分比。无需联网、无需登录,所有数据均通过本地文件解析获取,真正做到了隐私至上、无感监控。

Agent Battery

核心亮点:直观、本地、智能

1. “电量”式可视化监控

  • 状态栏常驻:在菜单栏直接显示主工具(Claude Code 或 Codex)的 5 小时窗口剩余百分比。
  • 颜色预警:当额度低于设定阈值时,图标自动变色(如由绿变红),提供直观的视觉提醒。
  • 双击查看详情:点击图标展开弹窗,清晰对比 Claude Code 与 Codex 的 5h 剩余、Weekly 剩余 及 重置时间。

2. 纯本地运行,零隐私泄露

  • 无 API 调用:应用不连接任何外部服务器,不收集账号信息,不发送网络请求。
  • 本地文件解析:
    • Claude Code:通过 statusLine Hook 抓取本地 JSON 数据。
    • Codex:直接读取 ~/.codex/sessions/ 下的 .jsonl 日志文件。
  • 数据安全:所有用量数据仅存储在本地,彻底杜绝隐私泄露风险。

3. 智能适配与自动化

  • 一键 Setup Claude Code:
    • 自动注入 statusLine Hook,将用量数据写入本地 JSON。
    • 兼容原有配置:若用户已有自定义 statusLine 命令,Agent Battery 会自动将其包裹并继续执行,确保原有功能不受影响。
  • Codex 零配置:无需任何设置,只要本地存在会话日志,应用即可自动识别并展示数据。
  • 自动刷新:默认每 30 秒刷新一次,支持自定义为 1/3/5 分钟,平衡实时性与系统资源占用。

4. 高度可定制

  • 阈值提醒:自定义警告/提醒阈值,精准掌控额度消耗节奏。
  • 显示模式:可选择仅显示百分比、图标或两者结合。
  • 开机自启:支持登录时自动启动,确保持续监控。
  • 中英双语:完美支持中文界面,降低使用门槛。

快速开始

1. 安装与启动

下载并安装 Agent Battery,启动后会在状态栏看到电池图标。

2. 配置 Claude Code(仅需一次)

由于 Claude Code 需要通过 Hook 暴露数据,首次使用需进行简单设置:

  1. 点击状态栏图标 → Settings。
  2. 在「Claude Code 设置」部分点击 Setup。
  3. 应用将自动:
    • 在 ~/.agent-battery/ 生成采集脚本。
    • 备份并修改 ~/.claude/settings.json,注入 Wrapper 脚本。
  4. 在任意目录运行一次 claude 命令,触发状态栏更新。
  5. 回到 Agent Battery 弹窗,即可看到实时额度。

💡 注意:此过程完全保留你原有的 statusLine 配置,不会破坏现有工作流。

3. 配置 Codex(无需操作)

Codex 用户无需任何设置。只要本地存在 ~/.codex/sessions/ 目录及日志文件,Agent Battery 会自动后台扫描并展示数据。

技术原理:如何做到“无感”?

Claude Code:Hook 注入与数据桥接

  1. Wrapper 脚本:Agent Battery 生成一个 Wrapper 脚本,替换原 statusLine.command。
  2. 数据分流:
    • 接收 Claude CLI 输出的 JSON 元数据。
    • 提取 rate_limits 字段,原子写入 ~/.agent-battery/claude-usage.json。
    • 将原始数据转发给原命令(如有),确保终端显示不变。
  3. UI 读取:应用定期读取本地 JSON 文件,计算剩余百分比并更新 UI。

Codex:高效日志尾部扫描

  1. 反向遍历:按修改时间倒序遍历 ~/.codex/sessions/ 下的 .jsonl 文件。
  2. Tail 读取:仅读取每个文件最后 1MB 数据(tailChunkBytes),快速定位最近的 rate-limit 事件。
  3. 提前终止:一旦找到有效事件且后续文件更旧,立即停止扫描,极大提升性能。

相关软件

ReTheme

ReTheme - 最新版

ReTheme 是一款专为 ChatGPT 和 Codex 桌面应用设计的轻量级主题换肤工具。基于 Tauri 2 + Rust 构建,它支持 macOS 和 Windows 平台,并提供中英双语界面。
Unsloth Desktop

Unsloth Desktop - 最新版

Unsloth Desktop(测试版)是一款免费、开源的应用,用于在你自己的本地硬件上运行和训练 AI 模型。适用于 macOS、Windows 和 Linux。 Unsloth 让你可以运行、训练和部署 LLM、扩散图像/视频、MLX、GGUF 和音频模型。
Fellou

Fellou - 最新版

Fellou 是全球首款智能体浏览器,旨在成为用户的数字伙伴。它不仅能浏览网页,还能自动执行复杂任务,如总结文章、安排会议或发布社交媒体内容。研究表明,它通过深度搜索和 AI 驱动的自动化,帮助用户更高效地处理信息。