ChatGPT Windows 客户端一直提示「Windows 安装未完成」？最终发现是 Codex 配置文件坏了

下面是整理后的 Markdown 版本，去掉了个人用户名、机器信息等隐私内容，适合直接发布到博客。

# ChatGPT Windows 客户端提示「Windows 安装未完成」的排查与解决记录## 问题背景在 Windows 11 上安装 ChatGPT 桌面客户端后，启动时一直卡在：> 完成 Windows 设置  
> ChatGPT 需要一次性权限才能在你的电脑上运行  
> Windows 安装未完成点击：> 重试 Windows 设置没有任何反应。最初以为是 Windows 权限、Microsoft Store 或安装损坏问题，排查了一圈后，最终发现：> **真正原因是 Codex 配置文件格式不兼容，导致应用初始化失败。**---## 环境测试环境：```text
Windows 11
ChatGPT / Codex Windows 客户端
Microsoft Store 安装版本

---

排查过程

1. 检查 UAC 权限

由于提示涉及权限提升，首先检查 Windows 用户账户控制。

打开：

Win + RUserAccountControlSettings

确认 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.tomlinvalid type: sequence, expected struct HooksToml

重点：

config.toml
hooks

---

根本原因

问题不是 Windows 安装失败。

真正原因：

Codex 用户配置文件格式与当前版本不兼容。

旧版本配置可能类似：

hooks = [...
]

但是新版程序要求：

[hooks]
...

由于配置解析失败：

1. 应用启动
2. 加载用户配置
3. TOML 解析失败
4. 初始化流程中断
5. 最终显示：

Windows 安装未完成

错误提示具有误导性。

---

解决方法

不要直接删除配置，先备份。

执行：

Rename-Item "$env:USERPROFILE\.codex\config.toml" "config.toml.bak"

然后：

1. 完全退出 ChatGPT/Codex
2. 重新启动

应用会自动生成新的默认配置。

问题恢复。

---

为什么卸载重装没有效果？

这是最大的坑。

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