远程访问

在 Tailscale 网络上的另一个设备的浏览器中打开 Agentty 工作区。

远程访问让你可以在另一个设备 — 手机、平板电脑或另一台计算机 — 的浏览器中打开 Agentty 工作区。你可以在自己的 Tailscale 网络内查看终端会话、直接输入命令,并向代理发送提示。

屏幕显示内容#

页面的布局与 Agentty 应用相同:

  • 主页 — 打开页面时首先看到的画面:等待你回答和正在工作的终端数量、正在等待的终端及其请求、正在工作的代理、所有工作区(包括休眠的),以及插件和它们的状态。点击终端或工作区即可前往。☰ 菜单顶部的 主页 可以返回。
  • ☰ 菜单 — 分组和工作区按侧边栏的顺序和颜色显示,并附带分支和文件夹。红色数字表示该工作区中等待你回答的终端数量。在宽屏上它会一直显示在左侧。
  • 标签页 — 所选工作区的标签页横排在顶部。圆点表示正在工作或等待你的标签页,▥2 表示分成两个窗格的标签页。
  • 分屏 — 标签页被分屏时,右上角的按钮会打开窗格列表,可查看每个窗格的状态和请求,点击即可切换。
  • 终端 — 中间显示所选窗格的实时画面。
  • 聊天工作区 — 聊天工作区以聊天形式打开:显示对话、套餐用量以及给主控智能体的输入框;点击 终端 可切换到主控智能体的终端。
  • 输出中的文件 — 终端或聊天中出现的文件路径(shots/home.png、NOTES.md、src/app.ts)会加下划线,点击即在页面上的查看器中打开,每个文件一个标签页。图片原样显示,Markdown 会渲染,其他文本按文本显示,PDF 在新标签页中打开。只能打开该终端项目文件夹内的文件,隐藏文件(.env、.git 等)和密钥文件不会打开。

新标签页 — 标签页末尾的 +(或主页上工作区旁的 +)会在该工作区中新建一个标签页,可选终端、Claude Code 或 Codex,从工作区的文件夹启动,页面随即切换过去。

新建工作区 — 主页工作区列表下方或 ☰ 菜单中的 + 新建工作区 会在 Mac 的 ~/AgenttyRemote 中的文件夹里打开新工作区,可选终端、Claude Code 或 Codex。浏览文件夹或新建一个,再选择要启动的工具,页面就会切换过去。网页无法访问 ~/AgenttyRemote 之外的任何文件夹。这个文件夹在第一次使用时由 Agentty 创建,在远程访问页面点 在访达中显示 可在 Mac 上打开它。

休眠的工作区 — 在 Agentty 中休眠的工作区会显示 唤醒:保存的标签页会重新启动,并显示在页面上。两者都不会改变 Mac 屏幕上显示的内容。

插件 — 主页列出已安装的插件及其状态(运行中、已停止、因错误停止),以及每个自动化当前在做什么。页面只显示这些:插件工作区不会在页面中打开,也不能从页面启动或停止插件。

你可以使用屏幕上的按键栏直接输入终端,其中包括 Esc、Tab、Shift+Tab、箭头键、Enter、Ctrl+C、粘性 Ctrl 键,以及当代理要求答案时的快速按钮 (1/2/3)。或者从底部的框中发送提示 — 在计算机上按 Enter,或按 Shift+Enter 添加一行。

图片 — 输入框旁的图片按钮可以附加照片或截图,也可以把图片粘贴或拖放到输入框中。图片会随下一条提示一起发送,就像在 Mac 上把它拖到终端一样,所以 Claude Code 或 Codex 会把它当作图片读取。较大的照片会先在手机上缩小。Mac 会把图片在 Agentty 的数据文件夹中保留一周,只有你本人可以读取。

点击页面上的接收通知后,页面开着但你在做别的事时,会话完成或需要你回答都会收到浏览器通知。

在页面上查看终端时,终端会改为页面的大小:使用屏幕能容纳的列数和行数,因此不会换行,也不会横向滚动。A− 和 A+ 可调整文字大小(按设备保存)。当没有页面再显示该终端时,它会恢复为应用中原来的大小。你可以将此页面作为应用添加到主屏幕。

