Docker Sandboxes

这些连接说明使用的是本地沙箱。关于云端 SSH 设置，请参阅 Connect with SSH。

Orca 并行运行编程智能体，每个智能体使用自己的 git worktree。Orca 没有专用的 Docker Sandboxes 集成：它把沙箱当作普通的 SSH 主机，在其中安装一个小型中继程序， 并在其中运行智能体、终端和 git，而编辑器和 diff 视图留在你的宿主上。

前置条件 ​

Orca 的远程终端需要 node-pty，该包仅为 macOS 和 Windows 提供预编译二进制文件。 在 Linux 沙箱中它会从源码编译，而这个构建过程需要 C++ 编译器。Docker 提供的模板 已包含编译器，因此从模板创建的沙箱可以直接连接。

用自定义 base image 构建且不含 编译器的沙箱仍可连接，文件、git 和编辑器都能正常工作，但远程终端无法启动。把 工具链加入镜像，或在运行中的沙箱里安装它，直到可以连接为止：

console
$ sbx exec <sandbox> -- sudo apt-get update
$ sbx exec <sandbox> -- sudo DEBIAN_FRONTEND=noninteractive apt-get install -y build-essential

连接 ​

确认你可以通过终端连接到该沙箱：

console
$ ssh demo.sbx
  1. 在 Orca 中打开 Settings → SSH，选择 Add Target。
  2. 把沙箱主机名（例如 demo.sbx）填入 host，用户名填 _default_user_。保持默认 端口，identity file 留空。
  3. 选择 Test 检查连接，然后选择 Save。
  4. 创建一个 worktree，并在 Run on 下选择该沙箱。

首次连接会在沙箱内安装 Orca 的中继程序，因此需要一点时间。之后的连接会快很多。

_default_user_ 是 sbx setup ssh 写入的托管 SSH 配置中的保留用户名。它指示 daemon 以沙箱镜像的默认用户身份运行。任何其他用户名都会被按字面理解为沙箱内的 用户名。

运行智能体 ​

Orca 会为 worktree 启动你选择的智能体；沙箱不会替你自动启动智能体。Orca 会为 新启动的会话预先填好每个智能体的跳过权限标志，例如 Claude Code 的 --dangerously-skip-permissions，sbx run 启动同一批智能体的方式也是如此。

Orca 只提供它在其所连接主机上找到已安装的智能体，因此请用你打算驱动的智能体来 创建沙箱：

console
$ sbx create --name demo claude .

凭据留在你的宿主上。如果你把它们存为 凭据，沙箱代理会在智能体发起请求时注入它们， 因此智能体无需让该值进入沙箱即可完成认证。