远程 DevAgent 服务器

让 DevAgent 在另一台计算机上持续运行，再从你的笔记本连接过去。

远程 DevAgent 服务器（Remote DevAgent Server）让一台计算机负责干活，另一台计算机负责提供界面。服务器保存着项目、worktree、终端、标签页、provider 账户以及 agent 会话。你的笔记本则连接到那个正在运行的 DevAgent 实例。

最简单的方案是在两台计算机上都用 DevAgent 桌面应用，通过 Tailscale 连接。这条路不需要运行 devagent serve。

Beta

远程 DevAgent 服务器处于 beta 阶段。请把服务器和客户端保持在你自己掌控的私有网络路径上，比如同一个 Tailscale tailnet 或局域网。

各部分分别运行在哪

Client computer · DevAgent client
  Shows the UI and sends your input
                 │
                 │ private network route
                 ▼
Server computer · DevAgent server
  Stores repos and worktrees
  Runs terminals and agents

请在服务器计算机上安装并认证 Codex、Claude Code、OpenCode、git 以及所有 provider CLI。你在笔记本上的登录并不会自动带到服务器上。

在无界面的 devagent serve 主机上，请从服务器 shell 注册托管的 Claude/Codex 账户（远程客户端会禁用 Add account）：

devagent account add --agent claude
devagent account add --agent codex
devagent account list

无需设置 UI 也能安装或刷新 agent skill：

devagent skills install --skill orca-cli --skill orchestration
devagent skills update --all

推荐方案：桌面应用 + Tailscale

你需要：

两台计算机上都安装并更新了 DevAgent
两台计算机上都安装了 Tailscale
两台计算机都登录到同一个 tailnet
服务器计算机保持唤醒、在线，并运行着 DevAgent

Tailscale 会给服务器分配一个通常以 100. 开头的私有地址。DevAgent 会在它的连接地址选择器中把该地址排在最前面。

1. 在服务器上创建访问链接

在应当让会话持续运行的那台计算机上：

打开 DevAgent 桌面应用。
打开 设置 → 远程 DevAgent 服务器。
在 Advertise this app as a server 下，点击 New Link。
在 Connection address 处，选择 Tailscale 地址。它通常形如 100.x.y.z。
点击 Generate Access Link。
复制 Pair another DevAgent client 下的链接。

如果缺少 Tailscale 地址，请确认 Tailscale 已连接，并点击 Connection address 旁边的刷新按钮。

请对访问链接保密

这个配对 URL 授予了对该 DevAgent 运行时的访问权限。请像对待密码一样对待它，只发送给你打算配对的客户端。

2. 在你的笔记本上添加服务器

在你想用作客户端的那台计算机上：

打开 设置 → 远程 DevAgent 服务器。
点击 Add Server。
输入一个易于辨认的名字，比如 Remote Server。
粘贴来自服务器的访问链接。
点击 Add Server。
如果保存的服务器显示 Disconnected，点击 Connect。

添加服务器只是把它保存下来，并不会强制让每个新项目都跑在它上面。只有当你希望以服务器路由的项目、终端、provider 检查以及浏览器或移动端交接默认使用该服务器时，才打开 Advanced → Active Server。

使用远程服务器

一旦服务器显示 Connected，选中它或它的某个项目，然后照常使用 DevAgent 即可。终端、agent 进程、文件、worktree 以及会话状态都存在于服务器计算机上。

当多个配对的客户端共享同一个服务器时，侧边栏筛选器可以提供 Hide other-client workspaces，让此设备只列出它自己创建的 workspace。参见 Worktrees → 侧边栏布局。

这意味着：

当客户端笔记本睡眠或断开连接时，agent 仍会继续运行；
服务器上需要具备这些 agent 所用的仓库、工具和凭据；
服务器必须保持唤醒并连接到 tailnet；
重新连接客户端会让你回到由服务器所拥有的状态；
你在服务器上删除的项目会从每个配对客户端的侧边栏中消失（不会留下永久的幽灵行）。

访问与安全

DevAgent 会为每个配对的客户端创建一个独立、可撤销的 token。服务器会在 Shared Server Access 下列出它们。

点击某个授权旁边的垃圾桶按钮即可撤销它。正在使用该授权的活跃客户端会被立即断开。
生成另一个链接会替换掉之前那个尚未使用的链接。已经配对过的客户端会保留各自的授权，直到你撤销它们。
在你的设置允许范围内，尽量把 Tailscale ACL 或授权限制得越窄越好。
不要把 DevAgent 端口直接转发到公网。优先使用 Tailscale、WireGuard、可信局域网、SSH 转发或经过认证的隧道。
不要为另一台计算机选择 127.0.0.1。该地址只在服务器自身上有效。

备选方案：`devagent serve`

当主机应当在没有桌面窗口的情况下运行时——比如一台无界面的 Linux 服务器或由服务管理的 VM——请使用 devagent serve。如果是一台你可以保持登录状态的 MacBook 或台式机，上面介绍的应用内设置更简单。

在服务器上安装 DevAgent 及其自带的 CLI，然后运行：

devagent serve --pairing-address <server-tailscale-ip-or-hostname>

例如：

devagent serve --pairing-address 100.64.1.20

该命令会：

启动 DevAgent 运行时，但不打开桌面窗口；
在前台运行，直到你按下 Ctrl-C；
打印所绑定的 endpoint 和一个运行时配对 URL；
仅将 --pairing-address 用作客户端应拨号连接的地址。

把打印出来的配对 URL 粘贴到客户端的 设置 → 远程 DevAgent 服务器 → Add Server 中。

当防火墙、隧道或服务定义需要一个固定端口时，加上 --port 6768：

devagent serve --port 6768 --pairing-address 100.64.1.20

同一时间只使用一种主机模式。如果 DevAgent 桌面应用已经在共享那台计算机，就不要再为同一套设置启动第二个 devagent serve 进程。

从无界面服务器连接移动端

对于 DevAgent 移动应用，请请求一个移动端专用的二维码和链接：

devagent serve --pairing-address 100.64.1.20 --mobile-pairing

让手机保持在同一个 tailnet 上，打开 DevAgent Mobile，选择 Pair，然后扫描终端里的二维码或粘贴打印出来的链接。

桌面应用还是 `devagent serve`？

服务器上的桌面应用

devagent serve

最适合

一台旧笔记本、Mac mini 或台式机

一台无界面的 Linux 机器、VM 或托管服务

设置方式

设置项和按钮

终端命令和服务配置

服务器窗口

打开

无

访问链接

New Link → Generate Access Link

打印在终端里

有效期

在桌面应用运行期间

在前台进程或服务运行期间