{"models":[]}：Codex OpenAI 官方代理模型目录为空

Quick fix

临时将 Codex 格式的目录文件放在 CODEX_HOME 内，并在 config.toml 中引用；官方代理转发修复尚未确认。

Symptom

报错原文复制

{"models":[]}

Cause

CC Switch 3.20.4 的本地模型目录处理器只读取配置引用的 CC Switch 托管目录文件；未配置该文件时会返回 HTTP 200 和空目录。官方账户实际可用的模型可能因此不显示，Codex 会回退到内置模型列表。报告称此问题在 macOS 和 Windows 均可复现。

Fix

1. 1

   临时规避：将 Codex 格式的模型目录文件放在 CODEX_HOME 内，文件名使用 cc-switch-model-catalog.json，并在 Codex 配置中引用该文件。该方案已由 Windows 用户验证；目录文件需包含所需模型。

   ~/.codex/config.toml

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

Affected Versions

ToolCodex

Version3.20.4（受影响版本；问题报告仍为 open）

PlatformsmacOSWindows

Source Issues

本页汇总自 1 个真实 issue

• #7640Bug: OpenAI Official proxy returns an empty Codex model catalog

FAQ

为什么 OpenAI 官方账户能用的模型没有显示在 Codex 模型选择器中？

本地代理可能返回空模型目录，Codex 随后使用内置模型列表；账户可用但内置列表未包含的模型因此可能不显示。

`model_catalog_json` 应该满足什么条件？

Windows 复现显示，引用文件必须存在、位于 CODEX_HOME 内，且文件名恰为 cc-switch-model-catalog.json；任一条件不满足时，接口仍会返回空目录。

这个临时规避方案是否已验证？

Windows 用户报告将 Codex 格式目录放在允许目录并引用后，接口返回 11 个模型，Codex 也刷新了自己的模型缓存。

相关问题

The 'gpt-6-sol' model is not supported将 Codex OAuth 自报客户端版本更新到模型支持的版本后重新编译，或暂时改用 gpt-5.6-sol / gpt-5.6-luna。4 issues mergedGateway /v1/models returned an unexpected原帖尚无可验证解法；需让本地代理向 Claude Code 返回 Anthropic `data` 模型列表格式。1 issues merged上游 HTTP 404 - DeepSeek根据具体场景解决：如果是端点路径问题，请将 API 地址补全为完整的 API root（如 `.../v1`）；如果是模型能力问题，请切换到支持图片的模型或等待 cc-switch 修复。6 issues merged