云端沙箱参考

AgentAPI 的云端环境运行在七牛 LAS Sandbox 上。基础环境版本记录预装软件及默认配置。

使用 claudecode 或 codex 时，可在对应 Release 的“预装工具版本”中查看 Claude Code、Codex 的版本，并核对任务依赖的软件包。native 是 AgentAPI 服务内的运行时，不随沙箱预装；调用文件和命令工具时，仍会使用云端环境的软件与网络配置。运行时选择见运行时和模型。

创建环境时由平台选择版本，已有环境不会自动升级。额外安装的软件包由环境配置指定。

用户身份与目录

云端命令、Native Bash 和文件操作统一以 root 执行。新会话默认 HOME 为 /root、工作目录为 /workspace；服务端配置可以覆盖默认值，会话创建后固定目录。

已有会话继续使用保存的目录，不随部署默认值变化。历史记录没有独立目录字段时，服务端从 Turn 日志绝对路径恢复 HOME；无法确定的 HOME 和旧工作目录回退到 /home/user。目录是否存在或当前进程的 $HOME 不能可靠判断旧布局。历史自定义工作目录需要由运维补录，不能自动推断。

Codex 与 Claude Code 的启动命令保持不变；Claude Code 以 root 使用跳过权限确认模式时，服务端设置 IS_SANDBOX=1。root 可以写入 root 所有的仓库，但不能绕过只读挂载或模型认证。自托管 worker 使用其自身配置的目录和身份。

基础环境版本

相关页面

• 云端环境：配置软件包和网络策略。
• 启动会话：在指定云端环境中启动会话。