Codex接入DeepSeek实战：DeepSeek + CCX 完整部署教程

Codex接入DeepSeek实战：DeepSeek + CCX 完整部署教程

自从 OpenAI 推出 Codex CLI 之后，越来越多开发者开始使用它进行代码编写、项目开发、代码重构以及自动化运维工作。

codexcli.png

但对于国内用户来说，使用官方 Codex 往往会遇到几个问题：

  • 需要 ChatGPT 账号
  • 部分地区注册困难
  • 需要稳定的国际网络环境
  • 官方模型使用成本较高
  • GPT Plus 或 API 存在持续开销
  • 通过开源项目 CCX（Codex Compatible eXchange），可以将 Codex 的请求转发到 DeepSeek，实现：

✅ 无需 ChatGPT 账号

✅ 无需科学上网

✅ 国内网络直接使用

✅ 使用 DeepSeek API 代替 OpenAI 模型

✅ 成本远低于官方方案

  • 本教程将详细介绍实现原理、部署流程以及常见问题解决方案。

一、整体架构原理

很多人认为 Codex 只能连接 OpenAI 官方服务器。

实际上 Codex 本质上只是一个客户端。

真正完成代码生成的是后端大模型。

整体流程如下：

1
2
3
4
5
6
7
8
9
10
11
Codex
   ↓
CCX 本地网关
   ↓
DeepSeek API
   ↓
返回结果
   ↓
CCX 转换协议
   ↓
Codex 显示结果

其中：

Codex

负责：

  • 代码编辑
  • AI 对话
  • 文件分析
  • 项目操作

CCX

负责协议转换。

由于 OpenAI 最近更新了 Codex 的通信协议，很多兼容 OpenAI API 的国产模型无法直接接入。

CCX 的作用就是：

  • 接收 Codex 请求
  • 转换成 DeepSeek 能识别的格式
  • 发送给 DeepSeek
  • 将返回结果再次转换
  • 返回给 Codex

因此 CCX 可以理解成：

Codex 与 DeepSeek 之间的“翻译官”。

二、准备工作

开始前需要准备以下内容：

1. Windows 10/11 系统

推荐：

  • Windows 10 22H2
  • Windows 11

2. DeepSeek 账号

注册：

DeepSeek 开放平台

https://platform.deepseek.com/

使用手机号即可注册。

3. 充值余额

首次使用建议充值：

1
10 元

足够测试和轻度开发使用。

三、创建 DeepSeek API Key

登录 DeepSeek 开放平台后：

进入：

1
API Keys

点击：

1
Create API Key

系统会生成类似：

1
sk-xxxxxxxxxxxxxxxx

的重要密钥。

⚠ 注意：

API Key 仅显示一次。

一定要立即保存。

关闭页面后无法再次查看，只能重新创建。

四、安装 Codex

官方下载地址：

https://chatgpt.com/zh-Hans-CN/codex/

下载后运行安装程序。

安装器会自动调用：

1
Microsoft Store

完成 Codex 安装。

常见问题

一直下载失败

原因：

微软商店与代理环境冲突。

解决：

安装前先关闭：

  • VPN
  • Clash
  • V2Ray
  • Surge
  • 其他代理软件

然后重新安装。

通常即可解决。

五、安装 CCX

项目地址：

https://github.com/BenedictKing/ccx

进入 Releases 页面下载最新版。

安装完成后启动 CCX。

六、配置 DeepSeek 渠道

打开 CCX。

进入：

1
渠道中心

新增渠道：

1
DeepSeek

填写：

API Key

1
sk-xxxxxxxx

保存。

测试连接成功后继续下一步。

七、配置 Codex 接入 CCX

打开 CCX。

进入：

1
管理界面

找到：

1
Codex 配置

或：

1
Agent Provider

将默认提供商修改为：

1
CCX Local Gateway

保存配置。

此时连接关系变为：

1
2
3
4
5
Codex
  ↓
CCX
  ↓
DeepSeek

八、启动验证

正确启动顺序：

第一步

启动 CCX

确认状态：

1
Running

第二步

启动 Codex

如果进入正常界面：

1
Welcome to Codex

说明已经配置成功。

九、模型映射机制

很多人会发现：

Codex 模型菜单中没有：

  • DeepSeek-Pro
  • DeepSeek-Flash

这是因为 Codex 仍然显示 OpenAI 模型名称。

实际映射由 CCX 完成。

默认规则如下：

Codex 显示 实际调用
GPT-5.4 DeepSeek Pro
GPT-5.5 DeepSeek Pro
GPT-5.4 Mini DeepSeek Flash

因此：

你选择 GPT-5.5

实际上调用的是：

1
DeepSeek Pro

自定义映射

进入：

1
2
3
4
CCX
→ 管理界面
→ Codex
→ 模型重定向

可以自由修改。

例如：

1
2
3
GPT-5.5
↓
DeepSeek Flash

实现更低成本运行。

十、常见问题汇总

问题一：CCX 被 Windows 拦截

现象：

1
Windows 已保护你的电脑

原因：

开源软件没有购买微软数字签名证书。

解决：

点击：

1
2
更多信息
→ 仍要运行

即可。

问题二：安全中心报毒

现象：

1
检测到威胁

原因：

CCX 会监听本地端口。

被 Defender 误报。

解决：

1
2
允许在设备上使用
→ 执行操作

即可。

问题三：Codex 打开白屏

解决步骤：

方法一

重启电脑

方法二

按顺序启动

1
2
先启动 CCX
再启动 Codex

多数情况下可以恢复。

问题四：无法连接 DeepSeek

检查：

API 是否正确

1
sk-xxxx

账户是否有余额

进入：

DeepSeek 控制台查看。

网络是否正常

测试：

1
https://platform.deepseek.com

是否可访问。

十一、性能与成本对比

方案 是否需要 GPT 账号 是否需要国际网络 使用成本
官方 Codex 是 是 较高
Codex + OpenAI API 是 是 中等
Codex + CCX + DeepSeek 否 否 最低

对于国内开发者来说：

Codex + DeepSeek 方案目前是成本最低、部署最简单的替代方案之一。

十二、优缺点分析

优势

  • 国内直接访问
  • 无需 GPT 账号
  • 部署简单
  • 成本低
  • 支持 DeepSeek 最新模型
  • 本地网关可扩展

不足

  • 依赖第三方 CCX 项目
  • OpenAI 更新协议后可能需要等待 CCX 适配
  • 部分高级能力与官方模型存在差异
  • DeepSeek 返回速度受接口负载影响

总结

通过 CCX 本地网关，可以让 Codex 摆脱对 OpenAI 官方服务的依赖，直接接入 DeepSeek 等国产大模型。

整个方案的核心思路并不复杂：

1
2
3
4
5
Codex
↓
CCX（协议转换）
↓
DeepSeek API

部署过程只需：

1、申请 DeepSeek API Key

2、安装 Codex

3、安装并配置 CCX

完成后即可在国内网络环境下直接使用 Codex 编程，既不需要 ChatGPT 账号，也无需额外的网络环境支持，同时还能大幅降低 AI 编程成本。

对于希望体验 Codex、又不想承担 OpenAI 使用门槛和费用的开发者来说，这是目前非常值得尝试的一套方案。