现象
Codex 桌面版输入框顶部出现红色提示:
Windows 设置未完成
设置已停止
点击“重新设置”后仍然失败。
这个设置是做什么的?
这是 Codex 的 Windows 沙盒设置,用来限制 AI 执行命令时可以访问的文件、网络和系统资源,降低误操作风险。
它不是 Windows 更新,也不是 Codex 登录设置。
旧版 elevated 模式需要创建沙盒用户,并向 Windows 防火墙写入规则。只要防火墙策略不允许本地程序修改规则,设置就会失败。
根本原因
这次故障不是防火墙服务停止,而是当前防火墙策略不接受本地规则修改。
Codex 日志中的关键错误是:
helper_firewall_policy_ineffective
LocalPolicyModifyState=NET_FW_MODIFY_STATE(2)
这表示 Codex 虽然可以启动防火墙服务,但它添加的本地规则不会生效。常见原因包括:
- Windows 更新后重新应用了系统安全策略;
- 组策略或安全软件接管了 Windows 防火墙;
- Codex 重新检查沙盒环境,需要再次写入防火墙规则;
- 当前系统版本还不支持新版 MXC 沙盒。
为什么之前正常,今天突然失败?
之前已经创建好的沙盒环境可以继续使用,不代表以后重新设置时仍然可以写入防火墙规则。
本次故障的时间线是:
- 之前的 Codex 沙盒设置成功过;
- Windows 更新或安全策略刷新后,Codex 重新检查沙盒环境;
- 旧的
elevated模式再次尝试修改防火墙规则; - 本地规则被当前策略拒绝,于是显示“Windows 设置未完成”。
系统更新和故障出现的时间接近,但仅凭日志不能确定是哪一个更新补丁直接造成了问题。可以确定的是,真正阻止设置完成的环节是防火墙本地规则无法生效。
修复方法
方法一:完成 Windows 25H2 更新
这是本次问题的推荐处理方式。
- 打开“设置 → Windows 更新”。
- 完成 Windows 11 25H2 安装。
- 按提示重启电脑,必要时再检查一次更新。
- 按
Win + R,输入winver,确认版本为25H2,内部版本为26200.x。 - 完全退出 Codex,再重新打开。
更新完成后,兼容设备可以使用 MXC 沙盒。MXC 不依赖旧版 elevated 模式的本地防火墙规则,因此可以绕过这次故障点。
本次实际修复后,Codex 日志显示:
MXC availability: true
Windows sandbox selection: mxc
同时,更新后的日志中不再出现新的 helper_firewall_policy_ineffective 错误。
方法二:仍然失败时检查防火墙策略
如果更新到 25H2 后仍然失败,重点检查以下内容:
- 是否安装了第三方安全软件或防火墙管理工具;
- 是否加入了公司、学校的设备管理或组策略;
- 安全软件是否禁止应用修改 Windows 防火墙规则。
不要为了绕过问题而关闭整个 Windows 防火墙。应当调整冲突的安全策略,或让安全软件允许 Codex 的沙盒设置程序运行。
方法三:临时使用低隔离模式
如果无法修改防火墙策略,可以在 Codex 配置文件中使用 unelevated 模式作为临时备用方案。
配置文件位置:
C:\Users\<用户名>\.codex\config.toml
加入或修改为:
[windows]
sandbox = "unelevated"
保存后重启 Codex。
这个模式对网络的隔离能力弱于 elevated 和 mxc,只能作为临时方案。电脑恢复正常后,建议优先使用 MXC。
常见误区
- 防火墙服务正在运行,不代表允许本地规则修改。 服务状态正常,但组策略仍可能禁止本地规则生效。
- 重复点击“重新设置”通常没有用。 如果策略没有改变,每次都会在同一个防火墙步骤失败。
- 旧的错误文件不一定代表当前仍然失败。 更新后 Codex 可能已经切换到 MXC,但旧的
setup_error.json仍会保留之前的错误记录。 - 不要把 Computer Use 的应用允许列表和 Windows 沙盒设置混为一谈。 两者是不同配置。
总结
本次问题的直接原因是:Codex 旧版沙盒需要修改本地防火墙规则,但 Windows 当前策略不允许这些规则生效。
完成 Windows 25H2 更新并重启后,Codex 检测到 MXC 可用,自动切换到 MXC 沙盒,问题即可解决。更新后仍失败,再检查第三方安全软件或组策略;不要直接关闭系统防火墙。


private note
交流
文章暂不开放公开评论。如果你有想法、问题或建议,欢迎私下联系站长。
联系站长