跳转到主要内容
AgentKit 沙箱是一个云端的 code 工具环境，可在其中用 Codex 等编码智能体开发应用：无需在本地准备运行环境，会话可持久保留，代码可双向传输，构建中的应用还能通过 Web 预览查看。沙箱各命令的完整参数见使用沙箱。
开始前请确认已配置火山引擎访问密钥，即环境变量 VOLCENGINE_ACCESS_KEY 与 VOLCENGINE_SECRET_KEY。
创建沙箱会在云端分配计算资源，资源存续期间可能产生费用。沙箱中的命令可以访问其可见的文件、网络和凭据，只在受信任的项目中使用，并按最小权限配置。删除会话或沙箱不可恢复，执行清理前先下载需要保留的文件。

​
端到端流程

1

创建沙箱

沙箱是一个 code 环境。若项目中还没有，先创建一个：
命令返回该沙箱的 ID。后续沙箱命令会在项目内自动解析 code 沙箱：仅有一个时自动选用，存在多个时需用 --tool-id 指定（可用 agentkit sandbox list 查询）。也可省去这一步，在首次运行沙箱命令时加 --auto-create 自动创建。
2

进入沙箱用 Codex 开发

打开沙箱会话的交互式终端，在其中运行 codex 进行开发：
--session dev 指定会话名称，后续命令复用同一名称即可回到同一环境；--tmux 会打开或接入一个持久化终端会话，断开后重连不会丢失进度（按 Ctrl-] 脱离）。若要把本地已有的代码带入沙箱，可在打开终端前上传：
沙箱内编码智能体所用的模型可通过 --model-name、--model-api-key、--model-provider 指定。
3

在本地与沙箱之间传输文件

远端一侧以 : 前缀标记。上传与下载：
4

预览构建中的应用

若在沙箱内启动了 Web 服务，可打开沙箱的 Web 预览查看：
5

清理会话

开发结束后停止并删除会话；也可用 --all 清空该沙箱工具上的全部会话：
sandbox rm 会删除会话及其中未持久化的文件，但不会删除沙箱本身。确认文件已备份后再执行；不再使用沙箱时，另用 sandbox delete <sandbox-id> -y 删除云资源。
sandbox login 会将本地订阅凭据复制到远端沙箱会话。仅在受信任的沙箱和专用会话中使用，避免向他人共享该会话；使用完成后删除会话。
为沙箱内的 Codex 提供登录凭据有多种方式，注入本地订阅是其中之一。若本地已通过 codex login 登录，可将订阅凭据注入会话：
该命令默认读取本地 ~/.codex/auth.json，也可用 --auth-file 或 --codex-home 指定来源。将 --provider 换成 claude，即可改为注入本地的 Claude 订阅，在沙箱中使用 Claude Code。

​
脚本化执行

除交互式终端外，sandbox run 可在会话中执行单条命令并打印输出，便于脚本或自动化流程调用：

​
实践建议

  • 复用同一会话：以固定的 --session 名称贯穿一次开发，保留环境与进度；用 agentkit sandbox sessions 查看活跃会话，用 agentkit sandbox logs <session> 排查问题。
  • 明确指定沙箱：项目内存在多个 code 沙箱时，命令会要求显式传入 --tool-id；先用 agentkit sandbox list 查到目标 ID。
  • 长任务用 --tmux：交互式开发建议加 --tmux，避免网络中断导致会话丢失。
最后修改于 2026年9月19日