Codex desktop cannot see models
Quick fix
Sign in to official ChatGPT, enable “Keep official login when switching to third parties,” and enable local routing. Restart Codex.
Symptom
Section titled “Symptom”就是桌面端无法看到模型The desktop app simply cannot see models.
The Codex desktop app uses the presence of an official ChatGPT login session to decide whether to show third-party custom models. Without an official login session, the model selector may fall back to the official default model; even when `codex debug models` lists third-party models, the desktop app’s “Custom” category may still be empty.
This cluster also includes other variants: some reports say the catalog field names do not match the parsing contract in Codex ≥0.144, or that `model` and `model_catalog_json` are lost when taking over and rewriting `config.toml`; another report says aggregate mode cannot read the official or local Codex model list. The maintainer said the incomplete takeover configuration in v3.16.0 was fixed in v3.16.1 + 3.16.2, but reports describe different behavior in v3.16.2, v3.16.3, and v3.20.2.
Sign in to an official ChatGPT account once in the Codex desktop app to ensure official login credentials are present.
In cc-switch settings, enable “Keep official login when switching to third parties.”
Confirm that local routing or route takeover is enabled for the third-party provider, then fully quit and restart the Codex desktop app.
If a message says the aggregate model list cannot be read, check whether `codex --version` and `codex debug models --bundled` produce output, and confirm that CC Switch can access `chatgpt.com`.
If the model list is still empty after restarting, check whether the takeover-modified `~/.codex/config.toml` still contains `model` and `model_catalog_json`; an unresolved report for this issue exists in v3.20.2.
Affected Versions
Section titled “Affected Versions”Source Issues
Section titled “Source Issues”This page is distilled from 6 real issues
- #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 模型列表 要如何配置
- Why does the desktop app not show third-party models even though `codex debug models` lists them in the terminal?
- This suggests the data layer may be working and the issue may be limited to the desktop display layer. Follow the steps to preserve the official login session and restart Codex.
- What if I am not comfortable signing in to a ChatGPT account?
- The issue provides no equivalent solution that avoids signing in to an official ChatGPT account.
- The model works but is not visible in the lower-right corner. Will signing in again restore it?
- One user reported that after connecting Codex through cc-switch, signing out and then signing in with a ChatGPT account made the model visible in the lower-right corner again.
- How should I configure things when aggregate models are temporarily unavailable or the Codex model list cannot be read?
- Check that the local Codex CLI works, that `codex debug models --bundled` outputs JSON, and that CC Switch can access `chatgpt.com`; then exit aggregate mode and enter it again.
Related problems
Section titled “Related problems”This is an unofficial community wiki with no affiliation to the cc-switch authors or the project itself. Its content is compiled from the project's public GitHub issues. This site distributes no software.