| 说明 | 接入云端沙箱；如果它已停止，会先将其启动 |
| 用法 | sbx attach SANDBOX [flags] |
描述
将交互式终端会话接入云端沙箱。
SANDBOX 是云端沙箱的 ID（sbx_*）或 "sbx --cloud ls" 中列出的名称。
会针对沙箱的智能体进程打开一个基于 PTY 的 exec 会话。沙箱必须已经存在； 如果它已停止，会先将其启动。使用 sbx --cloud run 可以在一步中创建沙箱并接入。
仅在 --cloud 下受支持。有关云端沙箱模型，请参阅 https://docs.docker.com/ai/sandboxes/。
选项
| 选项 | 默认值 | 说明 |
|---|---|---|
--detach-keys | 覆盖让会话继续运行的分离快捷键（Docker 风格，例如 "ctrl-\"、"ctrl-x,ctrl-d"）。默认：Ctrl-\. 当默认快捷键与智能体的键位映射冲突时使用（仅云端）。 |
全局选项
| 选项 | 默认值 | 说明 |
|---|---|---|
--cloud | 改为调用 Docker Cloud Sandboxes API，而不是本地 sandboxd（支持的动词正在逐步增加，运行 sbx --cloud --help 查看当前列表） | |
-D, --debug | 启用调试日志 | |
--no-input | 从不提示；需要应答的命令会直接失败，并给出应当运行的命令 |
示例
console
# 按 ID 或名称接入沙箱
sbx --cloud attach sbx_abc123
sbx --cloud attach claude/my-sandbox参见
sbx— 管理 AI 编程智能体沙箱。