尧图网站建设 尧图网络
  • 首页
  • 关于我们
  • 服务项目
  • 案例展示
  • 建站流程
  • 资讯中心
  • 联系我们
首页/资讯中心/详情

Codex Windows Sandbox 启动失败:CreateProcessAsUserW failed: 2 的原因与修复

Codex Windows Sandbox 启动失败:CreateProcessAsUserW failed: 2 的原因与修复
📅 发布时间:2026/7/6 2:43:14

一、问题背景

在 Windows 上使用 Codex CLI / Codex Desktop 时,我遇到了两个看起来相关、但实际属于不同层级的问题。

最开始执行:

codex sandbox windows cmd /c echo test

报错:

windows sandbox failed: runner error: CreateProcessAsUserW failed: 2

后来在让 Codex 往文件里写内容时,又弹出 Windows 错误窗口,路径类似:

C:\Program Files\WindowsApps\OpenAI.Codex_...\app\resources\codex-windows-sandbox-setup.exe

错误内容:

找不到指定的模块。

一开始我以为是 Codex sandbox 本身坏了,但完整排查后发现,这是两个不同问题:

  1. 第一个问题是 Codex CLI 新版本的 sandbox 命令格式变了。
  2. 第二个问题是 Windows 原生 sandbox 的elevated模式在本机 setup 阶段失败。

二、环境信息

当前 Codex 版本:

codex --version

输出:

codex-cli 0.142.5

当前机器上实际存在两套 Codex 来源:

C:\Users\Amber\AppData\Roaming\npm\... C:\Program Files\WindowsApps\OpenAI.Codex_...\app\resources\...

其中 npm 版 Codex CLI 路径大致是:

C:\Users\Amber\AppData\Roaming\npm\node_modules\@openai\codex

Codex Desktop 自带资源路径大致是:

C:\Program Files\WindowsApps\OpenAI.Codex_...\app\resources

三、第一个问题:codex sandbox windows已经不是新版写法

原命令:

codex sandbox windows cmd /c echo test

报错:

windows sandbox failed: runner error: CreateProcessAsUserW failed: 2

查看新版帮助:

codex sandbox --help

可以看到当前版本的格式是:

Usage: codex sandbox [OPTIONS] [COMMAND]...

也就是说,sandbox后面直接跟要执行的命令。

新版正确写法是:

codex sandbox cmd /c echo test

输出:

test

根因

在 Codex CLI0.142.5中,windows已经不是sandbox的子命令。

所以这条旧命令:

codex sandbox windows cmd /c echo test

会被新版 CLI 理解成:

在 sandbox 里运行一个叫 windows 的程序,并传入 cmd /c echo test

但 Windows 上没有名为windows的可执行文件,于是底层CreateProcessAsUserW返回错误码2,也就是文件找不到。

解决方式

推荐直接改用新版写法:

codex sandbox cmd /c echo test

如果仍想兼容旧写法,可以在 npm 版入口脚本中做兼容处理,把:

codex sandbox windows ...

自动转换为:

codex sandbox ...

我当时修改的位置是:

C:\Users\Amber\AppData\Roaming\npm\node_modules\@openai\codex\bin\codex.js

加入的逻辑大致如下:

const childArgs = process.argv.slice(2); if ( process.platform === "win32" && childArgs[0] === "sandbox" && childArgs[1] === "windows" ) { childArgs.splice(1, 1); } const child = spawn(binaryPath, childArgs, { stdio: "inherit", env, });

这一步解决的是旧命令格式兼容问题。

但是,它并没有解决后面那个“找不到指定模块”的弹窗。


四、第二个问题:写文件时codex-windows-sandbox-setup.exe报错

后面在让 Codex 往 workspace 文件里写内容时,又出现了新的错误窗口:

C:\Program Files\WindowsApps\OpenAI.Codex_...\app\resources\codex-windows-sandbox-setup.exe 找不到指定的模块。

这个问题和codex sandbox windows的命令格式无关。

这里出问题的是 Codex Desktop 自带的 Windows sandbox setup 程序。


五、进一步排查

先验证基础 sandbox 是否能运行:

codex sandbox cmd /c echo test

结果:

test

说明 sandbox 基础命令执行能力是正常的。

再测试 workspace 写入:

codex sandbox -c 'sandbox_mode="workspace-write"' cmd /d /c "echo final-write-ok>codex_final_write_test.txt"

然后读取文件:

Get-Content .\codex_final_write_test.txt

结果:

final-write-ok

说明在正确的 workspace-write 配置下,sandbox 也能正常写文件。

也就是说,真正的问题集中在 Windows sandbox 的 setup 模式上。


六、elevated和unelevated的区别

Codex Windows 原生 sandbox 支持两种模式:

[windows] sandbox = "elevated" # or "unelevated"

elevated

elevated是官方推荐的首选模式。

它会使用:

专门的低权限 sandbox 用户 文件系统 ACL 边界 防火墙规则 本地安全策略调整

优点是隔离更完整、安全边界更强。

但缺点是它需要运行:

codex-windows-sandbox-setup.exe

