就是桌面端无法看到模型 Codex 桌面端
Quick fix
登录官方 ChatGPT、开启「切换第三方时保留官方登录」并启用本地路由后，重启 Codex 桌面端查看模型。
Symptom
Section titled “Symptom”就是桌面端无法看到模型Codex 桌面端会根据是否存在官方 ChatGPT 登录态决定是否显示第三方自定义模型。没有官方登录态时，模型选择器可能回落到官方默认模型；即使 `codex debug models` 能看到第三方模型，桌面端的「自定义」分类仍可能为空。
该簇还包含不同变体：部分报告称 catalog 字段命名与 Codex ≥0.144 的解析契约不匹配，或接管重写 `config.toml` 时丢失 `model`、`model_catalog_json`；另有聚合模式无法读取官方或本机 Codex 模型列表。v3.16.0 的不完整接管配置被维护者称已在 v3.16.1 + 3.16.2 解决，但 v3.16.2、v3.16.3 和 v3.20.2 仍有不同表现的报告。
在 Codex 桌面端登录一次官方 ChatGPT 账号，确保存在官方登录凭据。
在 cc-switch 设置中开启「切换第三方时保留官方登录」。
确认第三方供应商已开启本地路由或路由接管，然后完全退出并重新启动 Codex 桌面端。
若提示无法读取聚合模型列表，检查 `codex --version` 与 `codex debug models --bundled` 是否能正常输出，并确认 CC Switch 能访问 `chatgpt.com`。
若重启后模型列表仍为空，检查接管后的 `~/.codex/config.toml` 是否仍保留 `model` 与 `model_catalog_json`；该问题在 v3.20.2 仍有未解决报告。
Affected Versions
Section titled “Affected Versions”Source Issues
Section titled “Source Issues”本页汇总自 6 个真实 issue
- #3795[Bug] Codex 接管配置不完整：缺少 requires_openai_auth、model_catalog_json 等关键字段，导致请求静默失败
- #4195[Codex] cc-switch 生成的 model catalog 缺少 available_in_plans / minimal_client_version 等字段，导致 Codex.app 桌面版右下角不显示模型名
- #4420在codex桌面端无法看到自定义模型列表
- #5182[bug] 第三方 Codex 供应商导入后模型列表/推理强度显示为"自定义"：导出的 model_catalog_json 为 snake_case，与 Codex ≥0.144（camelCase）解析契约不匹配
- #7430[Bug] Codex 代理接管重写 config.toml 时丢弃 model / model_catalog_json，自定义模型列表清空
- #7880聚合的模型暂不可用：读取不到 Codex 模型列表 要如何配置
- 终端运行 `codex debug models` 能看到第三方模型，但桌面端为什么不显示？
- 这表示数据层可能正常，问题可能只在桌面端显示层；按保留官方登录态并重启 Codex 的步骤处理。
- 不敢登录 ChatGPT 账号怎么办？
- 输入 issue 中没有提供不登录官方 ChatGPT 账号的等效解决方案。
- 模型可用但右下角不可见，重新登录后会恢复吗？
- 有用户反馈在 cc-switch 接入 Codex 后退出登录，再使用 ChatGPT 账户登录，右下角模型恢复可见。
- 聚合的模型暂不可用、读取不到 Codex 模型列表要如何配置？
- 检查本机 Codex CLI 是否可用、`codex debug models --bundled` 是否能输出 JSON，并确认 CC Switch 可访问 `chatgpt.com`；处理后退出聚合再重新进入。
这是一个非官方社区 wiki，与 cc-switch 作者及项目本身无隶属关系。内容整理自项目公开的 GitHub issues。本站不分发任何软件。