主题
why01 × Codex 一键体检修复助手
一个可视化窗口小工具：逐项体检你这台机器上的 Codex，指出到底哪一项坏了，并当场修好。
它和 Claude Code 安装助手 的定位不一样——那个偏「装」，这个偏「查和修」。 配了半天连不上、或者用着用着突然报 401 Invalid token、历史对话不见了，都下这个跑一遍。
用 VSCode 插件 / 桌面客户端的老师同样适用
不用命令行也能用。Codex 的命令行、VSCode 插件、桌面客户端读的是同一份配置 （~/.codex/config.toml），所以工具查出来、修好的东西对三种用法都生效。 它也不会因为你没装命令行就说你"没安装"——插件和客户端都认得。
下载
| 平台 | 下载 | 怎么运行 |
|---|---|---|
| 🪟 Windows | why01-codex-win.zip | 解压出两个文件放同一个文件夹，双击 【一键检测修复.bat】（不要双击 .ps1） |
| 🍎 macOS | 推荐：不用下载，打开「终端」粘贴下面那行回车 | 见下方命令 |
| 🍎 macOS（文件版备用） | why01-codex-mac.zip | 解压后打开「终端」，输入 bash 加一个空格，把文件拖进终端窗口，回车 |
Mac 首选这一行（无需下载、不会被系统拦）：
bash
/bin/bash -c "$(curl -fsSL https://s1.why01.top/docs/downloads/why01-codex-mac.sh)"它会检查哪几项
| # | 检查项 | 坏了会怎样 |
|---|---|---|
| ① | Node.js 运行环境 | 没有它命令行版 Codex 装不上（只用桌面版的不受影响） |
| ② | Codex 本体 | 命令行 / VSCode 插件 / 桌面客户端任一装了就算；命令行装坏了跑不起来也查得出 |
| ③ | ChatGPT 登录态（auth.json） | 按你当前的配置写法判断它是正经凭证还是拦路虎，不一刀切 |
| ④ | 配置指向谁 + 写法对不对 | 除了看指向 why01 / 别家 / 官方，还会查几种「语法合法但会让客户端不可用」的写法（见下） |
| ⑤ | API Key 在不在位 | 按 Codex 的真实取值顺序去找，找不到会说清是哪一环断的 |
| ⑥ | 真实连通 | 按你 config.toml 里解析出来的地址和 Key 真打一次 /v1/responses |
它认得几种配法，不会把好机器改坏
同一个 Codex 有好几种配法，工具都认，不会因为"跟教程写的不一样"就判你有问题：
| 你的情况 | 工具怎么处理 |
|---|---|
用 cc-switch 配的（provider 常叫 custom） | ✅ 认，不改 provider 名字，只补该补的 |
| 指向别家第三方 | ✅ 如实告诉你指向谁，不算故障——你有权用别家。想换才帮你换 |
| OpenAI 官方直连 | ✅ 认，且绝不动你的官方登录态 |
| 我们早期版本配过的 | ✅ 自动迁移到新写法，不用你重新复制令牌 |
v2.0 修了什么（2026-08-22）
用过 v1.3 及更早版本的老师，请重跑一遍新版
我们前一版工具写进配置的一个选项，在 Codex 桌面版上会导致： 客户端报 Key 不对、请求没走到我们这边、或者左侧的历史对话整个看不见。
重新跑一遍新版一键工具即可，不需要重新复制令牌。
历史对话一条都没丢 —— 那是客户端按"服务商"分类显示导致的，修好后会回来。
v2.0 同时修掉了三处工具自身的毛病：
- 备份不再被自己覆盖。原先每次都用同一个备份文件名，修第二项就把第一项留下的原始备份冲掉了——真出事时还原到的是"已经被改过的版本"。现在带时间戳，每次运行只备一次。
- 第⑥项现在测的是客户端真正会走的路。原先它拿工具内置的地址和自己找到的 Key 去打网关，证明的只是"网关活着、Key 有效"，配置写错了照样全绿。现在地址和 Key 一律从你的配置里现算，并且会先让 Codex 自己校验一遍这份配置能不能加载。
- 删掉了一个会把配置改瘫的"自动修复"。原先探测失败时会自动把
wire_api改成chat，而这个值在当前版本的 Codex 上是硬错误，会让整份配置文件加载失败。
2026-08-25 又修了两处（慢 ≠ 不通）
有老师截图：①~⑤ 全绿、只有第⑥项标红「⛔ 网络不通」，横幅写「主因：」后面却是空白， 一键全修复反复点也修不好。查服务端日志发现——那几次请求全都到了我们这边、也全都成功返回了， 只是跑了两三百秒，超过了工具原本 30 秒的耐心。用户的网络根本没坏。
- 超时不再报成「网络不通」。域名解析 / 443 / HTTPS 三层都验通、只是没在 30 秒内返回时， 第⑥项显示 ⏳ 30 秒内没返回（不等于不通），不计入问题数，也不再把你推向一键全修复—— 那个按钮对"慢"完全无能为力。遇到这个提示，直接开 Codex 用就行，Codex 自己的等待时间比本工具长得多。
- 主因不再空白。横幅的「主因：」现在会兜底显示第⑥项自己的诊断，实在没有就指向下方日志。
想拿到这两处修复，请重新下载上面的工具（2026-08-25 及以后的包）。 老包不会自动更新，症状就是上面这个"全绿只有⑥红、主因空白"。
2026-08-27 又修了四处（「工具自己变成了拦路虎」）
一位老师的 Codex 用不了，工具报「主因：有个 Codex 不认识的配置项 mcp_servers.codegraph.type」， 第⑥项红色「不通」，点【一键全修复】点多少次都一样。实测下来，这台机器的 Codex 其实好好的 —— 是工具判错了。
我们装了一份和这位老师同版本的 Codex（0.150.0），把那份配置原样跑了一遍：普通启动一切正常， Codex 自己发请求 0.6 秒就发出去了，和干净配置没有区别。那一项只有在「严格模式」下才会被挑出来， 平时 Codex 直接忽略它。于是改了四处：
| 改了什么 | 为什么 |
|---|---|
| 「Codex 不认识的配置项」不再判成故障，降级成提示并继续往下测真实连通 | 它本来就不影响使用。判成故障反而把真正的问题挡在后面测不到了 |
| 新增**「MCP server 残留」检查** | 段还在、命令已经被删掉（多半是某个 skill / 插件卸载没卸干净）。会点名是哪一个、告诉你删哪一段，并说明 Codex 照样能用 |
| 「没测」和「不通」分成两种显示 | 上一步被拦住时其实一个请求都没发出去，旧版却显示红色「不通」，等于凭空报了一个网络故障 |
| 第⑤项 Key 改成真验 | 以前只看「长得像不像」就打绿勾；现在拿这把 Key 真打一次，网关不认就红，验过才写「已验证有效」 |
另外修好了一个老问题：如果你的 provider 段名字正好叫
openai，整份配置都会被 Codex 拒绝 （这是它的内建保留名）。旧版会报出这个故障、但一键全修复修不掉它。现在会自动改名（内容一个字不动）。
怎么知道自己下的是不是新包：新版第⑤项在没测之前写的是「已填好，尚未验证」， 旧版一律直接打绿勾「已就位」。看到后者就是老包，重新下载一份。
拿令牌
在 s1.why01.top 登录 → 左侧 【令牌】 → 【复制】。
- 令牌是
sk-开头的一长串 - 分组要选对：Codex 用
Codex-A分组（详见 分组说明）
遇到问题
| 现象 | 怎么办 |
|---|---|
| 弹「已保护你的电脑」 | 点【更多信息】→【仍要运行】 |
| Mac 双击打不开 / 提示"身份不明的开发者" | 别双击，用上面那行 curl 命令，或 bash + 拖文件 |
| 第⑥项显示 ⏳ 30 秒内没返回 | 不是故障，是这次请求跑得久。直接开 Codex 用即可。若你的包里第⑥项只会报「⛔ 网络不通」且主因空白，说明是 08-25 之前的旧包，重新下载一份 |
| 报「有个 Codex 不认识的配置项」并判成故障 | 老包（08-27 之前）。那一项其实无害，重新下载一份即可 |
| 提示「MCP server 残留 / 命令找不到」 | 不是故障，Codex 照样能用。多半是某个 skill / 插件卸载没卸干净，想清干净就按提示删掉 config.toml 里那一段 |
| 六项都过了但客户端还是不行 | 把客户端彻底退出再打开——关窗口不等于退出进程（托盘常驻/后台更新器会让它复用旧配置）。VS Code 要「完全退出」，不是「重新加载窗口」 |
| 工具说没找到 Key | 在输入框粘贴令牌后再点一次【一键全修复】 |
| 其它 | 截图发客服，见 联系客服 |
更多排查见 疑难杂症 与 错误码速查； Codex 本身的接入说明见 Codex CLI 与 Codex · 保姆版。