一句话理解
通过 ccx 把 DeepSeek 的接口”翻译”成 Codex 能识别的格式,再用 cc switch 一键切换,国内直连无需翻墙。
整体流程
第1步:准备 DeepSeek API Key
↓
第2步:安装 ccx(接口转换)
↓
第3步:安装 cc switch(一键切换)
↓
🎉 Codex + DeepSeek 就能用了
为什么选 DeepSeek?
| 优势 | 说明 |
|---|---|
| 💰 便宜 | 其他国内大模型单价太贵,套餐要靠抢 |
| ✅ 体验好 | 实际使用效果良好,Agent 能力够用 |
| 🎁 新用户额度 | 注册后有一千万 token 免费额度 |
DeepSeek 官网:https://platform.deepseek.com/usage
第1步:准备 DeepSeek API Key
1.1 注册账号
注册并完成实名认证。
1.2 充值
充值 10 元测试即可(新用户有一千万 token 免费额度,不充值也能用)。
1.3 创建 API Key
在控制台创建 API Key,复制保存。

⚠️ API Key 只显示一次,丢了只能重新创建。
第2步:安装 ccx
ccx 的作用:把 DeepSeek 的接口转换成 Codex 能识别的 OpenAI 兼容格式。
2.1 下载
👉 ccx 最新版
在 Release 页面下载对应系统的可执行文件。Windows 用户下载:CCX-Desktop-2.8.19-windows-amd64-setup.exe

2.2 配置
在可执行文件同目录创建 .env 文件。
💡 如果看不到文件扩展名,需要先开启”显示扩展名”:

.env 文件内容如下:
PROXY_ACCESS_KEY=your-proxy-access-key
PORT=3000
ENABLE_WEB_UI=true
APP_UI_LANGUAGE=zh-CN

| 配置项 | 说明 |
|---|---|
PROXY_ACCESS_KEY | 你自己设的密钥,填在 cc switch 里用的,不是 DeepSeek 的 Key |
PORT | ccx 运行端口,默认 3000 |
ENABLE_WEB_UI | 开启管理界面 |
APP_UI_LANGUAGE | 界面语言 |
2.3 启动
运行 ccx,浏览器访问 http://localhost:3000,输入 .env 里的 PROXY_ACCESS_KEY 登录。

2.4 添加渠道
- 切换到 Codex 菜单

- 点击 添加渠道 → 详细配置

- 按下表填写:
| 配置项 | 填什么 |
|---|---|
| 服务类型 | OpenAI Chat |
| 基础 URL | https://api.deepseek.com/v1 |
| API 密钥 | DeepSeek 控制台的 Key |
| 规范化非常见 Chat role | ✅ 勾选 |

- 创建渠道,测试时选择目标模型名,能出模型列表就说明配置正确 ✅

第3步:安装 cc switch
cc switch 的作用:在 Codex 里一键切换不同的模型配置,不用手动改设置。
3.1 下载
直接下载 Release 版本即可。
3.2 配置
- 打开软件,切换到 Codex


- 点击 + 号添加配置

- 填写:
| 配置项 | 填什么 |
|---|---|
| 地址 | http://localhost:3000/v1 |
| API Key | ccx 里设置的 PROXY_ACCESS_KEY(不是 DeepSeek 的 Key) |

⚠️ 这里的 Key 是 ccx 的
PROXY_ACCESS_KEY,别填错了。
最后检验是否成功
打开 Codex,确认模型列表中能看到 DeepSeek 的模型:

选择模型后发送一条消息测试,能正常回复就说明配置成功 🎉

常见问题
Q:ccx 启动后无法访问?
检查端口是否被占用,在 .env 里把 PORT 改成其他值(如 3001)。
Q:模型列表出不来?
按顺序检查:
- DeepSeek API Key 是否正确
- 基础 URL 是否填的
https://api.deepseek.com - ccx 是否已启动并登录
Q:cc switch 连不上?
确保 ccx 已启动,地址和 Key 填写正确。地址是 http://localhost:3000/v1,Key 是 ccx 的 PROXY_ACCESS_KEY。
Q:两个 Key 怎么区分?
| Key | 哪来的 | 填在哪 |
|---|---|---|
| DeepSeek API Key | DeepSeek 控制台 | ccx 的渠道配置里 |
| PROXY_ACCESS_KEY | 你自己在 .env 里设的 | cc switch 的配置里 |