Agent HUD · 指南

在 Mac 查看 AI Agent 状态:悬停、用量与重置时间

完整对话仍在各工具的终端或应用里。Agent HUD 在 Mac 灵动岛或动态 Dock 集中显示运行轮次、剩余额度和重置时间;具体读数取决于客户端。

切换窗口前查看当前轮次

终端详细显示一段对话。状态监控回答的是:哪个 agent 正在工作、哪个需要注意,以及哪个账号还有额度?

Agent HUD 可识别 Claude Code 与 Codex 的运行轮次和已结束轮次。完成提醒表示本轮结束,不保证任务成功;其他客户端有各自的识别范围。

Claude Code 状态与用量

Codex 状态与用量

核对各客户端支持的读数

悬停查看用量

  • 将指针移到灵动岛或动态 Dock,在设置的悬停延迟后打开面板。
  • 若开启 Option 条件,需要按住 Option 再悬停;未按住时不会打开。
  • 顶部边缘立即打开是可选项,作用于顶部 HUD 上方;左右与底部位置仍使用悬停延迟。
  • 查看账号套餐用量和上报的重置时间,再打开统计窗口查看会话与 Token。长面板可以滚动,底部操作仍可使用。

设置灵动岛与动态 Dock

套餐剩余额度与 Token 回答不同问题

读数用途边界
套餐额度与重置时间判断账号能否继续下一项任务需要厂商与登录方式提供限额
会话 Token查看一段对话记录的模型消耗不是账号剩余的订阅额度
API 价折合金额按模型 API 价格比较记录的用量是估算,不是订阅账单
账号余额查看按余额计费服务的可用金额余额不是重置窗口

额度窗口、重置倒计时与燃尽预测

理解 Token 与费用维度

Agent 需要注意时

受支持的批准请求显示在 Mac HUD。保持客户端回调开启后,Claude Code 与 Codex 可提供该请求实际支持的选项;设置与信任要求因客户端而异。

轮次完成提醒会打开对应会话的统计。完整结果仍需在终端或客户端查看。Mac HUD 提醒与 macOS 通知中心通知是不同入口。

设置批准与客户端回调

Mac 上的 Codex 完成提醒

在外接屏保持状态可见

无需实体灵动岛。动态 Dock 可放在屏幕的上、下、左、右四边;拖到常用边缘,每块屏幕分别保存模式与位置。

隐藏 agent 图标时,按住 Command 可显示拖动区域。没有灵动岛的屏幕默认使用动态 Dock,可以选择不挡住编辑器和终端的位置。

在多块屏幕使用动态 Dock

离开 Mac 后查看状态

Mac 本地监控免费。Agent HUD Remote 增加 iPhone、小组件与 Apple Watch 查看;iPhone 应用免费,跨设备查看是付费功能。

Mac 需要保持 Agent HUD 运行。iPhone 还能阅读受支持的 Claude Code 与 Codex 近期对话;已发布的手机与 Watch 应用不能批准或控制 agent。

iPhone、小组件与 Watch 能显示什么

常见问题

悬停会消耗套餐额度吗?
打开面板不会发送 AI prompt。用量读取与提醒是监控操作,不是模型任务。
为什么能看到状态,却没有剩余额度?
部分客户端或 API key 登录只提供本地状态与 Token,不提供订阅限额。可在对应客户端页核对登录方式支持的读数。
本轮结束就代表任务成功了吗?
不代表。它表示本轮已结束;应查看客户端回答并验证结果,再判断任务是否完成。
必须使用带灵动岛的 MacBook 吗?
不需要。动态 Dock 可放在屏幕四边,包括外接屏。本地监控需要 macOS 14 或更新版本。

相关任务与工具

获取 Mac 版 Agent HUD

下载 Mac 正式版。本地监控、额度、Token 与受支持的批准功能免费,需要 macOS 14 或更新版本;可查看的数据因客户端而异。

获取 Mac 版 Agent HUD

查看源码与构建说明 · Mac 与 iPhone

最近更新: 2026-10-07 · 这里描述的行为,在 Agent HUD Open 的文档里有完整说明,并附有对应代码。 github.com/jazzenchen/agent-hud-open