ChatGPT Windows Setup 一键修复

解决的具体问题

ChatGPT / Codex 桌面客户端在 Windows 上启动时经常遇到两个致命错误，导致应用完全无法使用：

• “Windows setup didn't finish”：沙箱初始化挂起，卡在安装界面无法进入主程序。
• “Error creating chat” / 配置文件解析失败：config.toml 读取时崩溃，引发一系列级联错误。

由于应用的真实配置存放在用户目录（~/.codex/config.toml）而非 MSIX 应用包内部，卸载重装或重置应用完全无法清除故障状态。此外，应用的后台自动更新会静默将沙箱设置重置为 elevated，导致“Windows setup”错误在每次更新后复发。

技能如何工作

本技能通过定位并修复外部配置文件（~/.codex/config.toml）来解决上述问题，核心步骤包括：

• 配置定位与诊断：定位真实配置文件与日志目录，读取崩溃日志以确认真实错误原因。
• 沙箱降级修复：将导致 setup 挂起的 sandbox = "elevated" 修改为免管理员安装的 unelevated。
• 缺失文件重建：修复因引用不存在的模型目录 JSON 路径而导致的 Error creating chat，生成符合严格 schema 的模板文件并使用绝对路径。
• 一键幂等修复：提供内置 PowerShell 脚本，自动备份配置、修改关键项、终止卡死进程，可安全重复执行。

适用边界与注意点

• 代理工具场景：如果用户使用了本地代理管理器（如 CC Switch）注入 API 配置，请直接确保代理进程存活并重启应用，切勿手动覆盖 base_url，以免被工具覆盖回直连地址。
• 无关因素：WSL、Windows Sandbox（家庭版不可用）以及各种磁盘清理工具（如 Dism++）均不是导致此问题的原因，无需进行此类排查。
• 数据安全：执行最终兜底方案（重命名配置文件让其重新生成）后，请务必手动恢复用户的自定义模型供应商配置，避免丢失 API Key。