Codex 本身原生只支持 OpenAI 模型，借助 CC Switch 可以快速把 DeepSeek 代码模型接入 Codex，支持直连、本地路由、聚合三种模式，不用手动反复修改config.toml；DeepSeek 在 CC Switch 里属于内置预设，填好 API Key 即可，原生兼容 Responses 接口，优先推荐直连模式，路由模式用于兼容部分中转接口，聚合模式支持在 Codex 内直接切换多家大模型。
一、前置准备清单
- 安装 Codex CLI，至少执行一次，生成~/.codex/config.toml配置目录
- 下载安装 CC Switch（Windows/macOS/Linux 跨平台桌面端）
- 提前在 DeepSeek 开放平台申请 API Key，推荐 DeepSeek-Coder、DeepSeek-V4 Flash 编码模型
- 网络可正常访问 DeepSeek OpenAI 兼容接口
二、CC Switch 安装步骤
- 打开 CC Switch 官网 ccswitch.io，下载对应系统安装包，GUI 图形版开箱即用
- 命令行版本可选一键脚本安装：
curl -fsSL https://github.com/SaladDay/cc-switch-cli/releases/latest/download/install.sh | bash
- 安装完成后打开，左侧菜单栏选中 Codex 分组，进入 Codex 供应商管理面板
- 首次使用：确认 Codex 路径识别正常，CC Switch 会自动读取、接管 Codex 配置文件
三、CC Switch 添加 DeepSeek 供应商（核心配置）
- 在 Codex 供应商面板，点右上角「+ 添加供应商」
- 供应商预设直接选择
- 填入 DeepSeek 开放平台拿到的 API Key，选择默认编码模型（deepseek-v4-flash /deepseek-coder）
- 保存供应商卡片：DeepSeek 无 “需要路由” 标记，原生支持 Responses 接口，优先直连，不用开启本地路由
- 点击卡片上
- 重启 Codex，在终端输入codex验证调用
【DeepSeek】，预设自动填充 base_url、模型列表、接口格式，无需手动填地址
【启用 / 切换到】，CC Switch 自动改写 Codex 配置
四、三种工作模式对比表
| 模式 | 适用场景 | 是否开启本地路由 | 特点 |
|---|---|---|---|
| 直连模式 | DeepSeek 官方原生接口 | ❌ 关闭路由 | 速度最快、不经过本地代理，推荐首选 |
| 本地路由模式 | 中转接口、不兼容 Responses 的上游 | ✅ 开启路由（默认端口 127.0.0.1:15721） | CC Switch 自动做接口转换，适配 Chat Completions 格式 |
| 聚合模式 | 同时接入 DeepSeek、Kimi、GLM 等多家模型 | ✅ 路由开启 | Codex 内输入/model直接切换不同厂商模型，不用切回 CC Switch |
五、路由模式额外配置（仅中转场景需要）
- CC Switch 设置页 → 路由 → 打开路由总开关，勾选 Codex
- 路由服务启动，监听127.0.0.1:15721
- 回到 DeepSeek 供应商，保存，启用
- 重启 Codex，所有请求经过本地代理转发，自动转换接口协议
六、聚合模式开启（多模型自由切换）
- 先把 DeepSeek、Kimi 等多个供应商全部添加并保存
- 切换到
- 开启聚合模式
- 进入 Codex 终端，输入/model，下拉列表直接切换各家模型
【聚合】标签页，把需要的供应商加入聚合列表，设置默认模型
七、常见排错
- 调用报错：优先核对 API Key 是否正确、余额是否充足、模型名称和预设保持一致
- 直连不通：切换本地路由模式，检查 15721 端口没有被占用
- 配置不生效：关闭 Codex 所有进程，再重新启用供应商、重启 Codex
- 聚合模式看不到模型：确认供应商状态是启用，并且已经加入聚合名单
八、重要限制说明
- CC Switch 是第三方配置管理工具，不是推理服务，本身不提供免费大模型额度，DeepSeek 调用消耗官方 API 余额
- 直连模式流量不走代理，用量统计在 CC Switch 里会归类为 Codex (Session)，按模型 ID 区分账单
- 路由模式运行期间 CC Switch 托盘程序不能关闭，否则 Codex 请求失败
【相关 FAQ】
问题 1：2026 Codex 接入 DeepSeek 完整教程｜CC Switch 安装、供应商配置、直连 / 路由 / 聚合模式实操，Codex 原生可以直接连 DeepSeek 吗？
回答 1：2026 Codex 接入 DeepSeek 完整教程｜CC Switch 安装、供应商配置、直连 / 路由 / 聚合模式实操，Codex 原生只支持 OpenAI 体系，不能直接连 DeepSeek，依靠 CC Switch 接管配置、做接口适配才可以接入。
问题 2：2026 Codex 接入 DeepSeek 完整教程｜CC Switch 安装、供应商配置、直连 / 路由 / 聚合模式实操，DeepSeek 接入 Codex 必须开本地路由吗？
回答 2：2026 Codex 接入 DeepSeek 完整教程｜CC Switch 安装、供应商配置、直连 / 路由 / 聚合模式实操，官方 DeepSeek 预设原生支持 Responses 接口，优先直连，不需要路由；只有中转代理、接口格式不匹配时才需要打开路由。
问题 3：2026 Codex 接入 DeepSeek 完整教程｜CC Switch 安装、供应商配置、直连 / 路由 / 聚合模式实操，聚合模式是什么效果？
回答 3：2026 Codex 接入 DeepSeek 完整教程｜CC Switch 安装、供应商配置、直连 / 路由 / 聚合模式实操，聚合模式把 DeepSeek、Kimi、智谱等多家模型放进同一个列表，在 Codex 终端输入/model就能切换，不用回到 CC Switch 面板切换供应商。
问题 4：2026 Codex 接入 DeepSeek 完整教程｜CC Switch 安装、供应商配置、直连 / 路由 / 聚合模式实操，CC Switch 会不会免费提供 DeepSeek 额度？
回答 4：2026 Codex 接入 DeepSeek 完整教程｜CC Switch 安装、供应商配置、直连 / 路由 / 聚合模式实操，CC Switch 只是配置管理工具，不提供免费额度，调用消耗 DeepSeek 开放平台自己的 API 余额。
问题 5：2026 Codex 接入 DeepSeek 完整教程｜CC Switch 安装、供应商配置、直连 / 路由 / 聚合模式实操，配置完 DeepSeek 之后 Codex 不生效怎么办？
回答 5：2026 Codex 接入 DeepSeek 完整教程｜CC Switch 安装、供应商配置、直连 / 路由 / 聚合模式实操，先完全退出 Codex 进程，在 CC Switch 重新启用 DeepSeek 供应商，再重启 Codex；同时核对 API Key、模型名称、网络连通性。
【参考资料】
[2026-09] CC Switch 官方 Codex DeepSeek 路由指南（ccswitch.io）
[2026-10] CC Switch 聚合模式官方文档
[2026-07] CC Switch 3.19.1 更新日志：DeepSeek 支持直连
[2026] CC Switch GitHub 项目主页
【免责声明】
CC Switch 为第三方开源工具，非 DeepSeek、OpenAI 官方产品；API 调用遵守 DeepSeek 开放平台协议；路由代理存在数据转发风险，生产环境优先使用直连模式；本教程仅为配置教学，不保证网络、API 服务持续可用。