一、教程背景（文章底部有全部文件）

Codex 是 OpenAI 推出的终端 AI 编程助手，可以在命令行里帮你写代码、改项目、解释报错。

不过，直接使用 OpenAI 官方接口通常会受到额度、价格或访问条件限制。本文介绍一种更低成本的使用方式：通过 ccx 搭建本地代理，再用 cc-switch 把 Codex 的 API 请求切换到这个代理，最后由 ccx 转发到 DeepSeek。

简单理解：

• Codex：负责提供终端 AI 编程体验
• cc-switch：负责切换 Codex 的 API 配置
• ccx：负责把 Codex 请求转发给 DeepSeek
• DeepSeek：实际提供模型能力

DeepSeek API 价格较低，日常写代码、问问题、改文档，通常成本很低。具体价格以 DeepSeek 官方平台实时展示为准。

二、安装 Node.js

Codex CLI 依赖 Node.js 运行，所以第一步需要先安装 Node.js。

1. 打开 Node.js 官网：

   https://nodejs.org/

2. 下载 LTS 版本，也就是长期支持版。

3. 安装时一路默认下一步即可。

4. 安装完成后，打开 PowerShell 或 CMD，输入：

   node -v
   npm -v
   

如果两个命令都能显示版本号，说明 Node.js 和 npm 已经安装成功。

三、安装 Codex CLI

打开 PowerShell 或 CMD，执行：

npm install -g @openai/codex

安装完成后，输入：

codex

第一次运行会提示登录 OpenAI 账号，按提示操作即可。

如果过程中跳转应用商店，或者安装流程不顺，可以使用网盘资料里准备好的完整版 Codex 文件，按文件内说明操作。

注意：OpenAI 注册和登录可能需要手机号验证。请尽量使用自己可长期控制的手机号或合规方式完成验证，不建议把重要账号绑定到来路不明的临时号码上。

四、安装 cc-switch

cc-switch 是 Codex 的配置切换工具，后面需要用它把 Codex 的接口地址改成 ccx 本地代理地址。

执行安装命令：

npm install -g cc-switch

安装完成后先不用配置，等 ccx 设置好以后再回来操作。

五、安装并启动 ccx

ccx 是这套方案的核心，它相当于一个本地 API 代理网关。

如果你已经下载了教程配套文件，直接双击打开 ccx 启动文件即可。启动后，在 CMD 窗口里找到类似下面的信息：

API 地址: http://localhost:3000/v1
访问密钥: your-proxy-access-key

然后在浏览器中打开：

http://localhost:3000

进入 ccx 管理页面后，使用访问密钥登录：

your-proxy-access-key

建议登录后先把右上角语言切换为中文，方便后续配置。

六、添加 DeepSeek 渠道

进入 ccx 后，选择 Codex 相关配置，然后添加新的渠道。

添加渠道时填写：

API 地址：https://api.deepseek.com
API Key：填写你自己的 DeepSeek API Key

这里有一个非常关键的设置：

默认添加的渠道服务类型可能是：

Responses (Codex)

但 DeepSeek 官方兼容的是 OpenAI Chat 接口，也就是：

/v1/chat/completions

所以添加 DeepSeek 渠道时，一定要点开右上角的详细配置，把服务类型改成：

OpenAI Chat

如果这里没有改，ccx 可能会请求：

/v1/responses

而 DeepSeek 不支持这个接口，就会导致 Codex 报错。

配置完成后保存渠道。

七、获取 DeepSeek API Key

1. 打开 DeepSeek 开放平台：

   https://platform.deepseek.com/

2. 注册或登录账号。

3. 进入 API Keys 页面。

4. 点击创建 API Key。

5. 复制并保存好 Key。

API Key 通常只显示一次，建议单独保存到安全位置，不要发给别人。

DeepSeek 支持支付宝或微信充值，日常测试和轻度使用可以先小额充值，例如 10 元。

八、用 cc-switch 切换 Codex 配置

ccx 配好后，回到 cc-switch。

点击 OpenAI 图标，然后点击右侧加号，添加一个自定义配置。

填写内容如下：

供应商名称：自定义填写，例如 DeepSeek-CCX
API Key：your-proxy-access-key
API 请求地址：http://localhost:3000/v1

这里的 API Key 不是 DeepSeek 的 Key，而是 ccx 的访问密钥。

也就是说：

• DeepSeek API Key 填在 ccx 渠道里
• cc-switch 里填 ccx 的访问密钥
• Codex 请求先到 ccx，再由 ccx 转发给 DeepSeek

保存后，切换到这个自定义配置。

九、验证是否配置成功

重新打开一个 PowerShell 或 CMD，输入：

codex

然后随便问一个问题，例如：

帮我写一个 JavaScript Hello World

如果 Codex 能正常回答，说明整条链路已经打通：

Codex CLI -> cc-switch 配置 -> ccx 本地代理 -> DeepSeek API

十、常见问题

1. ccx 和 cc-switch 有什么区别？

ccx 是代理网关，负责把请求转发给 DeepSeek。

cc-switch 是配置切换工具，负责让 Codex 使用 ccx，而不是直接连接 OpenAI 官方接口。

2. 为什么添加 DeepSeek 渠道后会报错？

重点检查服务类型是否选错。

DeepSeek 应该选择：

OpenAI Chat

不要使用：

Responses (Codex)

因为 DeepSeek 支持的是：

/v1/chat/completions

不是：

/v1/responses

3. cc-switch 里的 API Key 应该填哪个？

填 ccx 的访问密钥，例如：

your-proxy-access-key

不要填 DeepSeek API Key。

DeepSeek API Key 应该填在 ccx 的渠道配置里。

4. DeepSeek API Key 要不要保密？

一定要保密。

谁拿到你的 DeepSeek API Key，谁就可以消耗你账户里的余额。

5. DeepSeek 效果怎么样？

日常写代码、改脚本、解释报错、生成文档基本够用。

如果是特别复杂的架构设计、长上下文推理或高难度代码审查，效果可能和顶级 GPT 模型有差距，但胜在价格非常低。

十一、组件作用总结

组件	作用	说明
Node.js	运行环境	Codex CLI 依赖 Node.js
Codex CLI	终端 AI 编程助手	在命令行里使用 AI 写代码
cc-switch	配置切换工具	切换 Codex 使用的 API 地址
ccx	本地代理网关	把 Codex 请求转发到 DeepSeek
DeepSeek	大模型服务	提供实际的模型能力

十二、配套文件

通过网盘分享的文件：codex注册部署+接入deepseek
链接: https://pan.baidu.com/s/1jtzWiW0u8P8A0f0xpZVMag?pwd=qhmn

提取码：

qhmn

总结

这套方案的核心思路就是：

用 Codex CLI 保留原来的终端 AI 编程体验，再通过 cc-switch 和 ccx 把接口切换到 DeepSeek，从而实现更低成本的日常使用。

最容易出错的地方只有两个：

1. DeepSeek 渠道服务类型必须选 OpenAI Chat
2. cc-switch 里的 API Key 填 ccx 访问密钥，不是 DeepSeek API Key

只要这两点配置正确，基本就可以正常使用。