这是 issue #19694 引发的客户端过滤异常：Codex 桌面端模型列表为空，但 CLI 可以正常显示；此时通常需要手动输入模型 ID 才能使用。另一个常见原因是 provider 配置必须放在用户级 ~/.codex/config.toml 中；如果是缓存或渲染状态损坏，删除 Cache 文件夹或整个 web 目录后即可重建缓存并恢复模型列表显示。

如果你在 Codex 桌面端打开模型选择器时，发现下拉列表完全为空，或者只看到“Custom”却没有具体模型名称，而在 CLI 中执行 /model 却能正常列出全部模型，那么这通常不是网络连接问题，也不是 API 密钥失效，而是桌面客户端在加载模型目录时触发了已知的过滤逻辑异常，或本地状态缓存已经损坏。

先验证是不是客户端过滤缺陷

先在当前项目目录打开终端，运行 codex 启动 CLI，然后输入 /model 命令。如果返回结果中明确包含你的目标模型，例如 gpt-5.6-sol 或自定义模型 deepseek-coder-33b，但 Codex 桌面端依旧不显示，那么【这基本可以确定是 issue #19694 的客户端过滤缺陷】。出现这种情况时，修改 config.toml、清理普通缓存，甚至重新安装客户端，往往都无法直接解决，关键在于绕过桌面端的 UI 渲染路径。

可行的解决方法是：直接在 Codex 桌面端输入框中手动输入模型 ID（例如 gpt-5.6-sol），然后按回车确认。模型会立即生效，相关功能也能正常使用。也就是说，问题只是“列表不显示”，并不代表“模型不能用”。

检查 provider 配置位置是否正确

方法一：先确认配置文件路径是否正确
打开文件管理器，找到 ~/.codex/config.toml（macOS/Linux）或 %USERPROFILE%AppDataRoamingCodexconfig.toml（Windows）。很多用户遇到 Codex 模型列表不显示的问题，根源就在这里：如果你的 provider 配置写在项目根目录下的 .codex/config.toml，桌面端实际上不会读取这个位置，因此配置会被直接忽略。【必须将 provider 配置放到用户级 ~/.codex/ 目录中，桌面端才会正确加载】。

方法二：快速移动配置（推荐）
在终端执行：mkdir -p ~/.codex && cp .codex/config.toml ~/.codex/ → 删除原来的项目级 .codex 文件夹 → 重新启动 Codex 桌面端。

重建模型目录缓存

第一步：彻底关闭 Codex 桌面端的所有窗口，包括后台进程；
第二步：删除 Chromium 用户数据中的模型缓存目录：
macOS：执行 rm -rf ~/Library/Application Support/Codex/web/Default/Cache；
Windows：手动删除 %USERPROFILE%AppDataRoamingCodexwebDefaultCache；
第三步：重新启动 Codex，等待大约 8 秒，它会自动重建缓存目录并重新拉取最新模型列表。

注意：不要只清理 Cache 目录里的部分文件，必须删除整个 Cache 文件夹，否则旧缓存仍可能继续干扰初始化过程，导致 Codex 桌面端模型列表依旧无法正常显示。

修复语言切换导致的 UI 渲染损坏

如果你之前切换过界面语言，例如先从英文改成中文，之后又切换回英文，而从那以后模型列表一直空白，但 CLI 仍可正常显示模型，那么基本可以判断：问题很可能出在 Chromium 持久化状态被写坏，进而导致桌面端 UI 渲染异常。很多人遇到这种情况会先尝试重装 Codex，但通常没有效果。原因很简单——AppDataRoamingCodexweb（Windows）或 ~/Library/Application Support/Codex/web（macOS）中的本地用户数据，并不会因为重装程序而自动清除。

执行：rm -rf ~/Library/Application Support/Codex/web（macOS）或彻底删除 Windows 下的 %USERPROFILE%AppDataRoamingCodexweb 整个文件夹 → 重启 Codex。首次启动后会恢复默认英文界面，同时模型列表通常也会一并恢复正常显示。