学习精选 · AI 工具
Codex

Codex 沙箱机制拆解:不用容器,靠操作系统本身管住 AI 的每条命令

DEV Community2026-11-19约 4 分钟读完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 阅读原文后整理,未经人工逐字核对,内容以原文为准。

登录后可以点赞、查看和发表评论