Agent HUD文档

请求

在 HUD 上回应 agent 的权限请求、提问与 Claude Code 的计划。你没处理的请求,10 分钟后交还 agent。

agent 请求运行工具、向你提问或拿出计划时,请求在 HUD 上等你,你在那里回应。Agent HUD 从不替你做决定:你没处理的请求会交还 agent,由它在自己的窗口里询问。

先打开客户端回调

在装于「应用程序」里的 Agent HUD 中,打开设置 → 通用里的客户端回调后,请求才会来到 HUD。见在 Mac 上安装。

工具调用

HUD 上等待批准的工具调用:拒绝、总是允许、批准一次

卡片上有 agent、会话所在的文件夹,以及它要运行的命令、文件或改动。修改文件时,改动显示在修改预览里。

回应结果
批准一次agent 运行这一次调用。
拒绝agent 不运行它。
总是允许agent 运行它,并保留总是允许会添加下列出的规则。只有 agent 提出长期规则时才出现,Claude Code 与 Qoder 系列会这样做。

提问

Claude Code 的提问,在 HUD 上回答
  • 选一个选项;卡片写着可多选时,可以选多个。
  • 在其他里写下你自己的回答。
  • 有多个问题时,用返回和继续切换,跳过留下某个问题不答,提交发出回答。

Claude 在桌面版里提的问题也会来到 HUD,回答经由 Agent HUD 的 Claude Code 插件送回,这个插件在设置 → 智能体插件里。

计划

HUD 上 Claude Code 的计划:继续规划、批准并自动接受编辑、批准

Claude Code 的计划完整显示。

回应结果
批准Claude 按计划开始工作。
批准并自动接受编辑Claude 按计划开始工作,并且不再逐一询问就接受它对文件的修改。
继续规划在计划反馈里写下要改的地方,然后发送,Claude 继续规划。

HUD 回答不了的请求

有些提问和计划只能在 agent 里回答,例如其他 agent 的计划。卡片上会写请到 … 里回答或请到 … 里审批这份计划,有时还会写出怎样才能让 Agent HUD 回答,并给出一个按钮,例如打开智能体插件。知道了收起卡片,agent 仍会在自己的窗口里询问。

多个请求

  • 请求排在待审批下,旁边是数量。每个请求都显示已经等了多久,点击就能打开。
  • 请求会一直留着,直到你回应或它交还 agent。它不会像提醒那样几秒后自己收起。
  • 你仍然可以在 agent 自己的窗口里回应。在 Claude Code、Qoder 系列或 DeepSeek Harness 里回应后,HUD 上的卡片会自己消失。
  • 回答没能送到 agent 时,卡片会写明。这时请到 agent 自己的窗口里核对。

没人回应时

请求在 HUD 上等待的时长,由设置 → 通用 → 等待回答决定:1、3、5、10、30 或 60 分钟,默认 10 分钟。到时它交还 agent,由 agent 在自己的窗口里询问。不会有人替你作答。

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

哪些 agent 会把请求发到 HUD

Agent工具调用提问计划
Claude Code✓✓✓
Codex✓✓
DeepSeek Harness✓✓
Antigravity✓✓
ZCode✓✓
CodeBuddy、WorkBuddy✓
Qwen Code✓
Devin CLI✓
Qoder、Qoder CN、QoderWork✓
  • Codex 要等你在 Codex 中信任 Agent HUD 的回调后才会运行它,而且只送来明确交给你审阅的轮次;交给 Codex 自动审阅的请求留在 Codex 里。Codex 桌面版自己的提问与批准,由桌面版直接送来。
  • DeepSeek Harness 的请求经由 Agent HUD 的 Harness 插件送来,这个插件在设置 → 智能体插件里添加。

Agent HUD 往每个 agent 的设置里写了什么,关闭客户端回调后有什么变化,见客户端回调。

离开 Mac 时

有 Agent HUD Remote 时,同样的工具调用、提问与计划也会来到你的 iPhone 与 Apple Watch。见远程。

最后更新于

本页目录