Codex更新ChatGPT桌面端后一直提示“Windows 安装未完成“,重装无效,最终解决全过程
Codex更新ChatGPT Windows 桌面端一直提示"Windows 安装未完成",重装无效,最终解决全过程
一、问题现象
最近 OpenAI 发布了新版 ChatGPT Windows Desktop(原 Codex 客户端)。
安装完成后,第一次打开软件却始终卡在下面这个页面:
无论点击:
- 重试Windows设置
- 继续受限访问
都没有任何反应。
即使:
- 右键管理员运行
- 点击 UAC 的"允许"
- 卸载重新安装
- Reset-AppxPackage
- 重启电脑
问题依旧存在。
二、一开始怀疑的问题
由于界面一直提示
Windows setup incomplete
所以最开始怀疑的是:
- Windows 权限
- UAC
- Microsoft Store
- Windows App Runtime
- AppX 安装失败
于是开始逐项排查。
三、排查过程
① 检查应用是否安装成功
Get-AppxPackageOpenAI*结果:
OpenAI.Codex Status : OK说明:
- 安装成功
- 包完整
- Store签名正常
排除安装失败。
② 检查 Windows App Runtime
Get-AppxPackageMicrosoft.WindowsAppRuntime*发现:
1.4 1.5 1.6 1.7 1.8 2.2 全部 Status = OK说明 Runtime 没问题。
③ 检查 AppX 服务
Get-ServiceAppXSvc,ClipSVC结果:
AppXSvc Running ClipSVC StoppedAppXSvc 正常。
ClipSVC 默认按需启动,并不是故障。
④ 查看应用是否真正启动
Get-Process|Where-Object{$_.ProcessName-match"ChatGPT|Codex|OpenAI"}结果:
codex.exe codex.exe说明:
程序已经启动。
不是 EXE 无法运行。
⑤ 查看 AppX 日志
继续查看:
Microsoft-Windows-AppModel-Runtime/Admin日志全部都是:
Create AppContainer Success LaunchProcess Success FinishPackageActivation Success没有任何:
- Access Denied
- Package Error
- Activation Failed
因此可以确认:
Windows 已经成功完成了应用启动。
问题不是 Windows。
四、真正的突破口——查看客户端日志
接下来开始查看:
C:\Users\用户名\AppData\Local\Packages\ OpenAI.Codex_xxxxx\最终发现真正的日志。
里面反复出现:
failed to reload config: C:\Users\用户名\.codex\config.toml duplicate key以及:
failed to read configuration layers duplicate key还有:
Invalid TOML document 锘縩otify终于找到了真正原因。
五、根本原因
真正的问题并不是:
- Windows
- 权限
- 安装失败
而是:
用户目录下旧的 Codex 配置文件损坏。
具体位置:
C:\Users\用户名\.codex\config.toml该文件存在两个问题:
① duplicate key
例如:
[mcp] ... [mcp]或者
notify = ... notify = ...导致:
duplicate key整个 TOML 无法解析。
② 编码异常
日志里还有:
锘縩otify正常应该是:
notify这说明:
config.toml 曾经:
- 用错误编码保存
- 或 BOM 损坏
客户端读取以后:
notify ↓ 锘縩otify导致:
Invalid TOML document六、为什么重装完全没用?
这是很多人最容易误解的一点。
我当时:
- 重装
- Reset-AppxPackage
- 删除应用
- 管理员运行
全部没用。
原因是:
新版 ChatGPT 的用户配置:
C:\Users\用户名\.codex并不属于:
Microsoft Store App因此:
卸载软件
↓
.config 不删
↓
重新安装
↓
仍然读取旧配置
↓
继续报错
所以:
重装永远无法修复。
七、最终解决方法
退出 ChatGPT:
Stop-Process-Name codex-Force备份:
Copy-Item`"$env:USERPROFILE\.codex\config.toml"`"$env:USERPROFILE\.codex\config.toml.bak"然后:
Rename-Item`"$env:USERPROFILE\.codex\config.toml"`"config.toml.disabled"重新打开 ChatGPT。
软件自动重新生成新的:
config.toml问题立即解决。
八、为什么这样可以解决?
ChatGPT 启动流程大概如下:
启动程序 │ ▼ 读取 config.toml │ ▼ 初始化 MCP │ ▼ 初始化 Plugins │ ▼ 初始化 Computer Use │ ▼ 完成 Windows Setup但是:
config.toml │ ▼ 解析失败 │ ▼ MCP 初始化失败 │ ▼ Plugin 初始化失败 │ ▼ Computer Use 初始化失败 │ ▼ Windows Setup 永远完成不了所以界面一直停留:
Windows setup incomplete实际上:
Windows 早就完成安装了。
只是客户端自己的初始化失败。
九、总结
这次问题最大的误导就是:
提示写着"Windows 安装未完成",实际上 Windows 根本没有问题。
真正的问题是:
用户目录下的
.codex/config.toml已损坏,导致新版 ChatGPT 无法完成内部初始化,因此错误地停留在"Complete Windows Setup"页面。
最终解决步骤只有一句话:
删除(或重命名)
C:\Users\<用户名>\.codex\config.toml,让 ChatGPT 自动重新生成配置文件。
后记
整个排查过程前后经历了:
- Windows 权限检查
- AppX 包检查
- Runtime 检查
- AppContainer 检查
- Event Viewer 日志分析
- ChatGPT 内部日志分析
最终定位到.codex/config.toml才是真正的故障源。
如果你的现象与本文一致——重装无效、管理员运行无效、一直提示 “Windows setup incomplete”——建议优先检查这个配置文件,而不是继续反复卸载重装。这样通常能节省大量排查时间。