来做系统级准备。

如果 WindowsApps 权限、MSIX 包隔离、管理员权限、本地安全策略、企业安全软件或系统依赖有问题,就可能在 setup 阶段报错。

我这里看到的弹窗就是这一类问题。

unelevated

unelevated是 fallback 模式。

它不会走完整的 elevated setup,而是基于当前用户派生一个受限 Windows token,并用 ACL 做文件访问限制。

优点是兼容性更好,更容易启动。

缺点是隔离强度弱于elevated,尤其是防火墙和专用低权限用户这部分不如 elevated 完整。

简单理解:

elevated = 更安全、更完整,但更依赖系统 setup unelevated = 兼容性更好,隔离稍弱,但仍然是 sandbox

七、最终解决方案

由于本机elevated模式会触发 Codex Desktop 包路径里的 setup 程序错误,所以我把 Codex 配置改成了unelevated。

配置文件位置:

C:\Users\Amber\.codex\config.toml

修改前:

[windows] sandbox = "elevated"

修改后:

[windows] sandbox = "unelevated"

这不是关闭 sandbox,而是切换到 Windows 原生 sandbox 的备用实现。


八、验证结果

修改后验证基础命令:

codex sandbox cmd /c echo test

输出:

test

验证旧写法兼容:

codex sandbox windows cmd /c echo test

输出:

test

验证 workspace 写入:

codex sandbox -c 'sandbox_mode="workspace-write"' cmd /d /c "echo final-write-ok>codex_final_write_test.txt"

读取结果:

final-write-ok

运行诊断:

codex doctor --summary

结果:

17 ok · 1 idle · 1 notes · 0 warn · 0 fail ok

九、最终结论

这次问题不能只归结为“sandbox 坏了”。

完整结论是:

1. codex sandbox windows cmd /c echo test 报错,是因为新版 Codex CLI 不再需要 windows 子命令。 2. 写文件时弹出 codex-windows-sandbox-setup.exe 找不到模块,是 elevated Windows sandbox setup 阶段的问题。 3. sandbox 本身可以运行,workspace-write 模式也可以正常写文件。 4. 当前机器上更稳定的解决方式是把 Windows sandbox 从 elevated 切到 unelevated。

最终推荐配置:

[windows] sandbox = "unelevated"

等以后 Codex Desktop 或本机 WindowsApps / setup 权限问题修复后,可以再切回:

[windows] sandbox = "elevated"

十、补充说明

如果只是手动测试 sandbox 命令,建议使用新版格式:

codex sandbox cmd /c echo test

如果要测试写入,需要显式使用 workspace-write:

codex sandbox -c 'sandbox_mode="workspace-write"' cmd /d /c "echo test>test.txt"

不要用旧格式:

codex sandbox windows cmd /c echo test

除非你自己做了兼容处理。

相关新闻

  • Win11Debloat:Windows系统清理优化的终极免费解决方案
  • ssm267防疫信息登记系统的设计与实现+jsp(文档+源码)_kaic
  • Visual C++ AIO运行时库:Windows系统必备的终极解决方案

最新新闻

  • Linux内核CFS完全公平调度器:从vruntime到负载均衡的深度实现分析
  • Selenium 高级进阶操作详解
  • IPC-2152 标准深度解析:3大常见误区与5个影响通流的关键PCB设计参数
  • Windows Mobile下访问Sqlite的Native C++封装
  • 域名与DNS批量管理实战:OpenClaw自动解析检测、批量修改与监控全攻略
  • 多品牌集合店营收分配程序,测算设计师品牌,快时尚,奢品搭配销售最优比例。

日新闻

  • AI智能体安全防护框架AgentGuard:从原理到实战部署指南
  • KMX63与PIC18F26K40硬件组合及低功耗设计实践
  • 基于YOLO13改进的门体检测模型:C3k2模块与PoolingFormer技术解析

周新闻

  • 基于YOLOv12的番茄成熟度智能检测系统开发
  • 终极RimWorld模组管理指南:用RimSort告别模组冲突烦恼
  • AI Agent框架开发:从理论到实践的完整指南

月新闻

  • 2026年6月公司网站搭建最新热门渠道测评:四大低成本/零代码平台对比+避坑
  • 【Linux】Linux arm 编译QT程序,出现expected “}“报错
  • 【MATLAB例程】四基站二维AOA定位与距离辅助增强对比仿真。基于角度观测和测距修正的固定目标平面定位精度分析

关于尧图

  • 公司简介
  • 团队介绍
  • 企业文化
  • 荣誉资质

服务项目

  • 定制开发
  • 电商建站
  • UI 设计
  • 运维服务

快速链接

  • 案例展示
  • 建站流程
  • 常见问题
  • 资讯中心

联系方式

  • 📍北京市朝阳区互联网产业园 A 座 10 层
  • 📞400-888-8888
  • ✉️contact@rkmt.cn
  • 🕐周一至周日 9:00-21:00

© 2024 北京尧图网络科技有限公司 版权所有 | 京 ICP 备 XXXXXXXX 号