Codex 桌面端接入国产模型完整教程：CC Switch 配置 DeepSeek、Kimi、GLM、MiniMax

适用版本：CC Switch v3.18.0（2026-07-21）| Codex Desktop + CLICodex 桌面端接入国产模型的关键不是填对 API Key，而是解决两个隐藏机制：一是 Codex 桌面应用会按登录身份对模型选择器做门控，检测不到官方登录态时会把自定义模型全部隐藏；二是 DeepSeek、Kimi、MiniMax 等国产供应商暴露的是 OpenAI Chat Completions 协议，而新版 Codex 面向的是 Responses API，两者请求体和流式结构不同，直连会导致 404 或流式解析失败。CC Switch（GitHub 12.1 万 stars，MIT 许可）用两个开关解决这两件事：「Codex 应用增强 → 切换第三方时保留官方登录」让官方 Access Token 留在 auth.json、第三方配置写入 config.toml，从而骗过桌面端门控；「本地路由」在 127.0.0.1:15721 起一个转换层，把 Codex 发出的 Responses 请求改写为 Chat Completions 再转发给上游。完整流程为六步：切回 OpenAI Official 完成官方登录 → 开启应用增强开关 → 用内置预设添加国产供应商并填 Key → 开启本地路由并启用 Codex 接管 → 启用该供应商 → 完全重启 Codex。

一、先理解两个坑，配置才不会白折腾

90% 的人卡住不是配置填错，而是不知道有这两层机制存在。

坑一：桌面端的模型门控

现象是这样的——在 CC Switch 里切到 DeepSeek 后：

● Codex 桌面应用的模型选择器里看不到自定义模型，只剩官方默认模型，思考等级也回落

● 但命令行 codex 的 /model 里一切正常

据 CC Switch 官方文档明确说明，这不是 CC Switch 的 bug，而是 Codex 桌面应用（上游闭源客户端）自身的模型门控行为：桌面端的模型选择器会按当前登录身份决定放行哪些模型，检测不到官方 ChatGPT / Codex 登录态时，会强制回落到官方默认模型，把 config.toml 里配置的自定义模型藏起来。

官方已把「在桌面 GUI 里暴露自定义供应商模型」标记为 not planned，所以这个问题无法从桌面 GUI 层根治，只能靠保留官方登录态来绕过。

坑二：协议不匹配

协议	使用方	接口路径
Responses API	新版 Codex CLI / 桌面端	/responses
Chat Completions	DeepSeek、Kimi、MiniMax、硅基流动等	/chat/completions

据 CC Switch 官方文档，两种协议的请求体、流式事件和返回结构都不同，直接把 Chat 接口填进 Codex 配置，常见结果是模型列表不对、请求 404/400，或流式响应无法被 Codex 正确解析。

CC Switch 的解法是插入一层本地转换：

Codex Responses 请求
        ↓
CC Switch 本地路由（127.0.0.1:15721）
        ↓
第三方 Chat Completions API
        ↓
转换回 Codex Responses 响应

二、准备工作

据官方文档，你需要准备：

● CC Switch v3.16.1 或更新版本（应用增强开关自 v3.16.1 起做成开关，v3.18.0 为当前最新）

● 已安装并能启动的 Codex——建议 app 和 cli 都装

● 一个可登录 Codex 的官方 ChatGPT / Codex 账号，Free 订阅即可

● 一个国产模型 API Key（DeepSeek / Kimi / GLM / MiniMax 任选）

⚠️ 官方特别提示：请不要手动复制或分享 ~/.codex/auth.json 的内容，里面保存的是官方登录缓存和 Access Token，属于敏感信息。

三、六步完整配置流程

第 1 步：切回 OpenAI Official 并完成官方登录

打开 CC Switch，切到顶部的 Codex 标签页，选择 OpenAI Official 供应商并设为当前供应商（若列表里没有，从预设供应商中添加）。

接着启动 Codex（建议启动 CLI），按官方流程登录 ChatGPT / Codex 账号。Free 订阅就够用——这个账号在本方案里只负责保留桌面端需要识别的登录身份，不负责第三方模型的计费。

登录完成后，Codex 会在 ~/.codex/auth.json 中保存官方登录缓存。后面的关键是不要让第三方供应商切换覆盖这个文件。

第 2 步：开启 Codex 应用增强

回到 CC Switch，进入：

