CC Switch配置API接入Codex教程
想让 Codex 用上更便宜的 DeepSeek，但一看到要改配置文件就头大？
这篇就是写给你的。全程点鼠标，不用手写任何配置。做完之后，Codex 还是你熟悉的那个 Codex，只是它在背后调用的是 DeepSeek 的模型，花费会低不少。
预计 10 分钟，不需要懂代码。
先认识 4 个词（30 秒看完）
| 词 | 大白话解释 |
|---|---|
| Codex | OpenAI 出的 AI 编程助手，就是你正在用的这个 |
| DeepSeek | 国产大模型，写代码和写作都不错，API 价格比官方模型便宜很多 |
| CC Switch | 一个图形化小工具，帮你在多个「供应商」之间一键切换，不用自己改配置文件 |
| API Key | 调用 DeepSeek 的钥匙，一串以 sk- 开头的字符，相当于密码，不要给任何人 |
关于「协议」和「路由」，新手可以先不管
你可能会在别的教程里看到「Responses API」「Chat Completions」「本地路由」这些词，先别被吓到。
打个比方：Codex 说中文，DeepSeek 听英文，两个人直接对话听不懂。CC Switch 做的事情，就是站在中间当翻译。
这个「翻译」功能在第 3 步打开，照着点就行。想搞明白原理，看文末的进阶部分。
准备清单
开始之前先确认三样东西：
- 电脑上已经有能用的 Codex，命令行版或桌面版都行，并且成功打开过一次
- 有一个 DeepSeek 账号，并且账户里有余额
- 会下载安装软件（第 0 步会教）
第 0 步：安装 CC Switch
| 你的系统 | 怎么装 |
|---|---|
| Windows | 到 GitHub Releases 下载 CC-Switch-v3.20.3-Windows.msi，双击安装。不想安装就用 -Windows-Portable.zip 免安装版 |
| macOS | 打开「终端」输入 brew install --cask cc-switch，或者下载 .dmg 双击安装 |
| Linux | 下载 .deb、.rpm 或 .AppImage |
| Arch Linux | 输入 paru -S cc-switch-bin |
CC Switch 的官网是 ccswitch.io，也可以从官网进入下载页。界面支持简体中文，装完直接中文操作就行。
第 1 步：拿到 DeepSeek 的 API Key
1. 浏览器打开 platform.deepseek.com，注册并登录 2. 先充值：左侧菜单找到「充值」，充几块钱就够试很久（创建 Key 本身不要钱，但调用需要有余额） 3. 左侧菜单点「API Keys」 4. 点「创建新的 API Key」，随便起个名字 5. 把弹出的一串 sk- 开头的字符复制下来，先粘贴到记事本备用
⚠️ 这串 Key 只显示一次，关掉窗口就再也看不到，一定要先存好。
⚠️ 这串 Key 等于你的钱包，别人拿到就能花你的钱。不要发给任何人，也不要发到网上。
第 2 步：在 CC Switch 里添加 DeepSeek
打开 CC Switch，然后照着做：
1. 点界面顶部的「Codex」标签 2. 点右上角的「+」加号（添加供应商） 3. 在预设列表里找到「DeepSeek」并选中 4. 把第 1 步复制的 API Key 粘贴进去 5. 点保存
保存成功后，列表里会出现一张 DeepSeek 的卡片。
用预设的话，服务器地址、模型名这些都已经自动填好了，你只需要填 API Key。只有用自己找的中转服务，才需要展开「高级选项」自己填地址——新手建议直接用预设。
第 3 步：打开「路由」，让 CC Switch 接管 Codex
这一步就是打开前面说的「翻译功能」。
依次进入 设置 → 路由 → 本地路由，然后做两件事：
1. 打开「路由总开关」 2. 在下面的「路由启用」里，把「Codex」也打开
放心：你的 API Key 一直存在 CC Switch 里，由它在转发时自动带上，不会出现在 Codex 的配置里。
第 4 步：启用 DeepSeek，然后重启 Codex
1. 回到 CC Switch 的「Codex」页面 2. 点 DeepSeek 卡片上的「启用」 3. 完全关掉 Codex，命令行窗口、桌面版窗口都要关掉 4. 重新打开 Codex
重启这一步不能省。Codex 是启动时读配置的，不重启它还在用旧设置。
怎么确认成功了
- 在 Codex 里输入
/model，能看到 DeepSeek 的模型名
- 随便问一句「你好」，能正常回答
- 回到 CC Switch 的「路由」页面，看到请求数从 0 变成 1、2、3……
三条都对上，就是成功了。
出错了先看这里
| 你遇到的 | 怎么解决 |
|---|---|
| Codex 报 404，或提示找不到接口 | 第 3 步的「路由总开关」或「Codex 接管」没打开；也可能只是 Codex 没重启 |
| 提示 API Key 无效 / 未授权 | 检查 Key 有没有复制完整；检查 DeepSeek 账户里有没有余额 |
| 找不到 DeepSeek 的模型 | 回到第 4 步确认点了「启用」，然后彻底重启 Codex |
| 桌面版 Codex 看不到 DeepSeek 模型 | 看下面「用桌面版 Codex」那一节 |
| 完全没反应 | 确认 CC Switch 还开着（关掉它路由就停了），再重启 Codex 试一次 |
新手最常问的
| 问题 | 回答 |
|---|---|
| 会不会很贵？ | 不会。DeepSeek 比官方模型便宜很多，充几块钱能试很久 |
| 会不会影响我原来的 ChatGPT / Codex 账号？ | 只是换模型不会影响。但想保留官方插件和手机远程操作，需要先开一个开关，见下一节 |
| 以后想换回官方模型怎么办？ | 在 CC Switch 里点官方那条的「启用」，重启 Codex 就切回来了 |
| 我英文不好，界面看得懂吗？ | CC Switch 支持简体中文，设置里能切换语言 |
| 一定要会用命令行吗？ | 不用。只有「重启 Codex」和看一眼 /model 涉及，其余全是点鼠标 |
| CC Switch 要一直开着吗？ | 要，或者让它常驻系统托盘。路由服务由它启动，退出程序后 Codex 就发不出请求了 |
用桌面版 Codex，或想保留官方插件 / 手机远程操作
Codex 桌面版的模型选择器会看你有没有官方登录。如果切到 DeepSeek 之前没做处理，它会把自定义模型藏起来，选择器里只剩官方默认模型。
解决办法是在切换之前先打开一个开关：
1. 先正常登录一次官方 ChatGPT / Codex，免费账号就行 2. 在 CC Switch 打开 设置 → 通用 → Codex 应用增强 → 切换第三方时保留官方登录，这个开关默认是关的 3. 然后再做上面的第 2 到第 4 步 4. 完全退出并重新打开 Codex
开了这个开关之后，CC Switch 会把你的官方登录保留下来，同时把 DeepSeek 的 Key 写进配置。官方登录信息不会被发给 DeepSeek，你的请求还是走 DeepSeek。
如果你已经按前面的步骤做完了、结果桌面版看不到 DeepSeek，也不用慌：切回官方那条 → 重启并重新登录一次 → 打开上面的开关 → 再切回 DeepSeek 就好了。
小提示：官方登录态太久不用会过期。真遇到模型又不见了，重新登录一次官方账号即可恢复。
---
下面是进阶内容，新手可以先跳过，不影响使用。
进阶：为什么需要「路由」
Codex 说的是 OpenAI 的 Responses API，而 DeepSeek 这类供应商很多只提供 OpenAI 的 Chat Completions 接口。两者的请求格式和返回格式都不一样，直接把地址填进 Codex 就会报错。
CC Switch 的做法是在中间加一层本地路由，把 Codex 发出的 Responses 请求改写成 Chat 请求发给上游，再把上游的回复转换回 Responses 格式还给 Codex：
| 步骤 | 发生了什么 |
|---|---|
| 1 | 接管后，Codex 的配置被指向本机 http://127.0.0.1:15721/v1，并保持 wire_api = "responses" |
| 2 | 供应商的 meta.apiFormat = "openai_chat" 告诉路由：真实上游是 Chat 格式 |
| 3 | 路由把 /responses 改写成 /chat/completions，同时转换请求体 |
| 4 | 上游返回后，路由再把结果转成 Codex 能读的格式 |
如果供应商本身原生支持 Responses，上面第 2 到第 4 步就不会发生，请求直连上游。
进阶：什么时候其实不用开路由
这里有个版本分水岭：CC Switch 3.19.1 起，DeepSeek 预设已经改成原生 Responses 直连，这时候新建的 DeepSeek 供应商不开路由也能用。下面这些情况才必须开：
| 你的情况 | 需要路由吗 | 说明 |
|---|---|---|
| 3.19.1 之前保存的 DeepSeek 供应商 | 需要 | 预设的改动只影响新建的供应商，旧的会原样保留 |
| 3.19.1 之后用预设新建的 DeepSeek | 不需要 | 直连 api.deepseek.com，并使用 DeepSeek 官方的模型目录 |
想用 deepseek-v4-pro | 需要 | DeepSeek 官方还没给这个模型开通 Codex 集成，直连会报错 |
怎么判断自己属于哪种？看供应商卡片上有没有 需要路由 徽章：
- 有
需要路由徽章：属于 Chat 格式，必须开路由
- 没有徽章：已经是直连，路由步骤可以省略
- 有
不支持路由徽章：这是官方供应商，CC Switch 会阻止它走路由
另外，Kimi、智谱 GLM、SiliconFlow、ModelScope 等供应商目前大多还是 Chat 格式，流程和上面的路由部分一样，把 DeepSeek 换成对应预设即可。
进阶：用量统计会变
供应商改走直连后，请求不再经过本地路由，代理的「按请求统计用量」就看不到它了。
用量本身不会丢，Codex 的会话日志导入照常记录，但这些请求会统一归到 Codex (Session) 里。想区分具体是谁，看模型：每条记录都带模型 ID，用量面板的「模型统计」是按模型分行列的。
需要按供应商对账的话，就保持「上游格式」为 Chat 并开着路由。
进阶：其他常见报错
| 现象 | 处理 |
|---|---|
Codex 报 404，找不到 /responses | 没开 Codex 接管，或手动把上游 Chat 地址直接写给了 Codex。检查 ~/.codex/config.toml 是否指向 http://127.0.0.1:15721/v1 |
| 上游报 404 | 用预设的先确认供应商确实来自预设、Codex 路由已启用；自定义供应商才需要检查 base URL |
切到 deepseek-v4-pro 后上游报错 | 官方尚未为该模型开通 Codex 集成。把上游格式改回 Chat Completions（需开启路由） 并开启路由，或改用 deepseek-v4-flash |
/model 看不到模型 | 重启 Codex。CC Switch 会生成 cc-switch-model-catalog.json，运行中的进程不一定热加载 |
| 开了路由但请求走错供应商 | 核对三处：Codex 标签下的当前供应商、本地路由服务是否在运行、路由启用里 Codex 是否打开 |
| 能用官方账号走本地路由吗 | 不建议。用代理访问官方 API 有账号风险，CC Switch 在接管模式下会阻止切到官方供应商 |
参考链接
- CC Switch 官网：https://ccswitch.io
- CC Switch GitHub 仓库：https://github.com/farion1231/cc-switch
- 官方攻略：在 Codex 中用 DeepSeek 这类 Chat 格式 API
- 官方攻略：使用第三方 API 时保留 Codex 远程操作和官方插件
- 官方攻略：Codex 桌面应用里看不到自定义模型？
- DeepSeek 官方 Codex 接入文档：https://api-docs.deepseek.com/quick_start/agent_integrations/codex/
一句话总结
装好 CC Switch → 拿到 DeepSeek 的 API Key → 在 CC Switch 里选 DeepSeek 预设并填 Key → 打开路由并接管 Codex → 点「启用」再重启 Codex。全程点鼠标，不用写配置文件；想保留官方插件和手机远程操作，切换之前先打开「切换第三方时保留官方登录」。
