前言

Codex是OpenAI推出的终端AI编程助手，凭借强大的代码理解和生成能力受到广大开发者喜爱。但由于Codex原生依赖海外模型，国内开发者直接使用时往往会遇到网络环境不佳、接口配置复杂等问题。

今天带来一套简单实用的解决方案——通过CC-Switch将Codex接入DeepSeek大模型API。CC-Switch是一个图形化配置工具，可以统一管理Codex、Claude Code、Gemini CLI等AI编程工具的模型配置。你只需要在界面里填好API地址、API Key和模型名称，然后点击启用即可，全程几分钟就能完成。本文将以图文并茂的形式，带你从零开始完成配置，即使是小白也能轻松上手。

为什么选择DeepSeek？

• 国内直连：API域名国内可直接访问，无需额外网络配置

• 性价比高：DeepSeek输入价格仅为¥1/百万token，输出价格为¥2/百万token，大约是GPT-4o的1/18

• 兼容性好：兼容OpenAI Chat Completions协议，可直接对接各类工具

• 中文能力强：针对中文场景优化，代码能力表现优异

一、环境准备

在开始配置之前，请确保以下准备工作已完成。

1.1 安装Codex CLI

如果你还没有安装Codex，可以通过以下方式获取：

• 前往Codex官网或在微软商店搜索Codex下载

• 安装完成后，在终端输入codex --version确认安装成功

1.2 安装CC-Switch

CC-Switch是本次配置的核心工具。下载并安装最新版本即可。

Releases · farion1231/cc-switch

没看到Windows版本就点击下方的展开

提示：CC-Switch 3.16.0及以上版本对DeepSeek等第三方模型接入支持更好。

1.3 获取DeepSeek API Key

1. 访问DeepSeek开放平台，使用手机号注册账号

2. 注册后需进行实名认证，个人开发者选择「个人认证」，上传身份证信息，通常几分钟内通过

3. 进入左侧导航栏「API Keys」页面，点击「创建API Key」

4. 输入一个便于记忆的名称，点击创建后得到一个以sk-开头的密钥

⚠️ 重要提示：API Key仅在创建时完整显示一次，关闭弹窗后将无法再次查看。请务必将它复制并保存到安全的地方，建议使用密码管理工具或记在本地记事本中。

1.4 DeepSeek充值

DeepSeek采用预付费模式。首次使用时建议充值¥10-20，足够个人开发者长期使用了。进入充值页面，支付宝或微信扫码即可完成。新用户通常会有赠送额度。

二、为什么要用CC-Switch？

在开始配置之前，有必要先了解背后的技术原理，这样遇到问题更容易排查。

Codex（0.81.0及以上版本）原生使用的是OpenAI Responses API（/v1/responses端点），而DeepSeek对外统一提供的是Chat Completions接口（/chat/completions端点）。这两种协议存在明显差异：请求体的字段结构与语义不同，流式传输中的SSE事件命名和数据结构也不一样。

如果把Chat格式的base URL直接填进Codex配置中，常见的报错包括：

• 模型列表加载异常

• 接口返回404或400

• 流式响应无法被Codex正确解析

CC-Switch的本地路由正是为了解决这一协议断层而设计的。它的工作流程可以概括为四个阶段：

1. 配置文件改写：CC-Switch将Codex的live配置指向http://127.0.0.1:15721/v1，并强制锁定wire_api = "responses"

2. 格式标记：Provider配置中的meta.apiFormat = "openai_chat"告知路由层上游的真实接口形态是Chat Completions

3. 请求改写：路由拦截/responses或/v1/responses路径，将其映射为/chat/completions，同时完成请求体格式转换

4. 响应回译：上游返回的Chat格式响应（无论是JSON还是SSE流）由路由层重新组装为Codex能解析的Responses格式

简单来说：Codex始终以为自己连接的是一个标准的Responses API端点，而CC-Switch在中间默默完成了协议的“翻译工作”。

三、配置步骤详解

3.1 第一步：在CC-Switch中添加供应商

1. 打开CC-Switch软件

2. 切换到顶部的「Codex」标签页（注意不是OpenAI标签页）

3. 点击右上角的「+」新建供应商

https://developer.qcloudimg.com/http-save/yehe-6798077/04878e84c6539d07f210ab4305ba1a75.png

1. 在预设列表中选择「DeepSeek」

2. 填入你之前保存的DeepSeek API Key，其他参数CC-Switch会自动填充

3.2 第二步：配置本地路由

1. 在CC-Switch中找到「设置」→「路由」菜单

2. 选择「本地路由」，确保路由开关处于开启状态

3. 服务地址一般不需要修改（默认http://127.0.0.1:15721）

💡 关键提示：在添加供应商时，确保勾选「需要本地路由映射」选项。这一步非常重要，它告诉CC-Switch需要对当前供应商启用协议转换功能。

3.3 第三步：Codex连接DeepSeek

配置完成后，CC-Switch会自动修改Codex的配置文件~/.codex/config.toml，将其指向本地路由地址。

启动Codex客户端，如果配置一切正常，你会看到模型列表中出现了DeepSeek相关模型，此时就可以开始使用DeepSeek大模型进行编程辅助了。

3.4 验证配置

在Codex对话界面中输入测试指令，例如：

“用C++写一个快速排序函数”

如果能够正常收到来自DeepSeek的代码回复，恭喜你——配置成功！