运行 DevAgent 的几种方式
本地桌面、SSH 主机、自托管 DevAgent 服务器，以及按需的按工作区 VM —— 为每项任务选择合适的算力。
DevAgent 并不被锁在你的笔记本上。每个 worktree 都在某处运行 —— 在你面前的机器上、在你已经拥有的机箱上、在一台共享的常开服务器上，或在为那一个工作区专门启动的全新云 VM 上。
本页是一张地图。深入内容位于所链接的页面上。
一览
模式
文件和 agent 在哪里
谁拥有这台机器
最适合
Local
你的桌面
你
日常编码、快速迭代
SSH target
你通过 SSH 连接的远程主机
你（或你的团队）
开发机、GPU 主机、常开 VPS
Remote DevAgent Server
一台运行 DevAgent 桌面版或 devagent serve 的机器
你（或你的团队）
持久的共享运行时、移动端、自动化
Cloud VM / 按工作区环境
每个工作区一台一次性的 VM/沙箱
你的云账户（自带提供方）
隔离的、临时的 agent 算力
DevAgent 不销售托管的 VPS 主机。远程模式始终使用你所控制的机器和云账户。
1. 本地桌面
安装 DevAgent、打开一个项目、创建 worktree。Agent、终端和浏览器都与 UI 运行在同一台机器上。
这是大多数人的默认路径。参见 你的第一个 3-agent 会话 和 Worktree。
2. SSH 目标
把 DevAgent 指向任意 SSH 主机 —— 一台更强的 Mac mini、一台 Linux VPS、一台 GPU 主机、一个带 SSH 的云沙箱。创建 worktree 时，在 Run on 下选择那台主机。Agent 和 git worktree 在远程运行；编辑器、diff 和 UI 留在你的笔记本上。
适合的场景： 远程已经有你的仓库、工具和凭据，而你想用一台笔记本上的 DevAgent 驱动多台机箱。
设置概要：
- 在 设置 → SSH 下添加主机。
- 测试连接（用于仓库 worktree 时，主机上必须有 git）。
- 创建一个 worktree 并在 Run on 下选择 SSH 目标。输入预测列表会列出就绪的主机，对于已连接但尚未为该项目完成设置的主机，会显示不可选的 setup-needed 行。
SSH worktree 可以在 VS Code Remote-SSH 中打开、在 SFTP 允许时下载远程文件夹，并且即便远程无法编译终端原生模块时也仍可用于文件/git（为 shell 安装构建工具即可）。详情：SSH worktree 以及配方 通过 SSH 在远程机器上工作。
3. Remote DevAgent Servers
让 DevAgent 在一台你控制的机器上持续运行 —— 一台旧笔记本、Mac mini、家用服务器、云 VPS 或团队机箱。将你的笔记本、浏览器客户端或手机与那个运行时配对。服务器拥有项目、worktree、终端和 agent 进程；客户端是 UI。
适合的场景：
- 你希望 agent 在笔记本睡眠后仍继续运行
- 移动端应重新连接到相同的会话
- 自动化或后端应在一台稳定主机上启动会话
最简单的设置： 在两台电脑上都安装 DevAgent 和 Tailscale。在服务器上，打开 设置 → 远程 DevAgent 服务器 → Advertise this app as a server → New Link，选择它的 Tailscale 地址，并生成一个访问链接。在客户端上，选择 Add Server 并粘贴该链接。
对于无头 Linux 服务器或服务托管的 VM，可用 devagent serve 作为替代方案：
devagent serve --pairing-address <reachable-tailscale-ip-or-hostname>完整细节：Remote DevAgent Servers。
SSH vs Remote DevAgent Server
SSH worktree
Remote DevAgent Server
运行时拥有者
笔记本上的 DevAgent
远程机器（DevAgent 桌面版或 devagent serve）
断开连接
Agent 继续在主机上运行；笔记本重新挂接
完整会话状态存在于服务器上
多客户端
一台笔记本驱动主机
笔记本、web、移动端和自动化可共享同一个运行时
典型设置
导入 SSH 配置，选择 Run on
分享服务器应用或运行 devagent serve，然后用一个 URL 配对
4. 云 VM（按工作区环境）
每个 worktree 都可以从仓库签入的配方（orca.yaml + 生命周期脚本）启动自己的按需环境 —— 云沙箱、VM 或本地 Docker 容器。创建时把它启动起来；挂起/恢复/销毁把它拆除。DevAgent 只是一层薄封装：你的提供方账户、镜像和计费仍归你所有。
在产品 UI 中，这个界面在 设置 → 实验 下标注为 Cloud VM。配方仍会创建按工作区的环境。
人们今天接入的提供方包括 Vercel Sandbox、Fly、Modal、纯 SSH 主机和本地 Docker。连接方式要么是 DevAgent server（配方启动 devagent serve 并返回一个配对 URL），要么是 SSH（配方返回 DevAgent 拨号所需的连接详情）。
适合的场景： 你想为每项任务实现干净的隔离、一次性算力，或一个每个 agent 都会启动进入的标准环境。
设置概要：
在 设置 → 实验 下启用 Cloud VM。该面板包含一份简短的 Create a Cloud VM 指南以及配方/运行时控件。
如有需要，安装/更新 Cloud VM / 按工作区环境 skill。
在任意工作区中，向你的 agent 发出请求：
Use the orca-per-workspace-env skill to set up a per-workspace environment for this repo.该 skill 会走完前置条件 → 基础快照 → agent 认证 →
orca.yaml配方 → doctor 校验的流程。当配方出现在 Recipes 下后，创建一个 worktree 并在 Run on 下选择它。
只有当 environmentRecipes 条目位于项目 orca.yaml 的主检出上（不仅仅是某个功能分支）时，配方才会在工作区创建时出现。当你在脚本上迭代时，doctor 和实时配置仍可从任意分支运行。
自带云 —— 不是 DevAgent 的 VPS
云 VM 不会给你一个由 DevAgent 托管的 VPS。你需要自带提供方（并向该提供方付费）。DevAgent 运行你的 create/suspend/resume/destroy 脚本，并通过它们打印出的配对 URL 或 SSH 详情进行连接。
如何选择
- 保持本地，如果笔记本足够快且 agent 生命周期短暂。
- SSH，如果你已经有一台 VPS 或开发机，并希望 agent 在那里运行而无需安装第二个 DevAgent 运行时。
- Remote DevAgent Server，如果你想要一个常开的 DevAgent 运行时供移动端、浏览器和自动化使用。
- 云 VM / 按工作区环境，如果每项任务都应获得一个全新的、由配方定义的、随 worktree 一起消亡的沙箱。
你可以在一次安装中混用多种模式：本地 worktree 用于快速编辑、SSH 用于 GPU 主机、配方用于类 CI 的隔离。