要将 DeepSeek 接入 OpenAI Codex，核心在于解决两者之间的协议不兼容问题：Codex 原生使用的是 OpenAI 的Responses API协议，而 DeepSeek 官方兼容的是Chat Completions API。因此，我们需要借助CCX作为协议转换网关，并配合CC Switch来便捷地切换 Codex 的配置。
以下是详细的保姆级配置教程：
🛠️ 第一步：准备工作
在开始之前，请确保你已经准备好以下环境和资源：
- Node.js 环境：Codex 依赖 Node.js 运行，请确保已安装（建议 LTS 版本）。
- DeepSeek API Key：前往 DeepSeek 开放平台 注册并创建 API Key，建议提前充值少量金额（如10元）以便测试。
- 下载核心工具：
- CCX（协议转换网关）：前往 GitHub Releases 页面下载对应系统的版本（Windows 用户下载
.exe文件）。 - CC Switch（配置管理工具）：前往 GitHub Releases 页面下载并安装。
- CCX（协议转换网关）：前往 GitHub Releases 页面下载对应系统的版本（Windows 用户下载
⚙️ 第二步：配置 CCX 中转服务
CCX 的作用是将 Codex 发出的Responses协议请求，翻译成 DeepSeek 能听懂的Chat Completions协议。
- 创建配置文件：
在你下载的ccx.exe同级目录下，新建一个名为.env的文件（注意没有后缀名），填入以下内容： - 注：
*PROXY_ACCESS_KEY** 是你访问 CCX 的密码，这里暂设为*123456*。* - 启动 CCX：
双击运行ccx.exe。启动成功后，终端会显示 API 地址（通常为http://localhost:3000/v1）。 - 在网页端添加 DeepSeek 渠道：
- 打开浏览器访问
http://localhost:3000，输入刚才设置的密码123456登录管理面板。 - 点击左侧的Codex选项卡，然后点击“+ 添加渠道”。
- 填写基础信息：
- Base URL：
https://api.deepseek.com - API Key：填入你从 DeepSeek 官网获取的 API Key。
- Base URL：
- 关键步骤（协议转换）：
添加渠道后，点击该渠道的“编辑”或“详细配置”。找到“服务类型 (Service type)”选项，**必须将其从默认的**Responses (Codex)**修改为 ****OpenAI Chat**。
原因：DeepSeek 官方兼容的是*/v1/chat/completions*接口，如果不修改，会导致请求路径错误（走向*/v1/responses*）从而报错。 - 保存配置，确保该渠道状态显示为“正常运行”。
- 打开浏览器访问
🔄 第三步：使用 CC Switch 切换 Codex 配置
CC Switch 的作用是告诉 Codex：“不要直接去连 OpenAI 官方了，改道去连我们本地搭建的 CCX 代理”。
- 打开 CC Switch：
启动安装好的 CC Switch 软件。 - 添加自定义配置：
- 在左侧应用列表中选择Codex。
- 点击右侧的“+”号（或添加供应商），选择“自定义配置”。
- 填入代理信息：
- 供应商名称：随意填写，例如
Local-DeepSeek。 - API Key：填入你在 CCX
.env文件中设置的PROXY_ACCESS_KEY（即123456）。 - API 请求地址 (Base URL)：填入
http://localhost:3000/v1。
- 供应商名称：随意填写，例如
- 激活配置：
保存后，在 CC Switch 主界面选中刚才创建的Local-DeepSeek配置，点击“激活 (Enable)”。
✅ 第四步：验证与使用
- 打开终端（CMD 或 PowerShell），输入
codex启动 Codex。 - 随便发送一条编程相关的指令，例如：“帮我写一个 Python 的 Hello World”。
- 如果 Codex 能够正常返回代码并执行，说明整套链路已经打通。
💡 常见问题排查：
- 遇到 404 报错：99% 的情况是因为在 CCX 中添加渠道时，忘记将“服务类型”切换为
OpenAI Chat。 - Codex 无法启动：请检查 Node.js 是否正确安装，可以尝试在终端输入
node -v验证。 - 费用问题：该方案走的是 DeepSeek 的官方 API 计费，由于 DeepSeek 价格极低，日常编码使用成本几乎可以忽略不计。
