docs/guides/codex-desktop-custom-model-visibility-zh.md
适用版本:CC Switch v3.16.1 及以上。本文解释「为什么 Codex 桌面应用看不到自定义模型」以及可用的缓解办法;详细的图文配置步骤见 使用第三方 API 时保留 Codex 远程操作和官方插件。
在 CC Switch 里把 Codex 切换到第三方 / 自定义模型(DeepSeek、Kimi、GLM、MiniMax、中转站等)后:
codex 的 /model 里一切正常。很多用户都遇到过这个现象,下面解释原因与办法。
这不是 CC Switch 的本地配置问题,也不是 CC Switch 的 bug,而是 Codex 桌面应用(上游闭源客户端)自身的模型门控行为。
Codex 桌面应用的模型选择器会按你当前的登录身份来决定放行哪些模型:当它检测不到官方 ChatGPT / Codex 登录态时,会把选择器强制回落到官方默认模型,把你通过 config.toml 配置的自定义模型藏起来(思考等级也会一并回落到官方默认)。官方已把「在桌面 GUI 里暴露自定义供应商模型」标记为 not planned,因此 CC Switch 无法从桌面 GUI 层面彻底修复它。
命令行 codex 的 /model 与请求路由都能正常识别 config.toml 里的自定义供应商,唯独桌面 GUI 的选择器受这层门控限制。
办法是保留官方登录态,让桌面应用的门控放行你的自定义模型。要点如下(完整图文步骤见下方链接的攻略):
设置 → 通用 → Codex 应用增强 → 切换第三方时保留官方登录(默认关闭)。开启后,CC Switch 在切换第三方供应商时会保留 ~/.codex/auth.json 里的官方登录态、把第三方 Key 写进 config.toml,于是桌面应用仍识别官方登录身份、门控放行,你配置的自定义模型就会重新出现在选择器里。保留的官方 Token 不会被发往第三方——第三方模型请求仍用你配置的 Key 经本地路由转发。
📖 详细图文步骤:使用第三方 API 时保留 Codex 远程操作和官方插件
codex debug models 可以列出 CLI 端实际可用的模型,确认模型本身已正确配置(CLI 不受此门控影响)。