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

本指南介绍在沙箱环境中对 Droid 进行身份验证、配置和使用的方法。Droid 是 Factory 推出的 AI 编程智能体。

官方文档：Droid

快速开始

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

$ sbx run droid ~/my-project

工作区参数是可选的，默认值为当前目录：

$ cd ~/my-project
$ sbx run droid

身份验证

Droid 需要一个 Factory 账户。两种身份验证方式都直接向 Factory 的服务认证 —— 与其他智能体不同，你无需提供模型提供商的密钥，Factory 通过你的 Factory 账户管理模型访问。

API 密钥：用存储的密钥保存你的 Factory API 密钥：

$ sbx secret set droid

OAuth：如果未设置 API 密钥，Droid 会在首次运行时提示你交互式完成身份验证。 代理会处理 OAuth 流程，因此凭据不会存储在沙箱内部。

配置

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

默认启动命令

沙箱运行 droid 时不带任何隐式标志。-- 之后的参数会原样透传：

$ sbx run droid -- exec "fix the build"

基础镜像

模板：docker/sandbox-templates:droid-docker

已预先配置为无需审批提示即可运行。身份验证状态在沙箱重启后依然保留。

有关预装工具或自定义此环境，请参阅自定义。