最近在折腾 AI 编程工具，发现 Codex 确实好用，但默认只能用 OpenAI 的模型，对国内开发者来说，账号、网络、费用都是不小的门槛。有没有办法让它用上 DeepSeek 这类国内模型呢？答案是肯定的。经过一番摸索，我整理了一套完整的 Codex 本地部署与 DeepSeek 接入方案，全程图形化操作，无需复杂配置，几分钟就能搞定。无论你是想体验 AI 编程助手，还是希望降低使用成本，这套方案都值得一试。
1. 背景与核心概念：为什么需要这套方案？
在开始动手之前，我们先搞清楚几个核心概念，以及为什么不能直接把 DeepSeek 的地址填到 Codex 里。
1.1 Codex 是什么？
Codex 是由 OpenAI 推出的 AI 智能体（Agent）。最初它主要面向编程开发场景，但现在已经进化成一个功能强大的通用智能体。它的界面和操作对新手非常友好，核心能力包括：
- 智能问答与代码生成：理解你的需求，生成或修改代码。
- 文件操作：可以读取、分析并修改你电脑本地的项目文件。
- 自动化任务：能够调用外部工具、操作浏览器甚至桌面应用，执行一系列自动化流程。
简单来说，Codex 就像一个能直接在你电脑上工作的 AI 助手，极大地提升了开发效率。但它的“默认设置”是只与 OpenAI 自家的 API 通信。
1.2 直接接入 DeepSeek 的障碍
DeepSeek 等国内大模型提供了极具性价比的 API 服务，但直接让 Codex 使用会遇到一个根本性的技术问题：协议不兼容。
- Codex 的协议：它底层调用的是 OpenAI 专有的Responses API，其请求路径通常是
/v1/responses。这套协议包含了 OpenAI 定义的一套完整的请求/响应格式、流式输出方式以及工具调用（Function Calling）规范。 - DeepSeek 的协议：DeepSeek 等模型遵循的是更通用的Chat Completions API（OpenAI 也提供此 API），路径为
/v1/chat/completions。虽然功能相似，但请求体结构、消息角色定义、流式响应格式等细节存在差异。
如果你简单地把 DeepSeek 的 API 地址（如https://api.deepseek.com）配置到 Codex，Codex 会按照 Responses API 的格式发送请求，而 DeepSeek 服务器无法识别这种格式，结果就是返回404 Not Found或其他错误，导致模型列表都无法加载。
1.3 解决方案：协议转换工具 CC Switch
为了解决这个协议壁垒，我们需要一个“翻译官”——CC Switch。它是一个开源的桌面配置工具，核心作用就是在 Codex（或其他类似工具）和第三方大模型 API 之间进行协议转换。
- 工作原理：CC Switch 在本地启动一个代理服务（默认端口
15721）。当 Codex 发出请求时，CC Switch 会拦截这些请求，将 OpenAI Responses API 的格式“翻译”成标准的 Chat Completions API 格式，然后转发给 DeepSeek。收到 DeepSeek 的回复后，再“翻译”回 Codex 能理解的格式。 - 核心价值：对于 Codex 来说，它以为自己一直在和 OpenAI 对话；对于 DeepSeek 来说，它收到的是标准请求。整个过程对用户透明，实现了无缝切换。
2. 环境准备与工具下载
在开始配置前，请确保你的电脑满足基本条件，并下载好必要的软件。
2.1 系统要求与网络
- 操作系统：Windows 10/11, macOS, Linux 均可。本文将以 Windows 为例进行演示，其他系统操作逻辑类似。
- 网络环境：首次安装和启动 Codex 时，需要能正常访问其官方服务（用于基础验证和更新）。配置完成后，日常使用 DeepSeek 则依赖国内网络，速度会快很多。
- DeepSeek 账号：你需要一个已实名认证并充值的 DeepSeek 平台账号，用于获取 API Key。
