OpenAI 发文详解 Codex 沙箱的设计:依托各操作系统原生隔离机制约束命令,默认禁止联网、限制写入 .git 与 .codex 等目录,并通过网络代理与分层配置让用户和企业精细掌控权限。
OpenAI 采用纵深防御策略保障智能体安全。训练与对齐是基础,而执行框架 Codex 中的沙箱则提供额外保护。在用户计算机上运行命令是 Codex 最常见的操作之一,也潜藏风险。Codex 沙箱让 Codex 在用户现有环境中工作,同时遵守由用户掌控的文件系统与网络限制。
沙箱会限制程序运行时能访问的资源。整理照片时,可允许命令读写 ~/Pictures,同时禁止联网以防上传;审查代码时,可允许访问在线文档,同时将源文件设为只读。用户通过权限配置集定义这些限制。
Codex 的理念是默认权限保守,但仍能完成实际工作。当工作空间根目录是 Git 仓库时,内置的 :workspace 配置集会:
.git、.codex 等目录保持只读,让 Codex 可编辑源码而无须每次请求许可,也无法篡改 Git 钩子或配置文件。这些限制能挡住一大类不良行为,但并非万无一失。例如智能体可能向 node_modules/prettier 注入恶意代码,而该目录通常不在 git status 中显示;若编辑器保存时运行 Prettier,恶意代码就会在沙箱之外执行。这正是纵深防御的意义:沙箱限制可访问的资源,训练与对齐则引导模型按用户意图使用这些权限。
虚拟机和容器是常见的沙箱机制,Codex 走的是另一条路:不将计算任务移入独立环境,而是利用各平台原生沙箱机制,约束在用户现有环境中运行的命令。
开发者的笔记本本身就是量身定制的开发环境。若把 Codex 放进 Docker 开发 iOS 应用,它既跑不了 Mac 原生构建工具链,也启动不了 iPhone 模拟器;把构建交回主机又会在沙箱之外执行。因此 Codex 选择在操作系统层面做隔离,让命令在最合适的环节中运行。
执行框架通过一套跨 macOS、Windows、Linux 的通用 API 提供这些机制:传入一条命令和权限配置集,返回子进程句柄。子进程继承父进程的沙箱约束,限制作用于整个进程树。
Codex 执行框架负责执行模型生成的工具调用,最常用的是 shell 工具。以单次执行的 exec_command 为例:要沙箱化运行,框架将 subprocess.Popen() 替换为 spawn_command_under_sandbox(),并提供权限配置集和网络代理。
模型也可为单条命令请求不同权限,但由框架裁决:use_default 沿用当前默认配置,with_additional_permissions 请求扩大访问,require_escalated 请求在沙箱外执行。框架会在执行前按用户偏好评估,可能直接询问用户,也可能交由自动审核。
沙箱基础设施同样被复用于读取和修改本地文件等操作,并可通过 codex sandbox 命令集成到自有工具中。
权限配置集可命名并跨项目复用,在 config.toml 的 [permissions] 下定义。例如名为 dev 的配置集扩展了 :workspace,额外允许写入 ~/build-cache,并将 .vscode 目录设为只读。文件系统条目可授予 read、write 或 deny。
网络配置有三种选择:完全禁用(:workspace 默认)、完全直连(:danger-full-access 默认)、或仅允许经代理访问并按域名规则放行。域名规则支持精确名与通配符,显式拒绝优先于允许。
个人用户可设置全局默认并针对可信项目覆盖;企业管理员可通过 requirements.toml 等托管要求限制可选配置集,例如用 allowed_permission_profiles 禁用 :danger-full-access。云端要求优先级高于系统要求文件。
codex sandbox 测试配置codex sandbox 可在指定配置集下运行任意命令,常用于验证沙箱是否拦住预期行为。例如试图让 VS Code 在保存时运行恶意格式化程序,dev 配置集会因 .vscode 只读而阻止写入。
一个实用场景是约束 MCP 服务器。Codex 不会自动沙箱化 config.toml 中配置的 stdio MCP 服务器,因其难以推断所需文件与网络服务。可用 codex sandbox --permission-profile memory-mcp 包装启动命令,限制写入位置并禁用网络;预先将锁定版本的软件包存入 npm 缓存,即可用 npx --offline 在无网环境下启动。
执行框架启动网络代理,并配置沙箱只允许连该代理。代理由 codex-network-proxy crate 实现,默认同时启动 HTTP 与 SOCKS5 代理,并通过 HTTP_PROXY、PIP_PROXY 等环境变量传入沙箱。不遵循这些变量的程序会被操作系统层面的限制拦下。代理按域名规则检查每个请求;目标既不匹配允许也不匹配拒绝时,可暂停请求交执行框架审批。代理只有在确认授权后才解析主机名,以防 DNS 查询泄露信息。
Codex 使用苹果内核级沙箱 Seatbelt,通过 /usr/bin/sandbox-exec 调用,策略用基于 Scheme 的 SBPL 编写。Codex 从基础策略出发,按权限配置集拼装完整的 Seatbelt 配置集与 -D 参数。苹果未向第三方公开该语言文档,且 sandbox-exec 已被标记弃用,但 Chrome 等软件仍在依赖,Codex 计划继续使用。
Codex 结合 bubblewrap(bwrap)与 seccomp-bpf。codex-linux-sandbox 辅助程序先用 bwrap 在独立挂载命名空间构建文件系统视图,再在其中启动自身并施加 seccomp 限制。隔离用到 --bind、--ro-bind、--unshare-net 等标志;拒绝访问的 glob 模式在每次启动前展开为具体路径。若需联网且走代理,沙箱通过 Unix 套接字把回环 TCP 监听器的文件描述符交给沙箱外进程,由其转发至代理,从而不向命令暴露主机网络命名空间。
Codex 正将现有 Windows 沙箱替换为基于微软 MXC(Microsoft eXecution Container)的方案,以解决原方案需管理员权限、ACL 操作缓慢、主机上残留沙箱状态等问题。Codex 用 MXC SDK 构建执行请求,将权限配置集转换为文件系统与网络规则,并对剪贴板、输入注入等控制项采用固定安全设置。网络域名规则仍由共享代理实施。
在三个平台上,执行框架都用同一套沙箱 API 在权限配置集约束下启动命令。沙箱是可复用的基础组件,codex sandbox 让自建工具也能使用。OpenAI 表示将继续简化权限配置,并在操作系统提供更强保护时及时采用,在拓展智能体能力的同时,让人始终掌控其可访问的资源。
免费获取企业 AI 成熟度诊断报告,发现转型机会
关注公众号

扫码关注,获取最新 AI 资讯
3 步完成企业诊断,获取专属转型建议
已有 200+ 企业完成诊断