Docker Sandboxes

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

Claude Desktop 可以通过 SSH 在远程机器上运行 Claude Code。把它指向沙箱，让智能体 在隔离环境中而不是在你的宿主上工作。

NOTE

本页介绍 Claude Desktop 通过 SSH 连接到沙箱。若要直接在沙箱内运行 Claude Code CLI，请参阅 Claude Code。

前置条件 ​

请使用以 Claude 智能体类型创建的沙箱。Claude 沙箱模板为远程 Claude Code 会话 配置了凭据注入和网络访问。你必须在连接之前提供该凭据。

WARNING

Claude Desktop 在 OAuth 刷新期间可以直接把 Anthropic 凭据写入沙箱。发生这种情况时， 请求会使用这些凭据，而不是代理的凭据注入。这些凭据会暴露在沙箱内部，从而降低隔离 保证。

连接 ​

关于首次连接时创建的专用沙箱，请参阅 Set up desktop app connections。 下面的步骤用于连接挂载了宿主工作区的沙箱。

如果还没有为当前目录创建具名的 Claude 沙箱，先创建一个：

console
$ sbx create --name demo claude .

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

console
$ ssh demo.sbx

在 Claude Desktop 中，在启动会话前打开环境下拉菜单，选择 + Add SSH connection。 输入连接名称，并在 SSH Host 中填入沙箱主机名（例如 demo.sbx）。SSH Port 和 Identity File 留空，因为托管的 SSH 配置会提供这两项。

从环境下拉菜单中选择该连接，然后用远程文件夹选择器 选择已挂载的工作区。选择器初始可能会打开 /home/agent。

更多连接选项请参阅 Claude Desktop 关于 SSH 会话的说明。

排查 token 刷新后 SSH 连接中断的问题 ​

Anthropic token 过期需要刷新时，SSH 连接会中断。要绕过这个问题，从你的宿主手动 运行沙箱：

console
$ sbx run --name <sandbox-name>

排查 Windows 上 SSH 连接超时的问题 ​

Claude Desktop 在 Windows 上需要 Git。如果 SSH 连接超时，且 Claude Desktop 日志中 出现 ProxyCommand error: spawn sh ENOENT，请安装 Git for Windows。

如果已经安装了 Git，请确认 sh.exe 在你的 PATH 中可用：

powershell
PS> where.exe sh

如果该命令找不到 sh.exe，请把 Git 的 bin 目录加入你的用户 Path。默认目录是 C:\Program Files\Git\bin。更新 Path 后请退出并重新启动 Claude Desktop。