我需要自己配置 hook 吗？

不需要。Agent HUD 启动时会自己加上。唯一要你做的是 Codex 那一步：它要你在 /hooks 里信任之后才运行新 hook。

Agent HUD 会改动我已有的 hook 吗？

不会。它只在旁边加上自己的一项，也只撤掉自己的那一项。读不懂的设置文件原样不动。

在灵动岛上回答权限请求、只通过 hook 上报完成的那些客户端的完成提醒、Claude Code 的等待批准状态，以及 Pi 的运行状态。用量、额度和会话不受影响。

不会。hook 带来的内容只在你的 Mac 上读取，用来显示请求或记下一轮结束，回答直接交还给发出请求的客户端。没有任何东西离开这台机器。

Agent HUD 显示的大部分内容，来自客户端本来就在记的东西。有少数几件事只在发生的那一刻才知道，这时得由客户端主动喊一声。

有两件事永远来不及写进记录：客户端正要问某个工具能不能运行，以及对某些客户端来说，一轮刚刚结束。客户端可以在这些时刻运行一条写在它自己设置里的命令，这条命令就是 hook，而 Agent HUD 就是那条命令。

Agent HUD 每次启动时自己加上它的回调，只加给这台 Mac 上装了的客户端。那些文件里的其他 hook 保持原样，读不懂的设置文件不会被改写。

客户端	它的 hook 用来做什么
Claude Code	在灵动岛上回答权限请求；说明会话正在等待批准
Qoder、Qoder CN、QoderWork	回答权限请求
Codex Desktop / CLI	回答权限请求
CodeBuddy	回答权限请求；上报一轮结束
WorkBuddy、ZCode	回答权限请求
Qwen Code	回答权限请求；上报一轮结束
Antigravity、Cursor、GitHub Copilot CLI	上报一轮结束
Pi	是扩展而不是 hook：上报运行中与一轮结束

Codex 只有在你用 /hooks 审阅并信任之后，才会运行新加或改过的 hook。Agent HUD 从不替你标记信任，所以在你信任之前，Codex 照旧在自己的窗口里询问。

ZCode 在开启 hook 开关之前不运行任何 hook。这个开关从没设过时，Agent HUD 会把它打开；你自己关掉的，它不去动。

权限请求在灵动岛上等十分钟——可以在设置 → 通用 → 等待回答里改——然后交还客户端，由它在自己的窗口里询问。不会有任何请求被替你回答。

退出 Agent HUD 会立刻交还所有在等的请求；Agent HUD 没在运行时，客户端直接用自己的提示询问。

设置 → 通用 → 客户端回调。关掉之前它会先列出哪些功能会停止；你确认后，Agent HUD 立刻从每个客户端的设置里撤掉它的回调，之后启动也不再加回去。

权限请求不再在灵动岛上回答，每个客户端在自己的窗口里询问。
Antigravity、Cursor、GitHub Copilot CLI、CodeBuddy 和 Qwen Code 不再上报一轮结束，它们的完成提醒会停止。
Claude Code 的会话不再显示正在等待批准。
Pi 不再显示运行状态，也没有完成提醒。
用量、额度、Token 计数和会话历史完全不变。

先把客户端回调关掉。只删 App 的话，它的回调会留在各客户端的设置里，指向一个已经不存在的程序。

另一份 Agent HUD 加的回调——比如和 Agent HUD 并存的 Agent HUD Open——属于那一份，只有它自己能撤掉。

我需要自己配置 hook 吗？: 不需要。Agent HUD 启动时会自己加上。唯一要你做的是 Codex 那一步：它要你在 /hooks 里信任之后才运行新 hook。
Agent HUD 会改动我已有的 hook 吗？: 不会。它只在旁边加上自己的一项，也只撤掉自己的那一项。读不懂的设置文件原样不动。
关掉客户端回调会失去什么？: 在灵动岛上回答权限请求、只通过 hook 上报完成的那些客户端的完成提醒、Claude Code 的等待批准状态，以及 Pi 的运行状态。用量、额度和会话不受影响。
hook 会把我的代码或提示词发到别处吗？: 不会。hook 带来的内容只在你的 Mac 上读取，用来显示请求或记下一轮结束，回答直接交还给发出请求的客户端。没有任何东西离开这台机器。

最近更新： 2026-09-22 · 这里描述的行为，在 Agent HUD Open 的文档里有完整说明，并附有对应代码。 github.com/jazzenchen/agent-hud-open