修复「ChatGPT 无法加载 config.toml，因此此对话串无法继续 · Model provider xxx not found」

codex-provider-doctor-v1.0.0.zip

https://www.workbuddy.cn/space/d/T3PV7VwHRGicGSknxuHQjL?ext2=copy_link

一句话：你用 cc-switch（或类似工具）切过 AI 供应商之后，有些旧对话串打不开了 —— 这个包能把它们救回来。

它只做一件事：把 config.toml 里被切换工具删掉的那几段 provider 配置，原样补回来。

它不会：删你的配置、改你的聊天记录、联网、上传任何数据。

1先判断：你需要它吗

对着下表看一眼，第 3、4 条都打勾，基本可以确定就是这个问题。

注意如果你所有对话串都打不开，那可能不是这个问题，先检查 config.toml 有没有语法错误。

包里有什么

codex-provider-doctor/
├── SKILL.md                      ← 给 AI 看的说明书（当 Skill 用时需要）
├── scripts/
│   └── codex_provider_doctor.py  ← 真正干活的脚本
└── 使用说明.md                    ← 就是你正在看的这份

只有 codex_provider_doctor.py 这一个文件是必须的，其余是说明书。

准备工作：装 Python（约 3 分钟）

脚本需要 Python 3.11 或更高版本，不需要安装任何额外的包（不用 pip install）。

3.1 先检查你有没有

1. 按 Win + R，输入 cmd 回车，弹出黑色的命令窗口。
2. 粘贴这行并回车：

python --version

3.2 装 Python

1. 打开 python.org/downloads
2. 点黄色大按钮 Download Python 3.x.x，双击下载好的安装包
3. 安装界面最下面有个勾选框 Add python.exe to PATH —— 一定要勾上！
4. 点 Install Now，等进度条走完
5. 关掉黑窗口，重新 Win+R → cmd → 再输一次 python --version，这次应该能看到版本号

4怎么解压、解压到哪里

分两种情况。不知道选哪个就选「用法 B」，更简单。

用法 A：当 Skill 用（推荐给 WorkBuddy / Codex 用户）

好处：下次再遇到同样报错，只要跟 AI 说一句「我的 Codex 又报 Model provider not found 了」，它就会自动帮你修。

「你的用户名」换成你自己的，不确定就看 C:\Users\ 下面哪个是你的名字。

解压步骤（Win10/11 自带功能，不用装软件）：

1. 找到 codex-provider-doctor-v1.0.0.zip，右键 → 「全部解压缩…」（Win11 叫「提取全部…」）
2. 把窗口里「目标文件夹」那一栏整段删掉，粘贴：C:\Users\你的用户名\.workbuddy\skills
3. 点「提取」。若提示文件夹不存在，点「是」让它创建

验证放对了没有：打开资源管理器，地址栏粘贴 C:\Users\你的用户名\.workbuddy\skills 回车，应看到一个 codex-provider-doctor 文件夹。双击进去，应该直接就能看到 SKILL.md 和 scripts 文件夹。

用法 B：当小工具用（只想修一次，推荐新手）

好处：不用管目录规范，解压到哪都行。推荐 D:\tools\，或者干脆放桌面。

1. 右键压缩包 → 「全部解压缩…」
2. 「目标文件夹」改成 D:\tools（没有就先去 D 盘手动建一个叫 tools 的文件夹）
3. 点「提取」
4. 完成后进 D:\tools\codex-provider-doctor 看一眼，里面应该有 scripts 文件夹

5照着做：修复教程

命令按 Windows 写。macOS / Linux 把 python 换成 python3、路径斜杠换成 /。

python scripts\codex_provider_doctor.py

CODEX_HOME  : C:\Users\你的用户名\.codex
config.toml : C:\Users\你的用户名\.codex\config.toml
              (最后修改 2026-10-12 11:09:07)

当前 model_provider = custom
config.toml 已定义 provider：['custom']

对话串引用的 provider（来源：state_5.sqlite）：
   - openai                          1 条   [内置]
   - custom                          1 条   [已定义]
   - cc-switch-official              1 条   [缺失!]

结论：以下 1 个 provider 被对话串引用，但 config.toml 未定义：
   - cc-switch-official

python scripts\codex_provider_doctor.py --apply

克隆模板：[model_providers.custom] -> ['cc-switch-official']
已备份：C:\Users\你的用户名\.codex\config.toml.bak-20261012-110912

已补写 1 个 provider：['cc-switch-official']

python scripts\codex_provider_doctor.py

6如果你选的是「当 Skill 用」

文件放好后不用跑任何命令，直接跟 AI 说人话就行：

• 「我的 Codex 报 Model provider cc-switch-official not found，帮我修一下」
• 「我用了 cc-switch 切换供应商，现在有些旧对话串打不开了」
• 「ChatGPT 提示无法加载 config.toml，对话串无法继续」

7不想跑脚本？手动改 3 分钟

1. 用记事本打开 C:\Users\你的用户名\.codex\config.toml，先复制一份当备份
2. 滚到文件最末尾，另起一行粘贴：

[model_providers.cc-switch-official]
name = "OpenAI"
base_url = "http://127.0.0.1:15721/v1"
wire_api = "responses"
requires_openai_auth = true
experimental_bearer_token = "PROXY_MANAGED"

3. 把 cc-switch-official 换成你报错信息里的那个名字（要一模一样，连字符也对上）
4. 保存，关掉 Codex 重新打开

8常见问题

9它到底改了什么（给好奇的人）

Codex 每开一个新对话串，都会把当时正在用的供应商名字永久刻进两处：数据库 state_5.sqlite 和会话记录文件里，之后再也不跟着配置变。

而 cc-switch 这类工具换供应商时，是整份重写 config.toml，只保留当前这一家的配置，其他家的全删。

于是：老对话串还记着「我当时用的是 A 家」，可 config.toml 里 A 家的配置已经被删了 → Codex 一打开老对话串就懵了，直接报错不让进。

10怎么卸载

直接删掉 codex-provider-doctor 文件夹就行，不留任何残留。脚本产生的东西只有 ~/.codex/config.toml.bak-* 这些备份文件，确认没问题后可以自己删掉。