Mac 灵动岛：查看 Claude Code 与 Codex
Agent HUD 把 MacBook 灵动岛变成 AI 编程 agent 的状态入口：查看 Claude Code 与 Codex 的活动、额度和重置时间，回答支持的请求，再打开会话统计。Mac 本地功能免费。
设置灵动岛与悬停面板
- 让 Agent HUD 与编程工具运行在同一台 Mac 上，照常登录编程工具，再运行一个会话以生成本地记录。
- 在设置中选择需要的屏幕并启用灵动岛模式。有灵动岛的 MacBook 使用硬件位置；没有灵动岛的屏幕可以使用顶部居中的形状，或改用动态 Dock。
- 在「智能体」中选择需要监控的额度窗口，为需要查看运行中轮次与完成提醒的客户端保持「实时状态」开启。
- 悬停 HUD 展开账户用量、重置倒计时与实时会话，选择会话打开统计。若容易误触展开，可要求悬停时按住 Option。
先在哪里查用量
Claude Code 的 /usage 可以查看订阅用量和重置时间，Codex 也有自己的用量页面。只想在某个工具里查一个账户时，可以直接使用这些入口。
Agent HUD 把支持的 agent 放在同一处，切到其他应用时也能看到状态。光晕显示额度等级，悬停灵动岛或 Dock 可打开用量面板。
灵动岛上能看到什么
| 信息 | 能查看或操作的内容 |
|---|---|
| Agent 活动 | 客户端提供实时状态时查看运行中的会话，从面板打开会话。 |
| 额度与重置 | 查看支持的账户窗口、重置时间和近期消耗速率预测；缺失的额度保持不可用。 |
| 回合提醒 | 查看已记录的回合结束、额度危急与确认重置；一轮结束不代表任务已通过验收。 |
| 批准请求 | 在 Mac 上拒绝或批准支持的请求，回答前先查看命令、文件或工具输入。 |
| 会话统计 | 查看已记录的 Token、模型调用和每轮详情；API 价折合金额是估算，与订阅账单分开。 |
Claude Code 与 Codex 的批准请求
保持 Agent HUD 的「客户端回调」开启。Claude Code 的权限请求和提问可在 HUD 回答，计划审批则回到 Claude Code 自己的界面选择。
Codex Desktop 或 CLI 还需要在其 hook 设置中审阅并信任 Agent HUD 的 hook（CLI 中使用 /hooks）。Codex 请求提供拒绝与批准一次，未回答的请求会回到客户端自己的批准流程。
没有灵动岛时使用动态 Dock
外接显示器和没有灵动岛的 Mac 默认使用动态 Dock：agent 图标与背后的光晕。它可以停靠在上、右、下、左四条屏幕边缘，放在你常用的位置。
直接把可见 HUD 拖到屏幕边缘即可移动；拖动灵动岛会把这块屏幕切换为动态 Dock。隐藏图标时，按住 Command 显示拖动区域；屏幕设置可以重置位置或切回灵动岛模式。
每块屏幕分别记住模式、位置、图标外观和光晕。灵动岛模式保持在硬件灵动岛处，没有硬件灵动岛的屏幕则位于顶部居中。
按需要展开面板
面板从停靠边缘向屏幕内展开。可以要求悬停时同时按住 Option，也可以选择指针抵达 HUD 正上方的屏幕顶部时立即展开；左右和底边仍按悬停延迟展开。
用量内容较长时，在固定的设置与统计入口上方滚动。提醒只在指针所在屏幕出现一次，选择会话可打开 Mac 会话统计。
Mac 本地功能与跨设备查看
macOS 14 或更高版本上的本地活动、额度、提醒、批准与统计免费。可用读数取决于客户端和账户，API key 账户可能有 Token 用量而没有订阅额度。
Agent HUD Remote 提供免费的 iPhone 与 Apple Watch App 中的跨设备查看。在 iPhone App 内订阅，并在设备系统设置中使用同一 Apple 账户。本页的批准操作在 Mac 上进行。
常见问题
- 图标跳动与光晕分别表示什么？
- 客户端支持实时状态时，图标可表示 agent 正在工作或等待批准；光晕表示额度或余额状态。这些信号都不证明 agent 的输出已通过你的检查。
- 必须用有灵动岛的 MacBook 吗？
- 不需要。没有灵动岛的 Mac 和外接显示器可以使用动态 Dock，沿四条屏幕边缘停靠；设置中可以选择两种显示模式。
- 能同时查看 Claude Code 和 Codex 吗？
- 可以。启用的账户窗口一起显示在面板中，支持的实时会话显示在会话列表里；共用图标在动态 Dock 中只占一个位置。
- Mac 灵动岛功能需要订阅吗？
- 本地监控、提醒、批准和统计免费。Agent HUD Remote 是在其他设备查看 Mac 数据的付费功能。
- 所有 agent 的请求都能批准吗？
- 不能。批准支持因客户端而异，Claude Code 与 Codex 开启相应客户端回调后支持；每个客户端页面列出具体能力和设置步骤。
相关任务与工具
获取 Mac 版 Agent HUD
下载 Mac 正式版。本地监控、额度、Token 与受支持的批准功能免费，需要 macOS 14 或更新版本；可查看的数据因客户端而异。
最近更新： 2026-10-07 · 这里描述的行为，在 Agent HUD Open 的文档里有完整说明，并附有对应代码。 github.com/jazzenchen/agent-hud-open