Agent HUD
指南

Mac 上的回复与额度提醒

agent 结束一轮,或者某项额度越过一条线,HUD 会在你正看着的那块屏幕上告诉你。在 Mac 上,提醒只出现在 HUD 里,Agent HUD 从不往通知中心发通知。

更新于 2026-10-26

有新回复

一轮结束后,HUD 上出现「有新回复」卡片:agent 与模型、会话标题、回复的开头几行、结束时间和这一轮用了多久。「回到会话」一键回到它所在的线程、标签页或终端窗格,「查看 Token 用量」打开这个会话的用量。

会出现回复提醒的 agent:Claude Code、Codex、DeepSeek Harness、Antigravity、Cursor、Grok CLI、GitHub Copilot CLI、OpenCode、Kimi、Pi、CodeBuddy、Qwen Code 与 Devin CLI。能一键回到会话的:Claude Code、Codex、Antigravity、Grok Bot、OpenCode 与 Pi,从回复提醒或会话页面都能回去。

Agent HUD 启动之前就结束的轮次,不会补发提醒。

Claude Code 的「有新回复」提醒
Claude Code 的「有新回复」提醒

每个 agent 支持什么

额度提醒

  • 已用 90%:某项额度的已用比例越过 90%。
  • 已用完:重置之前没有剩余。
  • 撑不到重置:按最近的消耗速率,这个窗口会在重置前用完。
  • 已重置:窗口重新开始,提前重置也算。提醒会写出这个账户里仍然用完的其他窗口。
  • 新增重置次数:某个 Codex 账户获得了可以使用的重置次数。

只提醒一次,只在有变化时提醒

同一个窗口、同一个周期里,每种提醒只来一次。Agent HUD 启动后的第一次读数只作为基准,所以已经到了 95% 的窗口,在它变化之前不会提醒。超过 30 分钟的读数仍会显示,但不再触发提醒。两次提醒之间,由光晕显示状态:已用不足 70% 为绿色,达到 70% 为黄色,达到 90% 为红色。

额度能撑到重置吗?

在哪里出现,何时出现

  • 出现在指针所在的那块屏幕上。刘海形态下从刘海处展开;简约与动态形态下从发出提醒的 agent 图标里出来。刘海与动态形态下,光晕会闪一下提醒的颜色。
  • 一次一条,按到达的先后排队。回复与额度提醒在出现 4 秒后,或者指针离开后收起;指针停在上面时不会收起。
  • 请求会一直留着,直到你回应,或者它交还 agent。请求在屏幕上时,回复提醒排队等候,额度提醒不再显示。
  • 没有声音。Agent HUD 不播放提示音,也不往通知中心发任何内容。

Claude Code 与 Codex 自带的通知

Claude Code 在完成任务或等待权限、而你似乎不在终端前时,会自己发桌面通知,默认只在 Ghostty、Kitty 和 iTerm2 中发出。其他终端可以改为响终端铃声,或者运行 Notification 回调。

Codex 可以把每条通知以 JSON 交给你指定的命令,它的终端界面也能自己发通知。

这些通知各自只来自一个 agent。Agent HUD 把它关注的所有 agent 的回复集中在一处,并加上额度提醒。

Claude Code:终端铃声与通知Codex:配置参考

在 iPhone 与 Apple Watch 上

借助 Agent HUD Remote,提醒会到达你的 iPhone 与 Apple Watch,运行中的会话以实时活动显示在锁定屏幕和灵动岛上。

Agent HUD Remote

常见问题

Agent HUD 会在 Mac 的通知中心里发通知吗?

不会。在 Mac 上,所有提醒都出现在 HUD 里。iPhone 与 Apple Watch 上的提醒属于 Agent HUD Remote。

为什么已经到了 95% 的窗口没有提醒?

Agent HUD 启动后的第一次读数只作为基准。只有在 Agent HUD 运行期间越过某条线,才会提醒。

同一条提醒会来两次吗?

不会。同一个窗口、同一个周期里,每种提醒只来一次,一直停在 90% 以上的窗口不会反复提醒。

为什么从 GitHub 源码构建的版本回复提醒更少?

它暂不安装客户端回调,所以请求和经由回调送来的回复仍留在各个 agent 自己的窗口里。发行版会安装这些回调。