Codex 桌面端接不到 GPT 最新模型?一次性成功配置指南
Codex 官方桌面客户端有个已知 Bug——新版 GPT 模型参数不出现在模型选择器里。 我们验证过各种方案,最后跑通一条 100% 一次成功的完整路径,从零开始 3 部分: vibeapi 拿 GPT 分组令牌 → CC-Switch 配 API key → Codex++ 一键关联。 本文所有下载都走 vibeapi 国内高速镜像(顶部下载区自动识别系统),无需去 GitHub 手动拉。
先备三件套:Codex 本体 + CC-Switch + Codex++
全部走 vibeapi 国内高速镜像——页面自动识别您的系统, 只点亮对应架构那一张卡(x64 和 ARM 不会同时亮)。三样都装完再往下走。
问题现象
用 CC-Switch 配置好账号后,Codex 官方桌面端可以正常登录、也能发送对话, 但模型选择器里始终看不到最新的 GPT 模型参数。这不是账号权限、也不是 CC-Switch 配置错—— 是 Codex 官方客户端目前的一个 Bug:它对新增模型的识别有延迟或缺失。
重装、清缓存、重配 CC-Switch 都不管用。最终跑通的方案是让开源工具 Codex++ 作为「中间人」——它维护一份供应商配置,把新模型列表推给 Codex 桌面端,绕过官方客户端这个 Bug。 下面 3 个部分、8 步做完就是终局:vibeapi 拿 GPT 分组令牌 → CC-Switch 配 key → Codex++ 一键关联。
关于 Codex++:社区开源项目,vibeapi 只是在自己的 CNB 制品库里同步了一份镜像方便国内高速下载——文件跟上游 Release 完全一致。
Ⅰ · 平台令牌管理 · 生成 GPT 分组 Key
先去 vibeapi.cn 建一把令牌。
分组必须选「GPT 分组」——选错分组(比如选到 Claude)会让后面 Codex 里看不到 GPT 模型。
登录 vibeapi.cn,导航到 控制台 → 令牌管理,点右上角「添加令牌」按钮。
自定义令牌名称,令牌分组一定要选「GPT 分组」,其他参数默认即可,提交。
为什么必须选 GPT 分组:vibeapi 按分组路由模型集——只有 GPT 分组的 key 能路由到 GPT 全套最新模型。选到 Claude / Gemini 等其他分组的 key 走的是别的模型池,在 Codex 里当然看不到 GPT。
创建成功后回到令牌列表,把这条 GPT 分组令牌的 sk-xxx 复制下来——第 05 步要用它。
Ⅱ · CC-Switch 完成 API key 配置
没装 CC-Switch 就先回顶部 B 组下载卡拿一个——已经根据您的系统只亮对应架构那张, 点亮着的那张一路下一步装完。然后打开 CC-Switch,按下面 2 步把刚拿的 GPT 分组令牌配进去。
打开 CC-Switch,顶部选项卡切到 OpenAI,然后点右上角「+」添加供应商。
供应商名称随便起(比如 vibeapi),把第 03 步复制的 sk-xxx 填到 key,
api 请求地址填 vibeapi 的 endpoint(在 vibeapi 控制台首页或文档里能找到)。
其他模型参数不用填——Codex++ 会自己拉取模型列表。保存。
Ⅲ · Codex++ 关联并启动
没装 Codex++ 就先回顶部 C 组下载卡装一个——同样只亮对应架构那张。 安装后打开 Codex++ 管理工具,下面 3 步把 CC-Switch 里那份配置一键搬过来,然后重启 Codex 桌面端就完事。
打开 Codex++ 管理工具,左侧栏进 供应商配置,点「从第三方导入」,选 CC-Switch—— 它会自动扫本机 CC-Switch 里那份 OpenAI 供应商配置,直接搬过来,不用手动抄 key / endpoint。
导入完成后,供应商列表里就出现刚从 CC-Switch 搬过来的那条。点右侧「编辑」按钮进入详情, 按截图接线(模型列表、default 模型等),保存后完全退出(不是最小化——从系统托盘 / Dock 里退)Codex 桌面端。
「完全退出」不能省:Codex 桌面端只在启动那一下读一次供应商配置。 只最小化 / 关窗口,进程还挂着,配置就不会重读,模型列表还是老的。
回到 Codex++ 管理工具,点「重启 Codex 桌面端」(或者自己去开一下 Codex)。 进入桌面端后,供应商选 vibeapi——GPT 全套最新模型参数都会出现在选择器里, 体验跟用 Codex 官方订阅号完全一致,走的却是 vibeapi 平台的稳定 API 链路。
补充说明
一次配置终生复用:Codex++ 会记住这份供应商配置,之后每次启动都不用重来。 换 endpoint 或换 key 时也不用重走 CC-Switch——直接在 Codex++ 供应商列表里编辑那一条即可。
官方 Bug 什么时候修好:这个问题是 Codex 官方桌面端识别新模型的问题, 待官方后续版本自己修复。修好之后可以直接用官方链路,也可以继续用 Codex++——两条路径不冲突,随时切换。