这是 issue #19694 的客户端过滤缺陷：桌面端模型列表为空但 cli 正常，需手动输入模型 id；provider 配置必须放在用户级 ~/.codex/config.toml；删除 cache 文件夹或整个 web 目录可重建缓存并修复渲染问题。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
你在 Codex 桌面端打开模型选择器，下拉列表里空空如也，或者只显示“Custom”但没有具体模型名，而 CLI 运行 /model 却能正常列出全部模型——这不是网络问题，也不是密钥失效，而是桌面客户端在加载模型目录时触发了已知过滤逻辑或状态损坏。
先验证是不是客户端过滤缺陷
在当前项目目录下打开终端，运行 codex 启动 CLI，输入 /model 命令。如果列表里明确出现了你的目标模型（例如 gpt-5.6-sol 或自定义的 deepseek-coder-33b），但桌面端就是不显示，【这 100% 是 issue #19694 的客户端过滤缺陷】。此时改 config.toml、清缓存、重装都无效，必须绕过 UI 渲染路径。
直接在桌面端输入框里手动敲入模型 ID（比如 gpt-5.6-sol），回车确认。模型会立刻生效，所有功能完全可用——你只是看不到它，不是用不了它。
检查 provider 配置位置是否正确
方法一：确认配置文件是否放在用户级目录
打开文件管理器，定位到 ~/.codex/config.toml（macOS/Linux）或 %USERPROFILE%\AppData\Roaming\Codex\config.toml（Windows）。如果你的 provider 配置写在项目根目录下的 .codex/config.toml，桌面端会直接忽略它。【必须移到用户级 ~/.codex/ 目录下才被桌面端读取】。
方法二：快速移动配置（推荐）
终端执行：mkdir -p ~/.codex && cp .codex/config.toml ~/.codex/ → 删除原项目级 .codex 文件夹 → 重启 Codex 桌面端。
统一LLM网关 - 一个API对接70+AI模型，使用单一API密钥即可调用GPT、Claude、Gemini、Qwen、Deepseek、Grok等主流模型。
重建模型目录缓存
第一步：关闭 Codex 桌面端所有窗口，包括后台进程；
第二步：删除 Chromium 用户数据中的模型缓存目录：
macOS：执行 rm -rf ~/Library/Application\ Support/Codex/web/Default/Cache；
Windows：手动删除 %USERPROFILE%\AppData\Roaming\Codex\web\Default\Cache；
第三步：重新启动 Codex，等待约 8 秒——它会自动重建目录并拉取最新模型列表。
注意：不要只删 Cache 子目录，必须删整个 Cache 文件夹，否则旧缓存仍会干扰初始化。
修复语言切换导致的 UI 渲染损坏
如果你曾切换过界面语言（比如从英文切到中文后再切回），且模型列表从此变为空白，但 CLI 正常，大概率是 Chromium 持久化状态损坏。此时重装无效，因为 AppData\Roaming\Codex\web（Windows）或 ~/Library/Application Support/Codex/web（macOS）里的用户数据不会被清除。
执行：rm -rf ~/Library/Application\ Support/Codex/web（macOS）或彻底删除 Windows 下的 %USERPROFILE%\AppData\Roaming\Codex\web 整个文件夹 → 重启 Codex。首次启动会恢复默认英文界面，模型列表同步回来。
