根据你希望如何开发、如何为工具认证，或如何在自动化中运行本地沙箱来选择工作流。 命令语法和生命周期基础请参阅 Usage。

选择代码如何流转

你的工作区策略决定了智能体的变更何时出现在宿主上。直接模式就地修改宿主工作树。 Clone 模式把变更保留在私有克隆中，直到你获取或推送它们。宿主 worktree 提供分支 隔离，同时把 Git 操作留在宿主上。无挂载沙箱把仓库保留在沙箱内部，并把分支推送到 Git remote 以供审查或在宿主上使用。请参阅 Git workflows 为单个或并行任务选择策略。

在沙箱中开发

每个沙箱都有自己私有的 Docker daemon 和运行时，用于构建镜像、安装依赖和运行测试。 你可以从沙箱发布服务，或连接到宿主上的服务。请参阅 Develop and test locally。

沙箱内的工具可以使用在宿主上配置的凭据，无需把机密值复制进 VM。GitHub CLI、 镜像仓库和外部机密提供方的工作流请参阅 Authenticate command-line tools。

复用并自动化工作流

沙箱环境文件的作用类似于沙箱的 Compose 文件：它们把项目配置记录在一个受版本控制的 YAML 文件中。用 sbxenv.yaml 定义智能体、工作区、工具、资源、凭据和端口，让贡献者 无需重复 CLI 标志和设置步骤就能启动一致的环境。请参阅 Sandbox environment files。

你还可以从 Git 仓库添加技能，或从受支持的宿主智能体导入技能到持久化存储中，供新建 的沙箱共享。请参阅 Share agent skills。

对于无人值守的任务，使用无头认证并用脚本管理沙箱生命周期。请参阅 Run sandboxes in CI。