Codex Windows 沙盒:三档权限与 CI 锁定
11月5日OpenAI为Codex加入Windows原生沙盒。本文拆清三档sandbox_mode、审批策略、网络默认关闭与CI版本锁定,给出最小权限落地清单。
2026-11-10 15:21:17 · 主编:刘立永2026 年 11 月 5 日,凤凰网科技报道 OpenAI 在 10 月开发者更新汇总中给 Codex 加入面向 Windows 的新沙盒机制,用于控制智能体对网络与文件系统的访问权限。iThub 目录(11 月 7 日更新,整理自 Codex 官方文档)列明:sandbox_mode 分 read-only、workspace-write、danger-full-access 三档,且 workspace-write 下命令默认无网络。这是权限边界,不是功能开关。
一、沙盒与审批是两层,别用一个开关代替
据 iThub 对官方文档的整理,sandbox_mode 决定「技术上能做什么」,approval_policy 决定「什么时候必须问人」。Auto 预设等价于 --sandbox workspace-write 加 --ask-for-approval on-request:Agent 可在工作目录内改文件、跑命令,写目录外或联网才弹审批。旧的 untrusted 审批策略已退役,配置里残留这一行可能导致客户端直接起不来。
这里要标清来源口径:Windows 沙盒上线是凤凰网科技转述 OpenAI 的更新汇总;三档模式、退役策略与下列配置细节来自 iThub 目录站对官方文档的二手整理,不是我们逐条核对官方原文的结果。落地前应在实际环境用 codex --help 与官方文档复核。
二、Windows 三种实现,前置条件写在 build 号上
同一份整理给出的 Windows 原生沙盒有三条路径。MXC 基于 Microsoft Execution Containers 做进程隔离,要求 Windows 11 24H2(build 26100.9278)或 25H2(build 26200.9278),无需管理员预先设置;自 0.162.0 起可用单条命令测试,正常应输出 MXC_OK、退出码 0。elevated 需要管理员批准的一次性设置,使用专用低权限用户与防火墙规则,对应 codex sandbox setup --elevated。unelevated 是受限令牌下的弱回退。管理员可用 requirements.toml 限定可用实现、禁用 MXC。
还有一处不一致值得记:当前官方文档描述 CLI 可在 PowerShell 原生运行、无需 WSL,但仓库的 install guide 仍写着 Windows 11 需经 WSL2。给客户装机时别照抄旧教程,先跑版本与沙盒自检。
三、网络默认关闭,域名规则要先开代理
workspace-write 模式下命令没有网络访问,必须显式设置 sandbox_workspace_write.network_access = true 才放行。启用 network_proxy 特性后,可按 allow 与 deny 规则约束出站域名;只匹配子域与同时匹配主域是两种不同写法,别混用。关键在于:未启用代理特性时,域名规则不生效——不少团队以为配了白名单就安全,其实网络仍是全开或全关。
0.167.0 的官方发布说明还加入了一个实验项,可在 /experimental 选择接入 macOS 或 Windows 系统代理(GitHub releases,11 月 6 日)。企业内网有统一出口代理时,这一项比逐台配域名更可控。
四、CI 与多会话的锁定清单
非交互用 codex exec:默认只读沙盒,进度走 stderr、最终结果走 stdout 便于管道处理,支持 --json 事件流、--output-schema 结构化结果、--ephemeral 不写会话文件、--ignore-user-config 保证可复现;旧教程里的 --full-auto 已不再支持。需要写文件时显式加 --sandbox workspace-write。
版本固定同样有官方依据:每个 GitHub release 都带 SHA256SUMS、Linux 归档的 Sigstore bundles,以及一个可提交进仓库的 DotSlash 指针文件,让所有贡献者跑同一版本(iThub,11 月 7 日)。MCP 侧有个容易被忽略的闸门:标记 required = true 的 server 启动失败时,codex exec 会直接报错退出,而不是静默跳过;带破坏性标注的工具调用始终要求审批。项目级 .codex/config.toml 只对可信项目加载,不可信项目会跳过项目层、hooks 与 rules,provider 与 telemetry 键在项目文件里被忽略。
GitHub Action 方面,openai/codex-action@v1 跑在 Linux 或 macOS runner,Windows runner 需要 safety-strategy: unsafe。这是明确的安全降级,别在能接触客户数据的托管机上照抄。
五、给企业技术团队的三条动作
第一,把权限基线写进交付物。AGENTS.md 负责告诉 Agent「应该怎么做」,config.toml 负责限制「实际能做什么」,两者不能互相替代。我们给山东制造企业做 MES、ERP 实施时,生产库账号、接口凭据与变更窗口本来就按最小权限和审批链配置,编码 Agent 应纳入同一套权限台账,而不是由每个开发者在各自的 ~/.codex 里自行决定。
第二,先从只读模式起步。代码审查、存量系统勘察、报表口径核对这类任务用 read-only 就够;确需改代码再按任务开 workspace-write,网络单独审批并留审计记录。把 MXC_OK 自检结果列为终端入网的前置检查项,比事后查日志便宜得多。
第三,CI 里锁版本、校验哈希、保留 Agent 产出的 diff 与测试证据。审计时能回答「哪一版工具、改了哪些文件、跑了什么测试」,比「AI 写的」这种描述有用。Windows runner 若必须用 unsafe 策略,放进隔离容器、不连客户数据,并作为例外登记。
参考来源:
1. 凤凰网科技(腾讯新闻转载),《OpenAI开发者工具升级:Codex最高提速8倍,智能体装上「决策大脑」》,2026年11月5日,https://news.qq.com/rain/a/20261105A0352O00
2. iThub Directory,《Codex CLI》,页面更新2026年11月7日,https://www.ithub.directory/ai-coding-assistants/openai-codex
3. GitHub,openai/codex Releases(rust-v0.167.0),2026年11月6日,https://github.com/openai/codex/releases
4. AICoder,《OpenAI Codex CLI 0.167.0 发布:Agent 指挥中心、后端切换与 Vertex AI 向导》,2026年11月6日,https://aicoder.com/news/news-20261106-openai-codex-cli-0-167-agent-command-center-backend-switch-vertex-wizard
5. Freaky Jolly,《Codex 0.167.0: Agent Command Center, Backend Switching and Vertex AI Setup》,2026年11月6日,https://freakyjolly.com/codex-agent-command-center-guide