Agent HUD文档

Agent HUD Remote

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

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 上的提醒,以及锁定屏幕和灵动岛上运行中的会话。

免费与订阅

iPhoneApple 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 上要打开客户端回调。

订阅并打开

在 iPhone 上订阅

在 Agent HUD 应用里打开设置 → Agent HUD Remote,选择订阅。每个套餐可同时支持 1、2 或 3 台 Mac。价格见 App Store。

用同一个 Apple 账户

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

在 Mac 上打开 Remote

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

给这台 Mac 一个名额

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

选择手机能做什么

回到设置 → 远程:

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

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

设置 → 远程:Agent HUD Remote、远程会话与共享对话都已打开

Mac 需要什么

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

对话

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

请求

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

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

最先送到 Mac 的回答算数,之后这个请求从所有屏幕上撤下。Agent HUD 从不替你做决定:没人回答的请求,等待时间与 HUD 上相同,默认 10 分钟,到时交还 agent。见请求。

发消息与开新会话

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

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

iPhone 上的录音或 Apple Watch 上的笔记,也能在 Mac 上开一个新的 Claude Code 或 Codex 会话,落在一个单独的任务文件夹里。见 Apple Watch。

提醒与实时活动

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

运行中的会话以实时活动出现在锁定屏幕、灵动岛和 Apple Watch 的智能叠放里。见 iPhone 中的「通知与实时活动」。

数据去了哪里

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

见隐私。

订阅结束后

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

最后更新于

本页目录