# Agent HUD Remote

[Agent HUD 文档](https://agenthud.app/docs/zh/)

Agent HUD Remote 经由你自己的 iCloud，让 iPhone 与 Apple Watch 在任何网络下都连着 Mac，并带来对话、决定与提醒。

更新于 2026-10-28

Agent HUD Remote 是唯一的付费功能。它经由你自己的 iCloud，让 iPhone 与 Apple Watch 在任何网络下都连着 Mac 上的 Agent HUD 发行版；不在电脑前时，你也能阅读 agent 的对话、回答它们的请求、给它们发消息。在 Mac 本机上做的一切，包括在 HUD 上回答请求，都不需要订阅。

## Remote 加了什么

和 Mac 在同一个网络里时，iPhone 与 Apple Watch 不订阅也能看到它的额度、Token 统计与会话。Remote 再加上：

- **任何网络**：额度、Token 统计与会话，出门在外也看得到。
- **对话**：阅读 Claude Code、Codex、Antigravity 与 DeepSeek Harness 的会话，并给 Claude Code 与 Codex 发消息。
- **决定**：允许或拒绝一次工具调用，回答提问，批准计划。
- **手腕上**：说出的想法成为 Mac 上的新会话，回复回到你的手表。
- **提醒与实时活动**：iPhone 与 Apple Watch 上的提醒，以及锁定屏幕和灵动岛上运行中的会话。

## 免费与订阅

| | iPhone | Apple Watch |
| --- | :---: | :---: |
| 额度、余额与 Token 统计 | ✓ | ✓ |
| 会话及其 Token | ✓ | ✓ |
| 主屏幕、锁定屏幕与待机显示的小组件 | ✓ | — |
| 多台 Mac | ✓ | ✓ |
| 任何网络 | ★ | ★ |
| 对话 | ★ | ★ |
| 给 Claude Code 与 Codex 发消息 | ★ | ★ |
| 变成新会话的笔记 | ★ | ★ |
| 工具调用、提问与计划 | ★ | ★ |
| 提醒 | ★ | ★ |
| 运行中的会话显示为实时活动 | ★ | ★ |

✓ 与 Mac 在同一网络时免费 · ★ 需要 Agent HUD Remote · — 这台设备上没有

## 哪些 agent 参与

| Agent | 阅读对话 | 发消息 | 请求 |
| --- | :---: | :---: | --- |
| Claude Code | ✓ | ✓ | 工具调用、提问与计划 |
| Codex | ✓ | ✓ | 工具调用与提问 |
| Antigravity | ✓ | — | 工具调用与提问 |
| DeepSeek Harness | ✓ | — | 工具调用与提问 |
| ZCode | — | — | 工具调用与提问 |
| CodeBuddy、WorkBuddy、Qwen Code、Devin CLI、Qoder 系列 | — | — | 工具调用 |

请求到了 HUD 上，才会到手机和手表上，所以 Mac 上要打开[客户端回调](https://agenthud.app/docs/zh/agents/hooks/)。

## 订阅并打开

### 在 iPhone 上订阅

在 Agent HUD 应用里打开**设置 → Agent HUD Remote**，选择**订阅**。每个套餐可同时支持 1、2 或 3 台 Mac。价格见 [App Store](https://apps.apple.com/app/id6812113619)。

### 用同一个 Apple 账户

在 Mac 和 iPhone 的系统设置里登录同一个 Apple 账户。

### 在 Mac 上打开 Remote

在 Mac 上的 Agent HUD 里打开**设置 → 远程**，打开 **Agent HUD Remote**。

### 给这台 Mac 一个名额

打开**设置 → 订阅**，在 **App Store** 下点**使用 App Store 名额**。订阅信息从 iCloud 读取，可能要稍等片刻才到。

### 选择手机能做什么

回到**设置 → 远程**：

- **共享对话**让手机可以阅读对话。
- **远程会话**让手机可以回答请求、发消息。
- 在**客户端**下选择手机跟踪哪些 agent。

iPhone 上的**连接你的 Mac** 看到哪一步完成，就会自动勾上哪一步。

![设置 → 远程：Agent HUD Remote、远程会话与共享对话都已打开](https://agenthud.app/docs/images/settings/remote.zh.webp)

## Mac 需要什么

- **Agent HUD 发行版**，从 [agenthud.app/mac](https://agenthud.app/mac) 下载。Remote 经由 iCloud 同步，所以只支持 macOS，从源码构建的版本也用不了。
- **一个名额**，在**设置 → 订阅**里。名额都用完时，先在那里的列表中移除另一台 Mac。
- **Agent HUD 保持运行。** Mac 大约每 30 秒把用量与会话发到 iCloud 一次，请求与提醒则立即发送。
- **打开客户端回调**（**设置 → 通用**），请求才会到达。Codex 还需要先在 Codex 里信任 Agent HUD 的回调。见[客户端回调](https://agenthud.app/docs/zh/agents/hooks/)。
- **Agent HUD 的 Claude Code 插件**，消息和回答才能进入 Claude Code 会话。在**设置 → 智能体插件**里安装，并保持它那一行的**发消息**打开。

## 对话

会话页上有**对话**入口，按轮显示你发出的提示词和 agent 可见的回复，保留近 7 天，不含模型的内部推理。会话里的子 agent 各自打开成一段对话，只能阅读。

## 请求

在 HUD 上等你处理的请求，也会到你的手机和手表上，附带命令、路径或编辑改动的行。在 iPhone 上，它排在首页最上方，也出现在所属会话的页面上。

| 请求 | 你的回应 |
| --- | --- |
| 工具调用 | **允许一次**或**拒绝** |
| 提问 | 选它的一个选项，在**其他**里用自己的话回答，或者**跳过** |
| 计划（Claude Code） | **批准**、**批准并自动接受编辑**，或者**继续规划**并留一句话 |

最先送到 Mac 的回答算数，之后这个请求从所有屏幕上撤下。Agent HUD 从不替你做决定：没人回答的请求，等待时间与 HUD 上相同，默认 10 分钟，到时交还 agent。见[请求](https://agenthud.app/docs/zh/hud/requests/)。

## 发消息与开新会话

在会话的对话页底部打一条消息，或者对 Apple Watch 说出来，它就以你本人的话进入 Mac 上的会话，不加任何来源标注。

- **Claude Code** 通过 Agent HUD 的插件接收，插件会等到会话空闲再交给它，所以不会插进正在进行的一轮。
- **Codex** 用它开始新的一轮，或者把它加进正在进行的那一轮。

iPhone 上的录音或 Apple Watch 上的笔记，也能在 Mac 上开一个新的 Claude Code 或 Codex 会话，落在一个单独的任务文件夹里。见 [Apple Watch](https://agenthud.app/docs/zh/phone/watch/)。

## 提醒与实时活动

有新回复、额度快用完、已用完或已重置、Codex 账户新增了重置次数，以及有请求在等你时，提醒会到 iPhone 与 Apple Watch 上。横幅在你于 iPhone 的**设置 → 通知**里打开之前一直是关着的。

运行中的会话以实时活动出现在锁定屏幕、灵动岛和 Apple Watch 的智能叠放里。见 [iPhone](https://agenthud.app/docs/zh/phone/iphone/) 中的「通知与实时活动」。

## 数据去了哪里

- Remote 经由你自己的 iCloud 同步。记录内容端到端加密，密钥在你的 iCloud 钥匙串里；只有提醒上显示的文字不在加密之内，好让 iOS 能显示它。
- 实时活动经由 Agent HUD 的中转服务交给 Apple 的推送服务。中转只保留转发所需的内容，也就是每台 Mac 最新的会话和每部手机的卡片，不保留账户身份；一个账户 30 天没有消息，就会被删除。
- agent 的凭据从不进入 iCloud、手机或 Agent HUD 的服务器。

见[隐私](https://agenthud.app/docs/zh/privacy/)。

## 订阅结束后

iPhone 显示 **Agent HUD Remote 已到期**，继续显示各台 Mac 在结束那一刻的数据，并提供**续订 Agent HUD Remote**。停止同步的 Mac 不再发来提醒与请求，也不再接收消息。同一网络里的配对不需要订阅，照常可用。

---

English: https://agenthud.app/docs/en/phone/remote/