近期不少开发者反馈，Codex在完成ChatGPT集成升级后，Windows环境下反复出现“安装未完成”的报错。这个提示看似突兀，实际上并非Codex本身存在缺陷，而是配置文件未能跟上新版运行环境的要求。经过多轮实测，我们找到了一个稳定可复现的解决方案，下面将完整拆解。
一、报错根源：升级带来的配置断层
Codex升级后，底层执行逻辑发生了显著变化。新版对Windows Subsystem for Linux（WSL）的依赖明显加深，同时对模型供应商的认证方式、网络访问策略也提出了更严格的声明要求。旧版配置文件往往缺少这些新增参数，导致安装流程在初始化阶段便被迫中断。
值得注意的是，这类报错并非偶发，而是升级后配置不兼容的典型表现。只要按照新版规范补齐配置项，问题即可迎刃而解。下面这套配置方案已在多台Windows机器上验证通过。
二、修复实操：完整配置方案
打开Codex的配置文件config.toml，将以下内容完整写入并保存：
model_provider = "Sub2api"
model = "gpt-5.5"
review_model = "gpt-5.5"
model_reasoning_effort = "xhigh"
disable_response_storage = true
network_access = "enabled"
windows_wsl_setup_acknowledged = true
notify = [
"C:\\Users\\alex.fu\\AppData\\Local\\OpenAI\\Codex\\runtimes\\cua_node\\23828fd353da361d\\bin\\node_modules\\@oai\\sky\\bin\\windows\\codex-computer-use.exe",
"turn-ended"
]
[model_providers.Sub2api]
name = "Sub2api"
base_url = "http://localhost:8081"
wire_api = "responses"
requires_openai_auth = true保存后重启Codex，安装流程即可正常推进。这里需要特别提醒：notify中的exe路径与当前机器上的Codex安装版本强相关，请务必替换为你本机实际路径，否则通知功能可能失效。
三、核心配置项逐一解读
这套配置之所以有效，关键在于几个参数的协同作用。逐一拆解如下：
model_provider 与 model：指定模型供应商为Sub2api，模型版本为gpt-5.5。这里的Sub2api是一个本地代理服务，负责转发请求。如果你使用官方直连，需将provider替换为官方配置。
model_reasoning_effort = "xhigh"：将模型推理强度调至最高档。对于复杂任务，这一设置能显著提升输出质量，但也会相应增加响应耗时。
disable_response_storage = true：关闭响应存储，减少本地数据冗余。对隐私敏感或磁盘空间有限的场景尤其适用。
network_access = "enabled"：显式开启网络访问权限。新版Codex在调用外部工具或API时，该参数是必需项，缺失会导致部分功能静默失败。
windows_wsl_setup_acknowledged = true：向系统确认WSL环境已准备就绪，从而跳过安装时的环境检查。这是解决Windows安装未完成报错的关键开关。
[model_providers.Sub2api]：定义本地代理的接入参数。其中wire_api = "responses"指定了通信协议格式，requires_openai_auth = true则要求本地代理完成OpenAI认证。这些参数必须与代理服务的实际配置保持一致。
四、升级后的排查建议
如果按上述方案修改后仍无法完成安装，建议从以下几个方向逐一排查：
首先，确认base_url指向的本地服务（默认端口8081）是否正常运行。很多时候报错并非Codex配置问题，而是代理服务没有启动或端口被占用。其次，核对wire_api类型是否与代理服务支持的协议一致，不匹配会导致请求被拒。最后，检查requires_openai_auth的认证设置是否与本地代理的鉴权机制吻合。
另外，建议养成升级前备份配置文件的好习惯。Codex版本迭代较快，每次升级后都可能有新增参数或废弃项，备份能让你在出现问题时快速回滚，减少排查成本。