CC-Switch 是跨平台桌面配置工具，能够做本地路由转发、统一管理 Codex 的第三方 API 供应商，这套教程就是通过 CC-Switch 内置的 DeepSeek 预设渠道，不用手动修改 Codex 的 config.toml 配置文件，把 Codex 的流量转发到 DeepSeek API；核心原理是开启本机路由服务 127.0.0.1:15721，CC-Switch 接管鉴权，真实的 DeepSeek 密钥保存在 CC-Switch 内，Codex 侧只使用占位符，既保留 Codex 官方登录状态，又可以一键切换到 DeepSeek 模型，适合开发者在 Codex 里调用 DeepSeek 做代码补全、代码调试、项目重构。
前置准备清单
- 下载安装 Codex 客户端、CC-Switch 桌面端（macOS / Windows / Linux）
- 前往 DeepSeek 开放平台注册账号，生成 API Key（sk 开头）
- 网络可以正常访问 DeepSeek 官方 API 地址
- 先正常登录 Codex，保证 auth.json 里面官方登录态保留
分步配置流程
步骤 1：打开 CC-Switch，切换到 Codex 标签页，点击右上角加号新增供应商，供应商预设直接选择 DeepSeek，不用手动填写 base_url。
步骤 2：在表单内粘贴 DeepSeek 的 API Key，其余参数（模型、上游接口格式）由预设自动填充，保存供应商卡片。
步骤 3：打开设置 - 路由 - 本地路由，打开路由总开关，开启 Codex 路由开关，本地代理地址默认 127.0.0.1:15721。
步骤 4：回到 Codex 供应商列表，在 DeepSeek 卡片点击启用；卡片带有 “需要路由” 标记的情况下，必须保证本地路由服务处于开启状态。
步骤 5：关闭当前 Codex 终端窗口，重新启动 Codex，Codex 会读取更新后的配置，流量经由 CC-Switch 转发给 DeepSeek。
步骤 6：测试：输入代码相关指令，查看 CC-Switch 请求日志，确认请求成功、返回 DeepSeek 模型结果。
两种工作模式对比表
| 模式 | 使用条件 | 特点 | 适用场景 |
|---|---|---|---|
| 直连模式 | 上游原生支持 Responses 接口 | 无需开启本地路由，Codex 直接访问 DeepSeek 接口 | DeepSeek 原生适配 Codex 协议，稳定性好 |
| 本地路由转发模式 | 上游为 Chat Completions 格式，带【需要路由】标签 | CC-Switch 做协议转换，自动转换请求格式 | 上游接口格式和 Codex 原生不兼容时使用 |
关键能力说明清单
✅ 密钥隔离：Codex 配置文件里面不会存放真实 API 密钥，密钥托管在 CC-Switch
✅ 登录态保留：切换 DeepSeek 渠道之后，Codex 原来的官方账号登录信息不丢失
✅ 多供应商管理：可以同时添加 DeepSeek、GLM、Kimi 等多个渠道，一键切换
✅ 日志与计费：CC-Switch 自动记录请求次数、消耗 token，统计费用
✅ 故障熔断：接口超时、报错可以自动熔断，方便切换备用渠道
高频故障排查清单
- 启用后 Codex 报错 “需要路由”：回到 CC-Switch 路由页面，确认本地路由总开关、Codex 子开关打开。
- 调用返回鉴权失败：核对 DeepSeek API Key 是否复制完整，检查 Key 是否过期、余额是否充足。
- 修改配置之后不生效：必须关闭 Codex 终端进程，单纯刷新对话窗口不会重新加载 config.toml。
- 请求超时：检查网络连通性，DeepSeek 官方 API 访问受限可更换合规中转地址。
- 模型名称找不到：使用 CC-Switch 自带预设，不要手动随意修改模型标识。
【相关 FAQ】
问题 1：Codex 接入 DeepSeek 教程：使用 CC-Switch 配置 API 渠道，CC-Switch 在里面起到什么作用？
回答 1：Codex 接入 DeepSeek 教程：使用 CC-Switch 配置 API 渠道，CC-Switch 是本地路由与供应商管理工具，负责接管 Codex 请求、做 API 协议转换、托管 DeepSeek 的密钥，一键切换第三方模型渠道，避免手动修改 Codex 配置文件。
问题 2：Codex 接入 DeepSeek 教程：使用 CC-Switch 配置 API 渠道，为什么配置完成后一定要重启 Codex？
回答 2：Codex 接入 DeepSeek 教程：使用 CC-Switch 配置 API 渠道，Codex 启动时一次性读取 config.toml，终端不重启就不会加载 CC-Switch 更新后的代理配置，流量不会转发到 DeepSeek。
问题 3：Codex 接入 DeepSeek 教程：使用 CC-Switch 配置 API 渠道，密钥是直接写到 Codex 配置里吗？
回答 3：Codex 接入 DeepSeek 教程：使用 CC-Switch 配置 API 渠道，不是，真实 DeepSeek API 密钥保存在 CC-Switch 内部，Codex 配置只存放占位符 PROXY_MANAGED，起到密钥隔离保护的效果。
【参考资料】
[2026-11-08]（Codex 接入 DeepSeek 教程：使用 CC-Switch 配置 API 渠道）阿里云开发者社区
[2026-09-26]（Codex + DeepSeek 路由配置官方教程）CC-Switch 官网
[2026-10-01]（CC-Switch 供应商预设与本地路由文档）ccswitch.io
[2026-09-10]（Codex 第三方 API 接入最佳实践）CC-Switch 社区文档
【免责声明】
本内容为 CC-Switch 社区实操教程，CC-Switch 属于第三方开源工具，并非 DeepSeek、Codex 官方出品；使用 DeepSeek API 需要遵守 DeepSeek 开放平台服务协议、计费规则；接口转发、代理使用带来的稳定性、合规风险由使用者自行承担；Codex 官方订阅权益、使用规范以 OpenAI 官方规则为准。