发布日期2026-07-28 | 关键词Codex 桌面端、CC Switch、DeepSeek、Kimi、GLM、MiniMax、本地路由适用版本CC Switch v3.18.02026-07-21| Codex Desktop CLICodex 桌面端接入国产模型的关键不是填对 API Key而是解决两个隐藏机制一是 Codex 桌面应用会按登录身份对模型选择器做门控检测不到官方登录态时会把自定义模型全部隐藏二是 DeepSeek、Kimi、MiniMax 等国产供应商暴露的是 OpenAI Chat Completions 协议而新版 Codex 面向的是 Responses API两者请求体和流式结构不同直连会导致 404 或流式解析失败。CC SwitchGitHub 12.1 万 starsMIT 许可用两个开关解决这两件事「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 / 桌面端/responsesChat CompletionsDeepSeek、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 KeyDeepSeek / 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-scopedexperimental_bearer_token第 3 步用内置预设添加国产供应商回到 Codex 面板点击右上角加号添加供应商。强烈建议优先用内置预设——预设已配好 base URL、默认模型、模型映射表、thinking/reasoning 参数并会自动打开「需要本地路由映射」。四家国产模型的预设信息据 CC Switch 官方指南与各厂商官方文档供应商预设名base URL默认模型协议DeepSeekDeepSeekhttps://api.deepseek.comDeepSeek V4 FlashChat需路由Kimi 开放平台Kimihttps://api.moonshot.cn/v1kimi-k2.7-codeChat需路由Kimi For CodingKimi For Codinghttps://api.kimi.com/coding/v1kimi-for-codingChat需路由GLMGLM智谱 Anthropic 兼容https://open.bigmodel.cn/api/anthropicCoding Planhttps://open.bigmodel.cn/api/coding/paas/v4GLM-5.2视预设配置MiniMaxMiniMax见预设见预设Chat需路由Kimi 的两个预设别选错Kimiplatform.kimi.com 开放平台是按 token 用量计费的 KeyKimi For Codingkimi.com/code是 Kimi 会员 Kimi Code 权益生成的专用 Key模型统一为kimi-for-coding。选好预设后只需两件事填入 API Key、保存供应商。第 4 步开启本地路由并接管 Codex进入设置 → 路由 → 本地路由完成两个开关打开路由总开关启动本地服务默认地址127.0.0.1:15721在路由启用中打开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.tomlCodex 的/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开了增强开关桌面端还是看不到自定义模型按官方给的三条顺序排查确认开关真的开了——它默认关闭很多人第一次切第三方就把官方登录态覆盖了官方登录态可能过期——重新登录一次官方用 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 进程不一定热加载模型目录。QCodex 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.2Coding 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 starsMIT 许可最新版本 v3.18.0 发布于 2026-07-21与官方配置指南该方案目前处于活跃维护状态。本文内容基于 2026 年 7 月 27 日的官方文档整理各厂商 API 端点与模型名称可能调整配置时建议以 CC Switch 内置预设和厂商官方文档为准。延伸资源CC Switch 官方配置攻略保留 Codex 官方登录github.com/farion1231/cc-switch/blob/main/docs/guides/codex-official-auth-preservation-guide-zh.mdCodex DeepSeek 本地路由实战指南github.com/farion1231/cc-switch/blob/main/docs/guides/codex-deepseek-routing-guide-zh.mdCodex Kimi 配置指南github.com/farion1231/cc-switch/blob/main/docs/guides/codex-kimi-routing-guide-zh.md七牛云KimiK3 API 接入qiniu.com/ai/models