Skip to content
CC Switch WikiUnofficial Community Wiki

{"models":[]}: Codex OpenAI official proxy model catalog is empty

Quick fix

Temporarily place the Codex-format catalog file inside CODEX_HOME and reference it in config.toml; the official proxy forwarding fix is unconfirmed.

Symptom

Section titled “Symptom”
Error output
{"models":[]}

Cause

Section titled “Cause”

The local model catalog handler in CC Switch 3.20.4 reads only the CC Switch-managed catalog file referenced in the configuration; if no such file is configured, it returns HTTP 200 with an empty catalog. As a result, models available to the official account may not appear, and Codex falls back to its built-in model list. The report says this issue is reproducible on both macOS and Windows.

Fix

Section titled “Fix”

  1. Temporary workaround: place the Codex-format model catalog file inside CODEX_HOME, name it cc-switch-model-catalog.json, and reference that file in the Codex configuration. A Windows user verified this workaround; the catalog file must include the required models.

    ~/.codex/config.toml
    model_catalog_json = "C:/Users/<user>/.codex/cc-switch-model-catalog.json"

Affected Versions

Section titled “Affected Versions”
ToolCodex
Version3.20.4（受影响版本；问题报告仍为 open）
PlatformsmacOSWindows

Source Issues

Section titled “Source Issues”

This page is distilled from 1 real issues

FAQ

Section titled “FAQ”
Why don't models available to my official OpenAI account appear in the Codex model selector?
The local proxy may return an empty model catalog, after which Codex uses its built-in model list. Models available to the account but missing from the built-in list may therefore not appear.
What requirements must `model_catalog_json` meet?
A Windows reproduction showed that the referenced file must exist, be located inside CODEX_HOME, and have the exact filename cc-switch-model-catalog.json; if any requirement is unmet, the interface still returns an empty catalog.
Has this temporary workaround been verified?
A Windows user reported that after placing the Codex-format catalog in an allowed directory and referencing it, the interface returned 11 models and Codex refreshed its model cache.
Section titled “Related problems”
The 'gpt-6-sol' model is not supportedUpdate the Codex OAuth reported client version to one supported by the model and rebuild, or temporarily use gpt-5.6-sol / gpt-5.6-luna.4 issues mergedGateway /v1/models returned an unexpected body: Claude CodeNo verified solution is available; the local proxy must return an Anthropic `data` model-list format to Claude Code.1 issues mergedUpstream HTTP 404 - DeepSeekResolve based on the scenario: if the endpoint path is the issue, complete the API address with the full API root (such as `.../v1`); if the model… (cc-switch)6 issues merged

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.