设置 → 通用 → Codex 应用增强 → 切换第三方时保留官方登录

这个开关默认关闭。 开启后，切换第三方供应商时会走 config-only 写入路径：

● auth.json：继续保留官方 ChatGPT / Codex 登录缓存

● config.toml：写入第三方供应商的模型、endpoint、model_provider 和 provider-scoped experimental_bearer_token

第 3 步：用内置预设添加国产供应商

回到 Codex 面板，点击右上角加号添加供应商。强烈建议优先用内置预设——预设已配好 base URL、默认模型、模型映射表、thinking/reasoning 参数，并会自动打开「需要本地路由映射」。

四家国产模型的预设信息（据 CC Switch 官方指南与各厂商官方文档）：

供应商	预设名	base URL	默认模型	协议
DeepSeek	DeepSeek	https://api.deepseek.com	DeepSeek V4 Flash	Chat（需路由）
Kimi 开放平台	Kimi	https://api.moonshot.cn/v1	kimi-k2.7-code	Chat（需路由）
Kimi For Coding	Kimi For Coding	https://api.kimi.com/coding/v1	kimi-for-coding	Chat（需路由）
GLM	GLM	智谱 Anthropic 兼容：https://open.bigmodel.cn/api/anthropic；Coding Plan：https://open.bigmodel.cn/api/coding/paas/v4	GLM-5.2	视预设配置
MiniMax	MiniMax	见预设	见预设	Chat（需路由）

Kimi 的两个预设别选错：Kimi（platform.kimi.com 开放平台）是按 token 用量计费的 Key；Kimi For Coding（kimi.com/code）是 Kimi 会员 Kimi Code 权益生成的专用 Key，模型统一为 kimi-for-coding。

选好预设后只需两件事：填入 API Key、保存供应商。

第 4 步：开启本地路由并接管 Codex

进入：

设置 → 路由 → 本地路由

完成两个开关：

1. 打开 路由总开关，启动本地服务（默认地址 127.0.0.1:15721）

2. 在 路由启用 中打开 Codex（只想让 Codex 走路由的话，Claude、Gemini 可保持关闭）

Chat Completions 协议的供应商（DeepSeek / Kimi / MiniMax）必须开启这一步，否则会报 404 或流式异常。接管后 CC Switch 会把 Codex 的 live 配置指向本机路由，真实 API Key 仍存在 CC Switch 的供应商配置里，由路由在转发时注入。

第 5 步：启用供应商

回到 Codex 供应商列表，点击目标供应商的启用。若看到 需要路由 标记，说明该供应商必须在路由运行时使用；没启动路由时 CC Switch 会弹出「需要路由服务才能正常使用」提示。

第 6 步：完全退出并重启 Codex

必须是完全退出重启，不是关窗口。 原因据官方文档说明有两点：

● Codex 在启动时读取 config.toml

● Codex 的 /model 菜单需要重启后才会重新加载 model_catalog_json

四、配置成功后长什么样

验证清单（据官方文档）：

检查项	预期结果
Codex App 账号信息	仍显示官方账号（这是预期行为，不是失败）
CC Switch 当前供应商	显示为第三方供应商
路由请求日志	能看到 Codex 请求经过本地路由
第三方供应商后台	余额记录出现实际模型请求
Codex /model 菜单	能看到预设模型，如 DeepSeek V4 Flash、Kimi K2.7 Code

底层写入了什么

开启应用增强后，~/.codex/config.toml 中会出现类似结构：

model_provider = "custom"
 
[model_providers.custom]
name = "DeepSeek"
base_url = "https://api.deepseek.com"
wire_api = "responses"
experimental_bearer_token = "sk-..."

而 auth.json 保持官方登录缓存不变。Codex 桌面端看到的是 auth.json 的官方身份所以放行模型，实际请求则按 config.toml 走第三方。

五、三个必须理解的副作用

1. 显示官方账号 ≠ 配置没生效

这是最容易误判的一点。 开启应用增强后，Codex App 读的是 auth.json 里的官方登录态，所以会持续显示官方账号信息。但这不代表请求走的是官方 OpenAI——实际流量以 CC Switch 当前供应商、config.toml 和路由日志为准。

2. 不要用 Codex 里的账号信息判断计费方

切到 DeepSeek 后 Codex 仍显示官方账号，但计费、限额、错误码和数据策略都应按第三方供应商理解。可在 CC Switch 的用量面板查看具体请求信息。

