Codex
Codex 沙箱机制拆解:不用容器,靠操作系统本身管住 AI 的每条命令
OpenAI 发布的《Inside the Codex sandbox》详细解释了 Codex 如何用各平台原生的沙箱机制(macOS Seatbelt、Linux bubblewrap、Windows MXC)限制 AI 生成的 shell 命令。文章梳理了权限配置、网络代理和已知漏洞,还附上独立验证结果,是一份少见的坦诚安全文档。
今天就能做
- 用 codex sandbox 实测你自己的权限配置:尝试写 .git/hooks、读 **/*.env、访问未列出的域名,确认拦截是否生效
- 在配置里显式 deny .env 文件和凭证目录,不要指望工作区边界能保护它们
- 把沙箱当作一层防线而非全部:工作区外的操作保持审批开启,并记住编辑器和工具链后续执行的代码不在沙箱管辖内
为什么不用 Docker 或虚拟机
- Codex 刻意不用容器:复刻本机开发环境成本高,部分工作流(如 Mac 上的 iOS 开发、iPhone 模拟器)在 Docker 里根本跑不了
- 改用各操作系统自带的沙箱设施,通过统一 API 暴露:传入命令和权限配置即可在限制下执行
权限配置:config.toml 里的规则
- 内置 :workspace 配置允许写工作区,但 .git 和 .codex 保持只读,防止改写 Git hooks 或自身配置
- 读取权限故意放宽,因为编译器和构建工具依赖仓库外的 SDK 和配置——代价是机器上其他位置的敏感文件(如含 API key 的配置)也可能被读到
- 网络默认关闭,既阻断数据外泄,也意味着下载依赖需要显式授权
网络代理:先审后连
- 三种网络模式:完全禁止、直连、经代理按域名规则审查
- 代理先判断请求是否被允许,之后才解析域名——因为 DNS 查询本身就能通过主机名泄露信息
- 直连在操作系统层面被阻断,程序无视代理变量也出不去
三个平台,三套实现
- macOS 用 Seatbelt(sandbox-exec),基础策略从 (deny default) 开始;虽然 Apple 标记为已弃用,但 Chrome 仍在用,OpenAI 计划继续依赖
- Linux 用 bubblewrap 加 seccomp-bpf:独立挂载命名空间控制文件系统,seccomp 过滤 connect() 和 bind() 等系统调用,并设置 no_new_privs 防提权
- Windows 换用微软的 MXC 执行容器库,替代了旧方案需要管理员权限、ACL 操作慢且留下持久状态的问题
已知漏洞:沙箱不是万能墙
- OpenAI 自己承认:agent 可以在 node_modules/prettier 里植入恶意代码,git status 不会显示,编辑器保存时格式化就会在沙箱外执行
- 独立测试 CLI 0.170.0 发现两个额外漏洞:Windows 上 .git、.codex 等保护只覆盖已存在的文件夹;运行前创建的硬链接保留自身权限,可借此修改 .git 内文件
- 设计哲学是纵深防御:沙箱限制访问范围,模型行为靠训练对齐来约束,两层缺一不可
不用 agent 也能用这个沙箱
- codex sandbox --permission-profile dev -- <命令> 可以在任意配置下运行任何命令
- 官方示例:验证恶意 VS Code 自动格式化插件无法写入 .vscode
- 同样可用于隔离 MCP 服务器,比如让 memory server 只能写自己的数据目录和 npm 缓存,且完全断网
原文:Your Coding Agent Runs Shell Commands on Your Laptop — Here's the Sandbox That Keeps It Honest
来源:DEV Community · 2026-11-19
查看原文本文由 AI 阅读原文后整理,未经人工逐字核对,内容以原文为准。
登录后可以点赞、查看和发表评论