Agent HUD
指南

在 HUD 上批准、回答与审批计划

agent 请求运行工具、向你提问或拿出计划时,请求在 HUD 上等你,你在那里回应。Agent HUD 从不替你做决定:你没处理的请求,10 分钟后交还 agent。

更新于 2026-10-29

可以回应什么

请求你的回应
工具调用「批准一次」或「拒绝」,命令、文件或改动都摆在眼前。agent 提出一条长期规则时,还会出现「总是允许」,Claude Code 与 Qoder 系列会这样做。
提问选一个或多个选项,用自己的话回答,或者跳过某个问题。Claude 在桌面版里提的问题也会来到 HUD。
计划完整的 Claude Code 计划:「批准」「批准并自动接受编辑」,或者「继续规划」并给 Claude 留一句话。
HUD 上等待批准的工具调用:拒绝、总是允许、批准一次
HUD 上等待批准的工具调用:拒绝、总是允许、批准一次

在 HUD 上,或在 agent 里

多个请求排成队列,每个都显示已经等了多久。你仍然可以在 agent 自己的窗口里回应;在 Claude Code 或 Qoder 系列里回应后,HUD 上的卡片会自己消失。HUD 回答不了的提问或计划,会附一句说明,请你到 agent 里回答。

Claude Code 的提问,在 HUD 上回答
Claude Code 的提问,在 HUD 上回答
Claude Code 的计划:继续规划或批准
Claude Code 的计划:继续规划或批准

哪些 agent 会把请求发到 HUD

Agent工具调用提问计划
Claude Code✓✓✓
Codex✓✓
DeepSeek Harness✓✓
Antigravity✓✓
ZCode✓✓
CodeBuddy、WorkBuddy✓
Qwen Code✓
Devin CLI✓
Qoder、Qoder CN、QoderWork✓

每个 agent 支持的全部功能

没人回应时

请求默认等 10 分钟,也可以改成 1 分钟到 1 小时之间的其他时长。到时它交还 agent,由 agent 在自己的窗口里询问。不会有人替你作答。

Agent HUD 没有运行时,各个 agent 照常在自己的窗口里询问。

Agent HUD 往 agent 的设置里写了什么

请求经由各 agent 自己设置里的小段回调来到 HUD。只有客户端回调打开时,Agent HUD 才写入它们;它把自己的条目加在你原有的回调旁边,关闭客户端回调时只移除自己的那一条。

  • 另有几项只在你在 Agent HUD 里要求时才添加:Claude Code 与 DeepSeek Harness 的插件、agent 配置里的 MCP 服务,以及 Antigravity CLI 状态栏旁的额度回调。
Agent加了什么带来什么
Claude Code一段回调工具调用、提问与计划;会话的等待状态
Codex一段回调,你在 Codex 中信任后才运行工具调用。Codex 桌面版自己的提问与应用授权由 Codex 桌面版直接提供,不写入任何内容
Qoder、Qoder CN、QoderWork一段回调工具调用
CodeBuddy、Qwen Code、Devin CLI一段回调工具调用与回复
WorkBuddy一段回调工具调用
ZCode一段回调工具调用与提问
Antigravity一段回调回复。工具调用与提问来自 Antigravity 自己的本机通道
Cursor、GitHub Copilot CLI一段回调回复
Pi一个扩展实时状态与回复
OpenCode一个插件回复
DeepSeek HarnessAgent HUD 的插件,由你自己添加工具调用与提问

关闭客户端回调后

  • 请求回到各个 agent 自己的窗口。
  • 靠回调、扩展或插件上报回复的 agent,不再有回复提醒。
  • Token、额度、会话及其历史保持不变。
  • 回调会一直留在 agent 的设置里,直到关闭客户端回调。只删除应用,回调仍留在原处,指向一个已经不存在的应用。

发行版与源码构建

客户端回调由装在「应用程序」里的发行版写入。从 GitHub 源码构建的版本暂不安装回调,所以它的请求仍留在各个 agent 自己的窗口里。

Claude 在桌面版里提的问题,回答经由 Agent HUD 的 Claude Code 插件送回,这个插件有自己的开关。

离开 Mac 也能回应

借助 Agent HUD Remote,同样的工具调用、提问与计划会带着上下文来到你的 iPhone 与 Apple Watch。打开「远程会话」后,发行版还会在 Claude Code 与 Codex 里加一段回调,把每一轮的提示与回复带到手机上的对话里。

Agent HUD Remote:离开 Mac 也能做决定

常见问题

请求会离开我的 Mac 吗?

不使用 Agent HUD Remote 就不会。请求在你的 Mac 上读取、画成卡片,你的回应直接交回 agent,请求内容不作为历史保存。使用 Remote 时,请求还会经由你自己的 iCloud 到达 iPhone 与 Apple Watch。

Agent HUD 会改动我原有的回调吗?

不会。它把自己的条目加在旁边,也只移除自己的那一条。

Agent HUD 会自己批准请求吗?

不会。每一个回应都由你决定,没人回应的请求会交还 agent。

为什么 Codex 的请求没有出现在 HUD 上?

Codex 要等你在 Codex 中信任 Agent HUD 的回调后才会运行它,而且只送来由你本人审阅的请求;交给 Codex 自动审阅的请求留在 Codex 里。