Codex桌面端自定义模型列表为空怎么办？模型不显示修复方法（Windows）

关键词：Codex桌面端、自定义模型为空、Codex模型列表不显示、Codex中文界面、Codex配置文件、Electron缓存修复

---

最近在使用 Codex 桌面端时遇到一个比较奇怪的问题：

首次启动 Codex 时，一切正常：

• 英文界面
• 自定义模型列表正常显示
• 可以选择配置好的模型

但是退出 Codex 再重新打开后，界面自动变成中文，并且：

• 自定义模型列表为空
• 模型下拉菜单没有任何内容
• CLI 命令行中的 /model 可以正常使用
• API 请求正常
• 删除重新安装 Codex 依然无法解决

最终定位发现，并不是模型配置问题，而是 Codex 桌面端 Electron 持久化状态损坏导致 UI 状态异常。

下面记录完整排查过程和解决方案。

---

一、问题表现

故障环境：

• Codex Desktop
• Windows
• 自定义模型配置
• Electron 桌面端

异常表现：

1. 首次运行正常

第一次打开 Codex：

• 英文 UI
• 自定义模型正常出现

例如：

deepseek-v4-flash
deepseek-v4-pro

均可以正常选择。

2. 重启后模型列表消失

关闭 Codex 后重新打开：

发现：

• UI 自动切换中文
• 模型选择区域为空

但是命令行：

/model

依旧可以看到模型。

说明：

模型配置文件没有问题，问题出现在桌面端 UI 层。

---

二、排查过程

1. 检查 config.toml

首先检查：

C:\Users\admin.codex\config.toml

发现：

model_catalog_json = "cc-switch-model-catalog.json"

使用的是相对路径。

虽然 CLI 可以正常读取，但是 Electron 桌面端和 CLI 的运行目录不同。

Electron 的当前工作目录（CWD）可能导致：

cc-switch-model-catalog.json

无法正确解析。

修改为绝对路径：

model_catalog_json = "C:\\Users\\admin\\.codex\\cc-switch-model-catalog.json"

修改完成后保存。

---

三、删除 Codex 桌面端状态缓存

仅修改配置并不能解决问题。

原因是：

Codex Desktop 基于 Electron 开发，会保存大量 Chromium 和 Electron 状态。

这些数据不会随着软件卸载删除。

所以：

卸载 Codex → 重新安装 → 原来的异常状态仍然存在。

---

1. 删除 .codex-global-state.json

路径：

C:\Users\admin\.codex\.codex-global-state.json

同时删除：

.codex-global-state.json.bak

这个文件保存：

electron-persisted-atom-state

包括：

• UI 状态
• 语言设置
• 模型列表派生状态
• Electron 持久化数据

语言切换异常后，这里的状态可能已经损坏。

删除后：

Codex 会重新生成状态。

---

2. 删除 Electron Chromium 数据

重点目录：

C:\Users\admin\AppData\Roaming\Codex\web

直接删除整个：

web

目录。

里面包含：

目录	作用
Local Storage/leveldb	网页本地存储
Session Storage	会话缓存
Cache	缓存文件
Code Cache	JS/WASM 编译缓存
GPUCache	GPU缓存
Preferences	Chromium配置

这些数据类似浏览器用户配置。

如果损坏：

即使重新安装 Codex，也会继续读取。

---

四、没有删除的文件

以下文件无需删除：

模型目录

cc-switch-model-catalog.json

该文件内容正常：

例如：

[
  {
    "name": "deepseek-v4-flash"
  },
  {
    "name": "deepseek-v4-pro"
  }
]

---

登录信息

auth.json

无需删除。

否则需要重新登录。

---

SQLite 数据库

例如：

state_5.sqlite

保存：

• 对话记录
• Thread 状态
• 历史任务

与模型选择器无关。

---

五、修复后的验证

执行：

codex doctor

检查结果：

config.toml parse        ok
model                    deepseek-v4-flash · custom
default model provider   custom
rollout DB model providers custom=1

说明：

• 配置解析正常
• 自定义 Provider 正常
• 默认模型正常

同时测试：

http://127.0.0.1:15721/v1/models

返回模型列表。

API 服务正常。

---

六、最终解决步骤总结

如果遇到：

• Codex 桌面端模型列表为空
• 自定义模型消失
• CLI 正常但 UI 不显示
• 重装无效

可以按照下面顺序处理：

第一步：修改 config.toml

文件：

C:\Users\用户名\.codex\config.toml

修改：

model_catalog_json = "C:\\Users\\用户名\\.codex\\cc-switch-model-catalog.json"

---

第二步：关闭 Codex

确保任务管理器中：

Codex.exe

全部退出。

---

第三步：删除状态缓存

删除：

C:\Users\用户名\.codex\.codex-global-state.json

删除：

C:\Users\用户名\AppData\Roaming\Codex\web

---

第四步：重新启动 Codex

首次启动会重新生成：

• Electron 状态
• Chromium缓存
• UI配置

模型列表应该恢复。

---

七、问题根因总结

最终原因：

不是：

❌ 模型 API 错误
❌ Provider 配置错误
❌ 模型文件损坏
❌ 安装包问题

而是：

✅ Electron 持久化状态损坏
✅ Chromium 用户数据缓存异常
✅ 相对路径导致桌面端读取不稳定

Codex Desktop 和 CLI 虽然共享部分配置，但是运行环境不同。

CLI 可以正常读取，不代表 Electron UI 一定可以正确加载。

---

如果你也遇到 Codex 桌面端类似问题，可以优先检查：

AppData\Roaming\Codex\web

这个目录往往才是导致「重装无效」的关键。