远程会话：各个 agent 在 iPhone 上能做到哪一步

这个开关

在 Mac 的设置 → 实验选项 → 远程会话。它需要这台 Mac 已经启用 Agent HUD Remote 的同步，并且一次对所有 agent 生效：不用按 agent 选择，手机上也没有要设置的地方。

iPhone 跟随 Mac。只有 Mac 说明某个会话可以继续时，它的对话页才出现消息输入框；Mac 没打开的，手机不会提供，手机自己也不保存 agent 名单。

各个 agent 能做什么

批准请求

在 Mac 灵动岛上等待的请求，同时会以通知和卡片的形式发到手机。手机可以拒绝，或批准这一次。Mac 和手机谁先回答就以谁为准，请求随即从两边消失。

这一步不需要安装新的东西：回答经由客户端原本用于灵动岛的权限 hook 返回；Antigravity 则是回到它正在运行的应用所持有的那个请求。

Codex：消息怎么进去

Mac 把你的消息交给持有这个会话的 Codex Desktop 或 CLI 进程。会话空闲时，消息在那里开始新的一轮；Codex 正在工作时，消息先留在手机上，等这一轮结束再发，点 Steer 则把它加入正在运行的任务。

为了比 Codex 的日志更早知道一轮的开始和结束，Agent HUD 会在 ~/.codex/hooks.json 里加三个 hook。Codex 只有在你用 /hooks 信任之后才会运行新的 hook。

Claude Code：消息怎么进去

Claude Code 没有从外部接收消息的入口，所以 Agent HUD 使用 ~/.claude/settings.json 里的三个 hook：提交 prompt 时一个，每次工具调用之后一个，Claude 停下时一个。停下时的 hook 在后台等待，会话保持空闲、照常可用，你的消息到达时由它叫醒会话。Claude 正在工作时，消息先留在手机上，等这一轮结束再发；点 Steer 则立刻发送，随下一次工具调用的结果一起进去。

Claude Code 不把经由 hook 到达的文字当作你本人说的话。设置 → 实验选项里提供一段说明，粘贴到 ~/.claude/CLAUDE.md 末尾后，它就把来自 iPhone 的回复当作你的话；之后新开的会话生效。Agent HUD 从不修改这个文件。

关闭它

关掉远程会话后，Agent HUD 会从 Claude Code 与 Codex 的设置里移除它的三个 hook，撤回已经发到手机的请求，并放开所有在等待的会话。灵动岛上的批准和 Mac 上显示的其他内容都不受影响。

常见问题

为什么有的 agent 能做的比别的多？

每一步都需要对应客户端提供入口。能在灵动岛上询问的客户端，都可以在手机上回答。继续对话则需要客户端能从外部接收消息，目前走通的是 Codex 和 Claude Code。

iPhone 上需要设置什么吗？

不需要。手机按会话显示 Mac 说明它能做的事。在 Mac 上关掉开关，手机上的消息输入框和批准卡片就不再出现。

Agent HUD 会改我的 Claude Code 或 Codex 设置吗？

打开远程会话后，它会在 ~/.claude/settings.json 和 ~/.codex/hooks.json 里各加三个 hook，放在你已有的 hook 旁边；关掉开关时只移除它自己的。它从不修改 CLAUDE.md。

不开远程会话也能看对话吗？

可以。在 iPhone 上阅读对话由 Mac 订阅页里单独的开关控制，不需要远程会话。远程会话增加的是回答批准请求和发送消息。

相关任务与工具

• Agent HUD 在你的 AI 工具设置里加了什么
• 在 iPhone 与 Apple Watch 远程查看 AI 编程用量
• 在 Mac 上监控多个 AI 编程会话

• Claude Code 用量监控（Mac）
• Codex 用量监控（Mac）