Codex 配置国产模型 DeepSeek 完整教程（本篇文章以mac系统为例）

前言

OpenAI Codex 是一款强大的 AI 编程助手，但其原生仅支持 OpenAI 官方模型，无法直接接入 DeepSeek 等国产大模型。核心原因在于协议不兼容：Codex 客户端使用的是 OpenAI 专属的 Responses API 协议，而 DeepSeek 等国产模型遵循通用的 Chat Completions API 标准，直连会导致请求失败。

本文将详细介绍两种主流方案，通过本地协议转换层让 Codex 无缝对接 DeepSeek 模型，实现低成本、高性能的 AI 编程体验。

---

项目分析

目前主流有两种实现方式，各有优劣：

方案	工具	特点	推荐指数
方案一	CC-Switch	开源免费、轻量、支持多模型路由、社区活跃	中等
方案二	Codex++	一体化管理工具、图形化配置、功能丰富	非常推荐

本文以 codex++方案 为主线详细讲解，

---

准备工作：

1. 下载安装codex codex下载官网
2. 获取 DeepSeek API Key
   在开始配置前，先准备好 DeepSeek 的 API 凭证：
3. 访问 DeepSeek 开放平台，注册并登录账号
4. 进入左侧菜单 API Keys 页面
   

点击 创建 API Key，输入名称（如 codex-use）
3. 创建成功后立即复制保存密钥（关闭弹窗后无法再次查看）
4. 前往「账单」页面充值少量金额（API 为预付费制，10 元可使用很久）

安全提示：API Key 等同于账号密码，请勿提交到公开代码仓库或分享给他人。

---

方案一：Codex++ 管理工具方案（推荐）

Codex++ 是 Codex 的增强启动器与配置管理工具，提供图形化界面配置第三方模型，无需手动修改配置文件。

第一步：安装 Codex++

• 下载 Codex++ 安装包并完成安装
• 访问GitHub开源项目codex++（搜索codexplus即可）
• 点击release进行跳转选择安装包
• 选择arm即可
  关于这几个下载版本如何选择？
• 如果你的 Mac 是 M1/M2/M3/M4 芯片 → 选 arm64 版本。
• 如果你的 Mac 是 Intel 芯片 → 选 x64 版本。
• 如果你不确定芯片类型 → 优先选 arm64，因为苹果已全面转向该架构，且多数新软件不再支持 x64。
• 如果你喜欢拖拽安装 → 选 .dmg。
• 如果你喜欢解压即用 → 选 .zip。
• 安装完成后会生成两个图标：Codex++ 启动器、Codex++ 管理工具
• 打开 Codex++ 管理工具，软件会自动扫描本地已安装的 Codex

第二步：配置 DeepSeek 供应商

1. 左侧菜单点击 「供应商配置」
2. 右上角点击 「添加供应商」
   
3. 点击DeepSeek供应商会省去很多输入

4. 然后输入API就行也可以修改模型（别忘了保存）

第三步：启用并启动

1. 在供应商列表中选中刚添加的 DeepSeek
2. 点击「使用」设为当前激活模型
3. 点击右上角「重启 Codex++」
4. 通过 Codex++ 启动器打开 Codex 即可使用

注意：必须通过 Codex++ 启动器启动 Codex 才会加载第三方模型配置，直接打开原生 Codex 不生效。

---

可用模型说明

DeepSeek 提供多款模型，可根据场景选择：

• deepseek-v4-flash：轻量高速版，响应快、成本低，适合日常编码补全
• deepseek-v4-pro：能力更强，适合复杂逻辑、架构设计类任务
• deepseek-reasoner：推理增强版，擅长算法题、深度思考类场景
• deepseek-coder：代码专项优化模型，补全精准度更高

在 Codex++ 或 CC-Switch 中均可自由切换，无需重新配置。

---

常见问题排查

Q1：配置完没反应，还是原来的模型

• 检查 codex++ 是否在后台运行，路由总开关是否开启
• 确认 Codex 标签页下的 DeepSeek 供应商开关已打开
• 完全退出 Codex 并重新启动，不要只关闭窗口

Q2：发送消息报错 404 / 无响应

• 检查 API Key 是否正确，有无多余空格
• 确认 DeepSeek 账户有余额（预付费制，余额为 0 会调用失败）
• 检查 Base URL 是否正确：https://api.deepseek.com，不要多加路径
• Codex++ 方案确认「上游协议」选的是 Chat Completions 而非 Responses API

Q4：如何判断codex用的是不是自己接入的模型

• 一开始我说直接问codex的但是他的回答出乎我的意料
• 这个现象本质是大模型 “指令遵循” 能力的正常表现：Codex 本身是为官方 GPT 设计的客户端，它的系统提示里硬编码了身份设定，目的是保证交互体验统一。第三方代理工具只能转发请求，默认不会修改请求内的系统提示内容，因此模型会严格按照前置指令伪装身份。

• 但是直接看后台扣费记录就行了

Q3：会不会修改 Codex 原程序？安全吗？

• Codex++ 均采用本地代理/启动注入方式，不修改 Codex 本体文件
• 关闭代理工具后，Codex 自动恢复原生状态，无残留
• API Key 仅保存在本地，不上传第三方服务器

---

总结

通过 Codex++ 做本地协议转换，即可让 Codex 流畅使用 DeepSeek 等国产大模型。相比官方 GPT 系列，DeepSeek 在中文语境、代码理解和成本控制上都有明显优势，适合国内开发者日常使用。

推荐优先尝试 codex++方案，开源透明、配置简单，后续还能方便地接入通义千问、智谱等更多国产模型，一劳永逸。