根因#

CC Switch 检测 Codex 是否可用的方式，是执行 npm 全局目录下的 codex.cmd。而重装过程中，npm 全局目录里 @openai/codex 的包体被删空了，只留下了启动壳：

1
%APPDATA%\npm\node_modules\@openai\     ← 目录还在，里面 0 个文件
2
%APPDATA%\npm\codex.cmd                 ← 启动壳还在，指向不存在的包

执行 codex.cmd 时报：

1
Error: Cannot find module '...\node_modules\@openai\codex\bin\codex.js'
2
  code: 'MODULE_NOT_FOUND',
3
  requireStack: []
4
Node.js v24.19.0

requireStack: [] 就是截图里那行报错的来源——不是 Node 环境坏了，是包没了。

修复#

1
npm install -g @openai/codex

⚠️ 关键坑：Codex 的 npm 包采用「主包 + 平台二进制」分离结构，主包 @openai/codex 很小，真正的可执行文件在 optionalDependencies 里（如 @openai/codex-win32-x64）。国内直连官方 registry 经常在下载平台包时超时，结果是主包装上了但运行仍报错：

1
Error: Missing optional dependency @openai/codex-win32-x64.
2
Reinstall Codex: npm install -g @openai/codex@latest

解决办法是换国内镜像单独补装平台包：

1
npm install -g "@openai/codex-win32-x64@npm:@openai/codex@0.160.0-win32-x64" --registry=https://registry.npmmirror.com

验证：

1
codex --version    # codex-cli 0.160.0
2
codex doctor       # 应全部通过

根因#

CC Switch 的工作原理是把供应商配置写进 ~/.codex/config.toml。正常应写入：

1
model_provider = "custom"
2

3
[model_providers.custom]
4
name = "xiaomi_mimo"
5
base_url = "https://api.xiaomimimo.com/v1"
6
wire_api = "responses"
7
requires_openai_auth = true

但实际打开 config.toml 发现：model_provider 和整个 [model_providers.custom] 表丢失了，取而代之的是一堆无效的顶层键（base_url、wire_api、experimental_bearer_token 写在了顶层——TOML 里这些键 Codex 根本不认，启动时会警告 unrecognized configuration settings）。

没有 model_provider 指示，Codex 就用默认的 OpenAI 官方 provider，于是打到 api.openai.com 返回 401；桌面版则因为没有有效凭证直接弹登录页。

为什么会被写坏？ 时间线是：

1. 今早 Codex 桌面版启动时重写了 config.toml（9<35>）；
2. CC Switch 把这份已经不含 provider 段的 config 回读成了自己的供应商模板（双向同步的副作用）；
3. 之后每次切换供应商，CC Switch 用坏模板写回 config.toml——越修越坏，切换一次覆盖一次。

证据：CC Switch 数据库（~/.cc-switch/cc-switch.db 的 providers 表）里存的模板已经是坏的，而当天早些时候的数据库备份（9<29>）里配置还是完整的。

修复（三处一起改）#

改任何一处之前，先备份 CC Switch 数据库：

1
Copy-Item ~\.cc-switch\cc-switch.db ~\.cc-switch\backups\db_backup_manual.db

1. 修模板（根因）：用 SQLite 打开 ~/.cc-switch/cc-switch.db，找到 providers 表中当前 Codex 供应商的 settings_config JSON 字段，删掉无效顶层键，补回 model_provider = "custom" 和 [model_providers.custom] 表。
2. 修 ~/.codex/config.toml：同样处理。
3. 重建 ~/.codex/auth.json（如果也丢了）：

1
{ "OPENAI_API_KEY": "你的中转 Key" }

教训：只修 config.toml 不修数据库模板是没用的，下次切换就会被覆盖回去。必须修源头。

背景#

Codex 的会话记录是 JSONL 文件，按日期存放在：

1
~/.codex/sessions/YYYY/MM/DD/rollout-<时间>-<uuid>.jsonl

把旧的 2026/ 文件夹整个复制回 ~/.codex/sessions/ 后，文件明明在，桌面版侧边栏却一条都不显示。

根因#

桌面版的会话列表不是实时扫描文件夹的，而是读本地索引库 ~/.codex/state_5.sqlite 的 threads 表。首次启动时有一个 backfill 扫描流程负责把 rollout 文件导入这张表，扫完后在 backfill_state 表里记：

1
(1, 'complete', NULL, <时间戳>, <时间戳>)

新装的 Codex 在 9<09> 第一次启动时扫过一次——当时 sessions 目录还是空的（聊天记录是之后才复制进去的），扫描结果标记为 complete，之后永远不会再扫。

修复#

1. 完全退出 ChatGPT 桌面版（托盘也要退出，避免写库冲突）；
2. 备份后清空 backfill_state 表，强制下次启动重扫：

1
import sqlite3, shutil
2
shutil.copy2(r"C:\Users\<你>\.codex\state_5.sqlite",
3
             r"C:\Users\<你>\.codex\state_5.sqlite.bak")
4
con = sqlite3.connect(r"C:\Users\<你>\.codex\state_5.sqlite")
5
con.execute("DELETE FROM backfill_state")
6
con.commit()

3. 重新打开桌面版，启动时自动重扫，历史记录全部回来了。