本页介绍的是本地沙箱。有关云端行为及其限制，请参阅对比本地沙箱与云沙箱。

sbx run shell 会把你放进沙箱内的一个 Bash 登录 shell，其中没有预装任何智能体 二进制文件。它适用于手动安装和配置智能体、测试自定义实现，或查看正在运行的环境。

$ sbx run shell ~/my-project

sbx run 默认把工作区设为当前目录。要运行一次性命令而不是交互式 shell，请把该 命令放在 -- 之后：

$ sbx run shell -- -c "echo 'Hello from sandbox'"

要创建无挂载沙箱，使用不带工作区路径的 sbx create，然后按名称连接：

$ sbx create --name scratch shell
$ sbx run --name scratch

默认启动命令

不带额外参数时，沙箱运行 bash -l。当 -- 后的第一个参数是标志（以 - 开头）时， 它会被追加到 -l 之后，因此登录 shell 的行为得以保留：

$ sbx run shell -- -c "echo hi"   # 运行 bash -l -c "echo hi"

当第一个参数是不带标志的普通词时，它会取代 -l。

运行沙箱之前，用存储的密钥保存 凭据。代理会把它们注入到出站 API 请求中；凭据绝不会存储在 VM 内部：

$ sbx secret set anthropic
$ sbx secret set openai

进入 shell 后，你可以用各智能体的标准方式安装它们，例如 npm install -g @continuedev/cli。对于复杂的配置，请改为构建 工作负载 Kit，而不是每次都以交互 方式安装。

基础镜像

shell 沙箱使用 shell 基础镜像 —— 即不含预装智能体的通用基础环境。