ChatGPT Windows 客户端一直提示「Windows 安装未完成」？最终发现是 Codex 配置文件坏了
ChatGPT Windows 客户端提示「Windows 安装未完成」的排查与解决记录
问题背景
在 Windows 11 上安装 ChatGPT 桌面客户端后，启动时一直卡在：
完成 Windows 设置
ChatGPT 需要一次性权限才能在你的电脑上运行
Windows 安装未完成
点击：
重试 Windows 设置
没有任何反应。
最初以为是 Windows 权限、Microsoft Store 或安装损坏问题，排查了一圈后，最终发现：
真正原因是 Codex 配置文件格式不兼容，导致应用初始化失败。
环境
测试环境：
Windows 11
ChatGPT / Codex Windows 客户端
Microsoft Store 安装版本
排查过程
1. 检查 UAC 权限
由于提示涉及权限提升，首先检查 Windows 用户账户控制。
打开：
Win + R
UserAccountControlSettings
确认 UAC 开启。
同时测试：
右键 CMD
→ 以管理员身份运行
可以正常弹出：
是否允许此应用对你的设备进行更改？
说明：
- UAC 正常
- 管理员权限正常
排除权限问题。
2. 检查 Windows 服务
检查以下服务：
services.msc
重点：
- Application Information
- AppX Deployment Service
- Client License Service
- State Repository Service
结果：
全部正常。
排除 Windows 服务异常。
3. 检查 Microsoft Store 安装状态
尝试：
- 重置 ChatGPT
- 卸载重新安装
- 清理 Microsoft Store 缓存
例如：
wsreset.exe
均无效。
发现异常：Store 显示安装成功，但系统注册异常
检查 AppX：
Get-AppxPackage -AllUsers | findstr /i "OpenAI"
发现：
OpenAI.Codex
而不是传统预期的：
OpenAI.ChatGPT
这里有一个容易踩坑的地方：
新版 ChatGPT Windows 应用实际上使用 OpenAI.Codex 包名。
所以搜索 ChatGPT 可能找不到。
4. 确认 AppX 注册状态
检查：
Get-AppxPackage -AllUsers -Name OpenAI.Codex
确认：
- WindowsApps 文件存在
- AppX 注册正常
- 用户权限正常
因此可以排除：
- Microsoft Store 损坏
- AppX 部署失败
- Windows 权限问题
关键突破：查看应用日志
日志位置：
%LOCALAPPDATA%\Packages\
OpenAI.Codex_*
\LocalCache\Local\Codex\Logs
查看启动日志后发现关键错误：
failed to reload config:
.config/config.toml
invalid type: sequence, expected struct HooksToml
重点：
config.toml
hooks
根本原因
问题不是 Windows 安装失败。
真正原因：
Codex 用户配置文件格式与当前版本不兼容。
旧版本配置可能类似：
hooks = [
...
]
但是新版程序要求：
[hooks]
...
由于配置解析失败：
- 应用启动
- 加载用户配置
- TOML 解析失败
- 初始化流程中断
- 最终显示：
Windows 安装未完成
错误提示具有误导性。
解决方法
不要直接删除配置，先备份。
执行：
Rename-Item "$env:USERPROFILE\.codex\config.toml" "config.toml.bak"
然后：
- 完全退出 ChatGPT/Codex
- 重新启动
应用会自动生成新的默认配置。
问题恢复。
为什么卸载重装没有效果？
这是最大的坑。
Microsoft Store 卸载主要删除：
应用程序文件
例如：
C:\Program Files\WindowsApps
但是不会删除：
用户配置目录
例如：
%USERPROFILE%\.codex\
所以流程变成：
卸载应用
↓
重新安装
↓
读取旧配置
↓
配置解析失败
↓
继续启动失败
因此：
卸载重装并不能解决所有桌面应用问题。
如何快速判断是否是配置问题？
遇到：
- ChatGPT/Codex 无法启动
- Windows 安装未完成
- 更新后突然打不开
- 插件加载失败
优先检查：
notepad $env:USERPROFILE\.codex\config.toml
或者临时备份：
Rename-Item "$env:USERPROFILE\.codex\config.toml" "config.toml.bak"
测试是否恢复。
总结
这次问题的排查路线：
UAC
↓
Windows 服务
↓
Microsoft Store
↓
AppX 注册
↓
Windows App Runtime
↓
应用日志
↓
发现 config.toml 格式错误
最终定位：
用户配置文件不兼容
↓
Codex 初始化失败
↓
ChatGPT 显示 Windows 安装未完成
最大的经验：
遇到桌面应用启动失败，不要只盯着安装过程。很多时候真正的问题来自升级后遗留的用户配置。
关键词
ChatGPT Windows 安装未完成
OpenAI.Codex
config.toml
HooksToml
Microsoft Store ChatGPT
Windows AppX
浙公网安备 33010602011771号