如果设置了 Slack、Discord 或 Telegram 通知(设置 → 集成),远程访问开启期间,消息下方会附上 立即查看: <地址>。打开该地址并通过 Tailscale 和网页密码验证后,会直接打开那个终端。 由于该地址包含 Mac 和 tailnet 的名称,只有在开启包含智能体的提问内容时才会发送。

所需内容#

你需要:

  • Tailscale 已安装并在 Mac 上连接(另一个设备也使用同一 Tailscale 账户登录)
  • MagicDNS 和 HTTPS 证书 在你的 tailnet 上启用(Tailscale 管理控制台 → DNS)
  • Tailscale Serve 在你的 tailnet 上被允许 — 如果未被允许,Agentty 会显示一个打开按钮

设置#

  1. 打开侧边菜单中的远程访问(地球和显示器图标)
  2. 设置网页密码(使用英文字母、数字和符号,至少 12 个字符,输入两次;点眼睛按钮可显示输入内容)
  3. 在开启前的准备中点击签发证书:Tailscale 会获取这台电脑的 HTTPS 证书(每台电脑一次,第一次可能需要一分钟左右,之后由 Tailscale 自动续期)
  4. 打开开启远程访问——开启前的准备中的步骤全部打勾后才能开启
  5. 复制显示的地址(https://<machine>.<tailnet>.ts.net:8743/),或点击打开直接前往
  6. 在另一个设备上使用网页密码登录

完成。你的会话现在可在该设备上看到。

检测不到 Tailscale 时#

开启前的准备的第一步会说明问题所在,并提供解决按钮。页面会自动重新检查,问题解决后无需再按任何按钮。

显示内容怎么做
未安装获取 Tailscale。如果刚安装,请先打开一次应用。
这台 Mac 上已关闭按打开 Tailscale 并开启 Connect。如果 macOS 询问是否添加 VPN 或允许系统扩展,请允许。
尚未登录登录,使用手机上也会用的账号。
等待批准在 Machines 页面批准这台设备,或请 tailnet 管理员批准。
后台服务没有响应打开 Tailscale 并完成首次设置。Mac 上在系统设置 → 通用 → 登录项与扩展中允许系统扩展;Windows 上重启电脑;Linux 上运行 sudo systemctl enable --now tailscaled 和 sudo tailscale up。
macOS 正在等待允许在系统设置 → 通用 → 登录项与扩展 → 网络扩展中开启 Tailscale。
其他 VPN 可能阻止了它断开页面上显示的 VPN,然后在 Tailscale 中开启 Connect。
此 Mac 账户没有权限只有管理员账户才能读取 Tailscale 的访问文件。请使用管理员账户,或在系统设置 → 用户与群组中授予管理员权限。
Tailscale 拒绝了此账户Linux 上运行一次 sudo tailscale set --operator=$USER。Windows 上可能有其他账户正在使用 Tailscale。公司管理的 Mac 可能被策略阻止。
无法读取响应退出并重新打开 Tailscale,或更新它。Tailscale 给出的错误信息会显示在说明下方。

仍然不行时,按交给智能体。智能体会在新标签页中收到检查结果,先只做检查,修改任何内容前都会询问。复制诊断信息会复制同样的摘要,其中只有版本和状态,不包含账号、设备或 tailnet 名称。

需要哪个账号? 任何 Tailscale 账号都可以,不需要与 Apple 账号或电脑用户账户相同。需要相同的是这台电脑和要连接的设备上的 Tailscale 账号。

安全性#

远程访问只能在 Tailscale 网络内到达 — 永不在公共互联网上。如果为其端口启用了 Funnel,Agentty 会拒绝运行。进入需要同时通过以下两项:

  1. 你的 Tailscale 账号 — 只有这台 Mac 所属的账号能进入。共享你 tailnet 的其他人和带标签的设备会被拒绝。
  2. 网页密码 — 在远程访问页面设置的密码。

其他人的 Tailscale 账号即使在同一个 tailnet 中也无法进入。只有在登录了你的 Tailscale 账号的设备上再通过网页密码,才能在终端中输入,也就是能在你的 Mac 上执行命令。所以请不要与他人共享网页密码,也不要在别处使用它,不需要时关闭远程访问。

只有 Tailscale 能到达 Agentty 的页面。Agentty 只在 Tailscale 的 serve 能进入的地方监听:Tailscale 能打开时使用专用套接字,否则使用带有只告诉 Tailscale 的秘密路径的本地端口。因此 Mac 上的其他程序或其他用户账户无法直接进入。页面只在 Tailscale 运行时工作:Tailscale 断开、退出登录或退出时,Agentty 会在几秒内关闭页面,重新连接后自动恢复。开启期间,Agentty 还会每 30 秒(以及 Mac 从睡眠中唤醒时)检查页面能否通过 Tailscale 访问;如果没有响应,就会像关闭再开启一样自动重启远程访问,页面需要重新输入网页密码。

登录尝试失败受到速率限制:5 个错误的密码会锁定该页面 1 分钟。每个锁定后的错误密码会将等待时间加倍,最长 1 小时。当设备登录时和当页面被锁定时,你会收到桌面通知。 如果不是你锁定的,可以在远程访问页面点击解除锁定立即解除。

密码仅作为哈希值存储在你的系统钥匙串中。登录持续最多 7 天(空闲 12 小时)。退出 Agentty、更改密码或点击所有设备退出登录会立即在所有设备上登出。

保持清醒#

在远程访问开启时,Agentty 会防止 Mac 进入空闲睡眠,使其保持可达状态。显示器可能仍然会睡眠。你可以根据需要将其关闭。

处于睡眠状态的 Mac 或已关闭的笔记本电脑无法访问。

远程访问在重启后会保持开启状态,直到你关闭它。它使用 Tailscale 端口 8743,不会干扰你使用 Tailscale 提供的其他任何东西。如果其他东西已在使用端口 8743,Agentty 会显示错误。

在 Mac 应用中语音输入#

在应用里也可以直接用语音下达指令。 麦克风只在智能体标签页(Claude Code、Codex 等)和聊天中显示 —— 普通 shell 用不上语音提示。 智能体 CLI 也有自带的语音功能:Claude Code 的 /voice 把语音听写进提示(长按空格;音频在 Anthropic 服务器上转写,需要登录 claude.ai),Codex 的 /voice 则是 Codex 用语音回答的语音对话,而不是听写。Agentty 的麦克风在任何智能体、聊天和远程页面中都一样工作,并且音频不会离开你的 Mac。点击状态栏右端的麦克风或按 ⇧⌘M,然后说话。录音时状态栏会显示录音中 0:05和音量条。

  • ⏎ Enter — 停止并把说的内容立即作为提示发送到终端。
  • 再次点击麦克风或 ⇧⌘M — 停止并只输入文字,确认或修改后再自己发送。
  • Esc — 取消录音。

文字会进入开始录音时处于活动状态的终端。语言根据语音自动识别,中文、英文或混合说都可以。第一次使用时 macOS 会请求麦克风权限;如果你关闭了它,Agentty 会为你打开系统设置的麦克风页面。还没有模型时,点击麦克风会就地打开模型安装(与下文相同)。

语音提示#

在远程页面,你可以用语音代替打字来发送提示。点按提示栏的麦克风,说出提示,再次点按停止;转写后的文字会填入提示框,供你检查后发送。

音频在你的 Mac 上由本地模型转写,不会发送到任何外部服务。只需在 设置 → 语音输入 中安装一次模型(远程访问页面上也有同样的卡片):选择 Large-v3 Turbo(推荐,约 574 MB)或更轻的 Small(约 488 MB),它会下载到你的 Mac,经校验后保存在本机,并在 Mac 的 GPU 上运行。在同一处还可以选择说话语言(自动、韩语、英语 —— 自动识别可能把简短的话误判为其他语言)、指定使用哪个已安装的模型,以及删除模型。安装模型后,麦克风按钮会自动出现在远程页面上。

浏览器首次会请求麦克风权限,且页面必须通过 HTTPS 提供——通过 Tailscale 即为 HTTPS。

开发服务器#

当工作区的终端运行本地服务器(npm run dev、rails s、静态网站预览等)时,它的端口会显示在页面上该工作区的标签下方,例如 ↗ localhost:3000。点按后,服务器会在新的浏览器标签中以 https://<machine>.<tailnet>.ts.net:3000/ 打开,即与页面相同的地址名加上服务器的端口。首次需要几秒钟,Tailscale 会先准备好该端口。

与页面一样,只有你能进入。该地址由 Agentty 自己接收,只有来自你的 Tailscale 账户、并已用网页密码登录的设备的请求才会转给服务器(请先在页面上登录)。服务器看到的请求是发往 localhost:<端口> 的,也拿不到你的 Agentty 登录信息。它的表现与在 Mac 的浏览器中打开相同,包括热重载。

服务器停止、关闭远程访问或退出 Agentty 时,该地址随之消失。Tailscale 已用于其他用途的端口或通过 Funnel 公开的端口,Agentty 不会打开,并会在页面上说明原因。

从手机应用发送的工作区#

Agentty Remote 应用可以从手机发送工作区:它以自己的名称打开,放在单独的分组中。随之发送的文件保存在工作区文件夹的 .agentty-remote/ 下,不会进入 git。在远程访问页面的 已登录的设备 中,通过应用登录的手机显示为 Agentty Remote,而不是浏览器名称。

在应用中还可以让工作区休眠、关闭标签页(连同其拆分的窗格一起关闭,可从已关闭的标签页重新打开),以及把工作区移到废纸篓。从手机做的任何操作都不会永久删除内容:从手机移到废纸篓的工作区会保留其工作树和同步数据,并和其他项目一样可从废纸篓恢复。

从手机应用使用聊天和编排#

Agentty Remote 应用可以把窗格显示为聊天,并跟进你的编排,登录和检查都与页面相同。在手机上选择聊天不会改变窗格在 Mac 上的显示方式。从手机启动或恢复编排时,Mac 仍停留在当前工作区,并用提示告知。

已排除在远程访问之外的工作区及其中的编排不会出现。从手机启动的编排在 ~/AgenttyRemote 下的文件夹中工作,也不会像 Mac 上的对话框那样先读取目标中提到的链接或文件,智能体只会收到目标本身。

对话包含智能体读取和输出的所有内容。离开 Mac 之前,主文件夹会缩写为 ~,看起来像已知类型凭据的文本会被遮盖。这只能捕获常见形式,不能遮盖一切,请像对待终端一样对待它:它们是同一个会话。

隐藏此功能#

如果不使用远程访问,可以关闭设置 → 通用 → 使用远程访问功能(默认开启),或在远程访问页面点击停用远程访问。侧边菜单中的图标会消失,远程访问也会关闭。重新打开该设置即可恢复。

若只想让某个工作区不出现在页面上,在其卡片的菜单(右键)中选择在远程访问中隐藏。页面将不再列出它,也无法访问它的终端。

故障排查#

Tailscale 未连接 在 Mac 上的 Tailscale 应用中连接。

HTTPS 证书已关闭 在 Tailscale 管理控制台(DNS 设置)中启用 MagicDNS 和 HTTPS。这会为你的 tailnet 域创建证书。

无法开启:Tailscale can't reach Agentty's page 常见原因是这台电脑的 HTTPS 证书还没有签发。关闭远程访问,点击签发证书,然后重新开启。

Serve 已关闭 Agentty 在设置中显示打开 Serve 的按钮。点击以打开 Tailscale 管理控制台。

此 Tailscale 账户可能无法使用此 Agentty(显示在登录页面上) 另一个设备使用不同的 Tailscale 账户登录。请使用与你 Mac 相同的账户登录。

页面显示已锁定(显示在登录表单的位置) 你输入了 5 次错误的密码,或有人做过。等待或检查远程访问 → 最近记录以查看发生了什么。 如果不是你,请在 Mac 的远程访问页面点击解除锁定。