Claude Code 需要你的时候，怎么知道
一轮跑很久，结束的时候你人在别处。谁来告诉你，取决于你在看哪儿。
Claude Code 自己会做的
Claude Code 自己可以发通知，走哪个通道是一项设置，终端提示音是其中之一。终端在屏幕上、或者你听得见的时候，这管用。
它找到你的地方是跑这一轮的那个窗口。当你开着好几个 agent、好几个标签页时，这就从特性变成了限制。
Agent HUD 在 Mac 上怎么提醒
灵动岛本身就是提醒。一轮结束时它显示会话标题和这轮用了多久，然后收回去；通知中心里不会留下任何东西，因为 Agent HUD 在 Mac 上根本不发系统通知。
额度相关的事用的是同一个地方：窗口快见底时警告、重置时提醒，中间的状态由光晕的颜色带着。
什么会触发，什么不会
- 四件额度相关的事各提醒一次：越过已用 90%、用尽归零、预计撑不到重置、以及一次确认的重置。
- 启动后每个窗口的第一次读数是静默基线，所以你开始时就已经在屏幕上的状态，永远不会触发提醒。
- 超过 30 分钟的旧读数继续显示，但不再触发任何东西。
- 暂停采集时、或上一次刷新失败时不会触发；光晕隐藏期间到达的提醒会被丢弃，而不是排队等着。
人不在 Mac 前面
Agent HUD Remote 把一台 Mac 的状态同步到免费的 iPhone、小组件与 Apple Watch 应用，同样这些事件在那边是真正的系统通知，进行中的会话则以实时活动呈现。
这是终端做不到的那部分：这一轮在你走开的时候结束，手腕上会说一声。
常见问题
- Agent HUD 会往 Mac 的通知中心推东西吗？
- 不会。在 Mac 上每一条提醒都是灵动岛本身。系统通知只发生在 iPhone 和 Apple Watch 上，通过 Agent HUD Remote。
- 有个窗口已经 95% 了，为什么没提醒我？
- 启动后窗口的第一次读数算基线而不是事件。要在 Agent HUD 运行期间越过阈值，才会触发提醒。
- 同一件事会提醒两次吗？
- 不会。四件事中的每一件对同一个窗口只提醒一次，所以一直停在 90% 以上的窗口不会反复响。
- 需要配置什么吗？
- 不需要。Agent HUD 读的是你 Mac 上已有的会话，所以本轮完成不用装 hook、不用密钥、不用设置就能出现。
指南
最近更新： 2026-09-20 · 这里描述的行为，在 Agent HUD Open 的文档里有完整说明，并附有对应代码。 github.com/jazzenchen/agent-hud-open