| 说明 | 在沙箱内执行命令 |
| 用法 | sbx exec [flags] SANDBOX COMMAND [ARG...] |
描述
在沙箱中执行命令。如果沙箱已停止，会先将其启动。或者——使用 --cloud——传入 "sbx --cloud ls" 中的云端沙箱 ID（sbx_*）或名称。--cloud 不支持 --user。 --detach-keys 仅适用于交互式（-i/-t）的云端 exec。
退出状态即命令的退出状态。如果 sbx 无法运行该命令（例如沙箱不存在），则以 125 退出。命令不存在时以 127 退出；但如果云端后端把它报告为错误而非状态码，则以 125 退出。
选项
| 选项 | 默认值 | 说明 |
|---|---|---|
--detach-keys | 覆盖用于分离交互式云端 exec 会话的按键组合（本地 exec 不支持） | |
-e, --env | 设置环境变量 | |
--env-file | 从文件读取环境变量 | |
-i, --interactive | 即使未接入也保持 STDIN 打开 | |
-t, --tty | 分配伪 TTY | |
-u, --user | 用户名或 UID（格式：<name|uid>[:<group|gid>]） | |
-w, --workdir | 容器内的工作目录 |
全局选项
| 选项 | 默认值 | 说明 |
|---|---|---|
--cloud | 改为调用 Docker Cloud Sandboxes API，而不是本地 sandboxd（支持的动词正在逐步增加，运行 sbx --cloud --help 查看当前列表） | |
-D, --debug | 启用调试日志 | |
--no-input | 从不提示；需要应答的命令会直接失败，并给出应当运行的命令 |
示例
console
# 在沙箱内打开 shell
sbx exec -it my-sandbox bash
# 以 root 身份运行
sbx exec -u root my-sandbox apt-get update
# 云端：通过 ID 或名称在云端沙箱中运行命令
sbx --cloud exec -it sbx_abc123 bash
sbx --cloud exec -it claude/my-sandbox bash参见
sbx— 管理 AI 编程智能体沙箱。