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

官方文档：Docker Agent

快速开始

创建沙箱，并为项目目录运行 Docker Agent：

$ sbx run docker-agent ~/my-project

sbx run docker-agent 默认把工作区设为当前目录，因此你可以在项目内部运行它。

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

身份验证

Docker Agent 支持多家提供商。用存储的密钥 保存你想使用的提供商的密钥：

$ sbx secret set openai
$ sbx secret set anthropic
$ sbx secret set google
$ sbx secret set xai
$ sbx secret set nebius
$ sbx secret set mistral
$ sbx secret set openrouter

你只需配置想使用的提供商。Docker Agent 会检测可用的凭据，并把请求路由到相应的 提供商。

配置

沙箱不会读取宿主机的用户级配置。沙箱内只有工作目录中的项目级配置可用。变通方法 请参阅 沙箱为什么不用我的用户级智能体配置？。

默认启动命令

不带额外参数时，沙箱运行：

docker-agent run --yolo

要传递标志、提示词或配置文件，请参阅 向智能体传递参数。

基础镜像

沙箱使用 docker/sandbox-templates:docker-agent。要在该基础镜像之上构建自己的镜像， 请参阅基础镜像。