3. 官方登录态会过期

据官方文档，若连续几天没用过官方登录，Token 失效后模型选择器可能又变空——重新登录一次官方即可恢复。

⚠️ 官方明确不建议的操作：在本地路由接管模式下切回 OpenAI Official。CC Switch 会尽量阻止这种操作，因为用代理访问官方 API 可能带来账号风险。建议官方登录只用于保留 auth.json，模型流量始终走第三方供应商。

六、故障排查

Q：开了增强开关，桌面端还是看不到自定义模型？

按官方给的三条顺序排查：

1. 确认开关真的开了——它默认关闭，很多人第一次切第三方就把官方登录态覆盖了

2. 官方登录态可能过期——重新登录一次官方

3. 用 CLI 兜底诊断——codex debug models 可列出 CLI 端实际可用模型，确认模型本身配置正确（CLI 不受门控影响）

Q：上游报 404？

若用内置预设，先确认当前供应商确实来自预设且路由已启用。只有自定义供应商才需要检查 base URL——它应该是服务根地址，而不是带 /chat/completions 的完整接口路径。

Q：/model 看不到国产模型？

保存供应商后重启 Codex。CC Switch 会生成 cc-switch-model-catalog.json 并把路径写入 model_catalog_json，但运行中的 Codex 进程不一定热加载模型目录。

Q：Codex app 里只能用一个模型？

据官方文档说明，目前 Codex app 不支持多模型选择，会默认使用配置里的第一个模型。 需要多模型切换请用 CLI。

Q：能同时并行用多个模型吗？

不能。Codex CLI 任何时刻只读取当前激活的那一条配置，CC Switch 切换的是「哪条生效」，不是「全部并行」。要并行使用不同模型，需分别开多个终端 + 多套 ~/.codex/ 配置目录。

Q：预设里没有我的供应商怎么办？

选自定义配置，按对方文档填 API Key、base URL 和模型，并把「高级选项 → 上游格式」选为 Chat Completions（需开启路由）。

七、四家模型怎么选

模型	适合场景	计费方式
DeepSeek V4	日常编码、成本敏感场景	按 token 用量
Kimi K2.7 Code	长上下文任务；开放平台按量计费	按 token 用量
Kimi For Coding	已购 Kimi 会员 Code 权益	订阅制
GLM-5.2	Coding Plan 下支持 200k 上下文，跨文件重构	订阅制 / 按量
MiniMax	多模态与长文本场景	按 token 用量

一条实践经验：先用 DeepSeek 或 GLM Coding Plan 跑通流程，确认路由和门控都正常后再折腾其他供应商——排查问题时变量越少越好。

模型层抽象的价值：把模型供应商从工具配置里解耦出来，好处不只是省钱。上个月 Anthropic 因出口管制一度对境外用户禁用 Fable 5、Mythos 5，任何把单一模型硬编码进生产链路的团队都受了影响。保留切换能力属于业务连续性要求——除了 CC Switch 这类本地方案，也可以通过兼容 OpenAI SDK 的统一网关接入多款主流大模型，例如七牛云推理服务兼容该接口，国内可直接访问，切换模型无需改动本地配置。

八、总结

Codex 桌面端接入国产模型的难点全在两个隐藏机制上：桌面端按登录身份门控模型选择器，国产供应商用的是 Chat Completions 而非 Responses 协议。 理解了这两点，配置流程就只是六个步骤的机械操作。

三个最容易踩的坑再强调一次：应用增强开关默认关闭必须手动开、Chat 协议供应商必须开本地路由、改完配置必须完全重启 Codex。

据 CC Switch 官方仓库数据（GitHub 121557 stars，MIT 许可，最新版本 v3.18.0 发布于 2026-07-21）与官方配置指南，该方案目前处于活跃维护状态。本文内容基于 2026 年 7 月 27 日的官方文档整理，各厂商 API 端点与模型名称可能调整，配置时建议以 CC Switch 内置预设和厂商官方文档为准。

延伸资源

● CC Switch 官方配置攻略（保留 Codex 官方登录）：https://github.com/farion1231/cc-switch/blob/main/docs/guides/codex-official-auth-preservation-guide-zh.md

● 一个key接入deepseek、minimax、kimi、GLM模型：https://www.qiniu.com/ai/plan