操作指南 · Codex 桌面端配置

Codex 桌面端接不到 GPT 最新模型?一次性成功配置指南

Codex 官方桌面客户端有个已知 Bug——新版 GPT 模型参数不出现在模型选择器里。 我们验证过各种方案,最后跑通一条 100% 一次成功的完整路径,从零开始 3 部分: vibeapi 拿 GPT 分组令牌 → CC-Switch 配 API key → Codex++ 一键关联。 本文所有下载都走 vibeapi 国内高速镜像(顶部下载区自动识别系统),无需去 GitHub 手动拉。

Codex 桌面端 CC-Switch Codex++ · 开源 GPT 分组 vibeapi 令牌

先备三件套:Codex 本体 + CC-Switch + Codex++

全部走 vibeapi 国内高速镜像——页面自动识别您的系统, 只点亮对应架构那一张卡(x64 和 ARM 不会同时亮)。三样都装完再往下走。

Linux?其他架构?或者 Claude 桌面端 / 基础环境? → 打开下载中心(Claude / Codex / CC-Switch / Codex++ 全集)

问题现象

用 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 模型。

01
进 vibeapi 控制台 · 令牌管理 · 添加令牌

登录 vibeapi.cn,导航到 控制台 → 令牌管理,点右上角「添加令牌」按钮。

vibeapi 控制台 · 令牌管理
vibeapi 控制台 · 令牌管理 · 点右上角「添加令牌」
02
新建令牌 · 分组选 GPT 分组

自定义令牌名称,令牌分组一定要选「GPT 分组」,其他参数默认即可,提交。

新建令牌 · 分组选 GPT
令牌分组 · 选 GPT 分组(选错分组后面看不到 GPT 模型)

为什么必须选 GPT 分组:vibeapi 按分组路由模型集——只有 GPT 分组的 key 能路由到 GPT 全套最新模型。选到 Claude / Gemini 等其他分组的 key 走的是别的模型池,在 Codex 里当然看不到 GPT。

03
令牌创建成功 · 复制 sk-xxx

创建成功后回到令牌列表,把这条 GPT 分组令牌的 sk-xxx 复制下来——第 05 步要用它。

令牌创建成功 · 复制 key
令牌创建成功 · 复制这条 GPT 分组令牌

Ⅱ · CC-Switch 完成 API key 配置

没装 CC-Switch 就先回顶部 B 组下载卡拿一个——已经根据您的系统只亮对应架构那张, 点亮着的那张一路下一步装完。然后打开 CC-Switch,按下面 2 步把刚拿的 GPT 分组令牌配进去。

04
CC-Switch → OpenAI 选项卡 → 添加供应商

打开 CC-Switch,顶部选项卡切到 OpenAI,然后点右上角「+」添加供应商。

CC-Switch · OpenAI 选项卡 · 添加供应商
CC-Switch · OpenAI 选项卡 · 右上角「+」添加供应商
05
只需要填 key + api 请求地址

供应商名称随便起(比如 vibeapi),把第 03 步复制的 sk-xxx 填到 key, api 请求地址填 vibeapi 的 endpoint(在 vibeapi 控制台首页或文档里能找到)。 其他模型参数不用填——Codex++ 会自己拉取模型列表。保存。

CC-Switch · 填 key + endpoint
CC-Switch · 填 key + api 请求地址,其他模型参数不用管

Ⅲ · Codex++ 关联并启动

没装 Codex++ 就先回顶部 C 组下载卡装一个——同样只亮对应架构那张。 安装后打开 Codex++ 管理工具,下面 3 步把 CC-Switch 里那份配置一键搬过来,然后重启 Codex 桌面端就完事。

06
打开 Codex++ · 从 CC-Switch 一键导入

打开 Codex++ 管理工具,左侧栏进 供应商配置,点「从第三方导入」,选 CC-Switch—— 它会自动扫本机 CC-Switch 里那份 OpenAI 供应商配置,直接搬过来,不用手动抄 key / endpoint。

Codex++ 管理工具 · 启动界面
Codex++ 管理工具 · 启动
从第三方导入 · 选 CC-Switch
供应商配置 · 从第三方导入 · 选 CC-Switch
07
供应商列表 · 编辑接线 · 保存并重启 Codex 桌面端

导入完成后,供应商列表里就出现刚从 CC-Switch 搬过来的那条。点右侧「编辑」按钮进入详情, 按截图接线(模型列表、default 模型等),保存后完全退出(不是最小化——从系统托盘 / Dock 里退)Codex 桌面端。

供应商列表 · 编辑按钮
供应商列表 · 点右侧「编辑」按钮
按截图接线并保存
按截图接线 · 保存 · 完全退出 Codex 桌面端准备重启

「完全退出」不能省:Codex 桌面端只在启动那一下读一次供应商配置。 只最小化 / 关窗口,进程还挂着,配置就不会重读,模型列表还是老的。

08
重启 Codex 桌面端 · 选 vibeapi 供应商 · 全套 GPT 模型可用

回到 Codex++ 管理工具,点「重启 Codex 桌面端」(或者自己去开一下 Codex)。 进入桌面端后,供应商选 vibeapi——GPT 全套最新模型参数都会出现在选择器里, 体验跟用 Codex 官方订阅号完全一致,走的却是 vibeapi 平台的稳定 API 链路。

Codex 桌面端 · 接入 vibeapi 供应商
Codex 桌面端 · 接入 vibeapi 供应商成功
模型选择器 · 全套 GPT 可用
模型选择器 · GPT 全套最新模型可选

补充说明

一次配置终生复用:Codex++ 会记住这份供应商配置,之后每次启动都不用重来。 换 endpoint 或换 key 时也不用重走 CC-Switch——直接在 Codex++ 供应商列表里编辑那一条即可。

官方 Bug 什么时候修好:这个问题是 Codex 官方桌面端识别新模型的问题, 待官方后续版本自己修复。修好之后可以直接用官方链路,也可以继续用 Codex++——两条路径不冲突,随时切换。

Codex 桌面端一次性成功配置指南 · 2026-07-11