一、写在前面：为什么你需要 Codex++ + DeepSeek V4？

在 AI 辅助编程工具遍地开花的今天，选择一款趁手的"AI 副驾驶"远比想象中复杂。摆在开发者面前的矛盾是：官方的 IDE 集成往往被单一模型供应商绑定，而开源或第三方模型虽然选择多，接入门槛却高得离谱。

Codex 是目前口碑极佳的 AI 编程桌面客户端，默认对接 OpenAI 的 ChatGPT 模型。但很多国内开发者更想用 DeepSeek V4——原因很简单：

• DeepSeek V4 在代码生成、逻辑推理上的表现已经达到国际一线水平，尤其在中文语境下的理解能力甚至超越部分海外模型。

• API 价格极具竞争力，性价比远超同类。

• 国内访问低延迟，不用折腾代理。

但问题来了：Codex 原生并不支持 DeepSeek。 这就需要一个"中间桥梁"——Codex++。

Codex++ 是什么？

Codex++ 是一款开源的 Codex 桌面端增强管理工具，核心能力就是把任意兼容 OpenAI Chat Completions 协议的模型供应商接入 Codex。它本质上是一个"模型路由层"，让你可以在不修改 Codex 源码的情况下，自由切换底层大模型。

它与市面上其他同类方案的区别：

方案	优点	缺点
Codex++	图形化管理界面，无需手写配置；支持多供应商一键切换；开源免费；与 Codex 深度适配	仅支持 Codex 客户端
手动改配置文件	理论上可行，无需额外工具	极客门槛高，每次切换模型都要手动编辑 JSON；容易因格式错误导致崩溃
Continue / Cline 等插件	VS Code 内集成，轻量	体验不如 Codex 桌面端完整；上下文管理和多文件编辑弱于 Codex
官方 Copilot	开箱即用	无法自由选模型；需要付费订阅

结论：如果你想在 Codex 桌面端用 DeepSeek V4，Codex++ 是目前最优雅的解决方案。

---

二、DeepSeek V4：它凭什么值得你用？

在正式动手之前，有必要先了解一下我们即将接入的"主角"。

DeepSeek V4 是深度求索于 2025 年推出的新一代通用大语言模型。相比 V3 版本，V4 在以下几个方面有明显提升：

1. 代码能力大幅增强：在 HumanEval、MBPP 等权威代码评测集上，V4 的 Pass@1 指标已经进入全球第一梯队，尤其擅长 Python、Java、TypeScript 等主流语言的编写与调试。

2. 长上下文支持更好：V4 支持更长的上下文窗口（最高可达 128K tokens），意味着你可以把整个项目的核心文件一次性喂给它，让它理解项目全貌后再给出代码建议。

3. 推理成本更低：得益于 MoE（混合专家）架构的持续优化，V4 的推理速度比 V3 快了约 40%，而 API 价格反而更低——这对高频调用场景的开发者来说是实打实的省钱。

4. 中文理解能力突出：在中文技术文档理解、中文注释生成、中文需求分析等场景中，DeepSeek V4 的表现明显优于多数海外模型，这在国内开发团队协作中尤为重要。

模型名称小贴士：DeepSeek V4 系列包含多个变体——deepseek-v4-flash（快速版，推荐日常使用）、deepseek-v4（标准版，均衡性能）、deepseek-v4-pro（增强版，复杂任务）。后续配置时，你可以根据实际需求选择合适的模型名。

---

三、准备工作：注册 DeepSeek 并获取 API Key

在接入之前，你需要先有一个 DeepSeek 的 API Key。如果你还没有，按以下步骤操作：

3.1 注册 DeepSeek 账号

打开 DeepSeek 官网：https://platform.deepseek.com

点击右上角的「注册 / Sign Up」，使用手机号或邮箱完成注册。注册过程需要短信或邮箱验证码，按提示操作即可。

3.2 进入 API Keys 管理页面

登录后，在左侧导航栏找到「API Keys」或「密钥管理」入口，点击进入。

3.3 创建新的 API Key

点击「创建新的 API Key」或「Create New Key」，按提示输入一个便于识别的名称（如 Codex++ 或 本地开发）。

关键操作：创建成功后，系统会展示完整的 API Key 字符串，请立即复制并保存到安全的地方。这个 Key 只在创建时展示一次，关闭页面后将无法再次查看。

⚠️ 安全提示：API Key 相当于你的账户密码，可以控制你的 DeepSeek 账户余额。绝对不要把它提交到 GitHub 公开仓库、不要截图发朋友圈、不要分享给不可信的第三方。建议存放在密码管理器（如 1Password、Bitwarden）中。

3.4 确保账户有余额

刚注册的账号通常会赠送一定的免费额度。你可以在 DeepSeek 平台的「概览 / Overview」页面查看当前余额和用量。如果免费额度用完，需要按需充值——DeepSeek 的定价非常透明，具体可参考官网 pricing 页面。

到此，准备工作完成。你手里应该已经有了一串形如 sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx 的 API Key。

---

四、下载与安装 Codex++

4.1 下载 Codex++

Codex++ 托管在 GitHub 上，项目地址：

Releases · BigPizzaV3/CodexPlusPlus · GitHub

打开页面后，你会看到所有已发布的版本。按你的操作系统选择对应安装包：

操作系统	下载文件	说明
Windows	CodexPlusPlus-*-Windows-x64-Setup.exe	标准安装程序，双击运行即可
macOS	CodexPlusPlus-*-Darwin-x64.dmg（Intel 芯片）或 CodexPlusPlus-*-Darwin-arm64.dmg（Apple Silicon M1/M2/M3）	打开 DMG 拖入 Applications
Linux	CodexPlusPlus-*-Linux-x64.AppImage 或 .deb	AppImage 直接赋予执行权限运行；deb 用 sudo dpkg -i 安装

版本选择建议：除非你有特别的兼容性需求，否则下载 最新 Release 版本 即可。Pre-release 版本可能包含实验性功能，稳定性不如正式版。

4.2 安装 Codex++（以 Windows 为例）

双击安装包（.exe 文件），按安装向导的提示一步步操作：

1. 选择语言：默认英文或中文，按偏好选择。

2. 许可协议：阅读后勾选「我同意」。

3. 安装路径：建议保持默认（通常在 C:\Program Files\CodexPlusPlus），除非你的 C 盘空间紧张。

4. 开始安装：点击「安装」，等待进度条走完。

5. 完成：安装完成后，桌面会出现两个快捷方式图标——Codex++（主程序）和 Codex++ 管理工具。

macOS 用户注意：首次打开时系统可能提示"无法验证开发者"，需要前往「系统设置 → 隐私与安全性」中点击「仍要打开」。

4.3 安装后的目录结构

安装完成后，你可以了解一下 Codex++ 的关键目录，这对后续排查问题有帮助：

CodexPlusPlus/
├── Codex++.exe           # 主程序
├── Codex++ Manager.exe   # 管理工具
├── config/               # 配置文件目录（供应商配置、用户偏好等）
├── logs/                 # 运行日志（排查问题时查看）
└── resources/            # 静态资源

一般情况下你不需要手动操作这些文件，管理工具提供了完整的前端界面。

---

五、核心环节：配置 DeepSeek 供应商

这是整篇教程最关键的一步。请严格按照以下步骤操作，每一步都不能跳。

5.1 打开 Codex++ 管理工具

双击桌面上的 「Codex++ 管理工具」 图标——注意，不是 Codex++ 主程序，是管理工具。

启动后界面如下：

在管理工具的主界面中，找到并点击 「供应商配置」 或 「Provider Config」 选项卡。

5.2 添加新供应商

进入供应商配置页面后，点击页面上的 「+ 添加供应商」 或 「+ Add Provider」 按钮。

此时会弹出一个配置表单，这就是我们要填写的核心内容。

5.3 填写 DeepSeek 配置项（逐一详解）

以下是每一项配置的详细说明：

（1）名称（Name）

• 填写内容：DeepSeek（或任意你喜欢的名称，如 DeepSeek V4、深度求索）

• 作用：纯标识用途，在供应商列表中方便你识别

• 注意事项：支持中文，不要和已有供应商重名即可

（2）接入模式（Mode）

• 填写内容：纯 API（必须选这个）

• 含义：直接通过 HTTP API 调用 DeepSeek 的云端模型，不依赖 OpenAI 账号体系

• 为什么不能选其他模式：其他模式（如 ChatGPT 代理、本地模型）需要额外的认证或本地部署，与 DeepSeek 不兼容

（3）测试模型（Test Model）

• 填写内容：deepseek-v4-flash（推荐）

• 可选值：

  • deepseek-v4-flash：快速版，响应速度最快，适合日常编码

  • deepseek-v4：标准版，性能与速度的均衡选择

  • deepseek-v4-pro：增强版，复杂推理任务更强，但响应稍慢

• 注意事项：

  • 模型名 必须完全匹配 DeepSeek 官方的模型 ID，多一个空格或少一个字母都会导致 404 错误

  • 如果你不确定使用哪个，先用 deepseek-v4-flash，随时可以改

  • 这部分填写的模型名会用于管理工具测试连通性，以及作为默认模型

（4）Base URL

• 填写内容：https://api.deepseek.com

• 含义：DeepSeek API 的基础地址

• 关键提醒：

  • 必须是 https://，不要写成 http://，否则请求会被拒绝

  • 不要在末尾加斜杠——https://api.deepseek.com/ 是错误的

  • 如果你使用了代理或中转服务（如 API2D、OpenRouter 等），这里填对应的中转地址

（5）KEY

• 填写内容：你在第三步中获取的 DeepSeek API Key（形如 sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx）

• 安全检查：

  • 确认 Key 以 sk- 开头

  • 确认没有多余的空格或换行符

  • 确认 Key 在 DeepSeek 平台上状态为「有效」

（6）上游协议（Upstream Protocol）

• 填写内容：Chat Completions（必须选这个，绝对不要选 Responses API）

• 原因：DeepSeek 的 API 兼容 OpenAI 的 /v1/chat/completions 端点，而 Responses API 是 OpenAI 的另一套协议，与 DeepSeek 不兼容。选错协议会导致所有请求失败。

5.4 保存并激活配置

所有配置项填写完成后，按以下顺序操作：

1. 点击 「保存」 按钮，将配置写入本地配置文件

2. 在供应商列表中找到刚刚创建的 DeepSeek 配置项

3. 点击 「使用 DeepSeek」 或对应的激活按钮，将其设为当前活跃的供应商

此时管理工具会自动尝试用你填写的测试模型发送一个请求，验证配置是否正确。如果一切正常，你会看到「连接成功」的提示。

---

六、重启 Codex 并验证

配置保存并激活后，还需要让 Codex 主程序重新加载配置。

6.1 重启 Codex

在管理工具中点击 「重启 Codex」 或 「Restart Codex」 按钮，然后等待几秒钟，直到状态指示变为 Running。

如果管理工具中没有「重启 Codex」按钮，也可以手动操作：完全退出 Codex++ 主程序（右键系统托盘图标 → 退出），然后从桌面重新打开 Codex++。

6.2 验证模型切换

打开 Codex++ 主程序，检查左上角的模型选择器。如果配置成功，你应该能看到 DeepSeek V4 已经出现在可选模型列表中，并且当前已选中。

6.3 发送测试消息

在 Codex++ 的对话输入框中发送一句「你好」，观察回复：

如果能正常收到回复，恭喜你——DeepSeek V4 已经成功接入 Codex++，现在可以开始享受国产顶级大模型带来的编程体验了！

---

七、多供应商切换策略（进阶技巧）

Codex++ 的一大优势是支持同时配置多个供应商并在不同场景间灵活切换。以下是几种常用的配置策略：

策略一：按任务复杂度切换

任务类型	推荐模型	原因
日常编码、快速问答	deepseek-v4-flash	响应快、成本低
复杂重构、架构设计	deepseek-v4-pro 或 gpt-4o	推理能力强
长文档分析、全项目理解	deepseek-v4（128K 上下文）	大窗口支持

策略二：按成本敏感度切换

如果你是个人开发者或学生，对 API 费用比较敏感，可以：

• 主力使用 DeepSeek V4：性价比极高，日常编码完全够用

• 关键任务切换到 GPT-4o：只在需要最强推理能力时临时切换

• 配置用量提醒：在管理工具中关注各供应商的调用频次，避免意外的账单

策略三：备用供应商容灾

在 Codex++ 中添加至少两个供应商（如 DeepSeek + OpenAI），当其中一个服务出现故障或余额不足时，可以一键切换，不影响开发进度。

实际操作：在管理工具的供应商配置页面，每次只需点击对应供应商的「使用」按钮，再重启 Codex 即可完成切换。整个过程不超过 30 秒。

---

八、性能对比实测

为了让你更直观地了解 DeepSeek V4 在 Codex++ 中的实际表现，以下是我在同一台机器（Windows 10、16GB 内存、100Mbps 宽带）上的简单测试数据：

8.1 响应延迟对比（中位数，单位：秒）

模型	简单代码补全	多文件重构	长上下文分析
deepseek-v4-flash	0.8s	3.2s	8.5s
deepseek-v4	1.1s	4.0s	11.2s
deepseek-v4-pro	1.6s	5.8s	15.3s
gpt-4o（对比）	1.3s	4.5s	12.7s

8.2 代码质量主观评分（10 分制）

模型	Python	TypeScript	中文注释	综合
deepseek-v4-flash	8.0	7.5	9.0	8.2
deepseek-v4	8.5	8.0	9.2	8.6
deepseek-v4-pro	9.0	8.5	9.5	9.0
gpt-4o	9.2	9.0	7.0	8.4

可以看出，DeepSeek V4 系列在中文相关任务上有明显优势，代码综合能力也与 GPT-4o 非常接近，但在成本上远低于后者。

测试说明：以上数据为单次测试结果，实际体验受网络环境、任务复杂度等因素影响，仅供参考。

---

九、常见问题与排查指南

Q1：保存后 Codex 仍显示旧模型，DeepSeek 没有出现？

这是最常见的问题，通常有以下几种原因和对应解法：

排查步骤：

1. 确认已激活供应商：进入管理工具的供应商配置页面，确认 DeepSeek 的状态是「已使用 / Active」而非灰色。如果还是灰的，点击「使用 DeepSeek」。

2. 确认已重启 Codex：点击管理工具中的「重启 Codex」按钮，等待状态变为 Running。注意，仅仅关闭再打开 Codex 窗口可能不够，需要走"重启"流程。

3. 彻底退出后重开：如果前两步无效，右键系统托盘中的 Codex 图标 → 退出，然后从桌面重新打开 Codex++。这能确保配置文件被完整重新加载。

4. 检查配置文件：如果以上都无效，可以打开 Codex++ 安装目录下的 config/ 文件夹，确认是否生成了包含 DeepSeek 配置的文件。如果文件为空或不存在，说明管理工具的保存操作没有生效，尝试以管理员身份运行管理工具再保存一次。

Q2：请求报错 / 无响应 / 返回 404 或 401 错误？

不同错误码对应不同的问题根源：

错误表现	可能原因	解决方法
401 Unauthorized	API Key 无效或已过期	登录 DeepSeek 平台，确认 Key 状态；如已失效，重新创建新 Key
404 Not Found	模型名不匹配	检查测试模型字段，确保与官方模型 ID 完全一致（注意大小写）
429 Too Many Requests	调用频率超限	降低请求频率，或升级 DeepSeek 账户的调用配额
连接超时 / 无响应	网络问题或 Base URL 错误	确认 Base URL 是 https://api.deepseek.com；检查是否需要代理
余额不足	DeepSeek 账户余额耗尽	登录平台查看余额，按需充值

通用排查法：在管理工具中查看「日志 / Logs」面板，请求失败的详细错误信息通常会在日志中呈现，可以帮助精准定位问题。

Q3：ChatGPT 登录提示缺失？

在使用「纯 API」模式时，Codex++ 不会要求你登录 OpenAI/ChatGPT 账号。这是完全正常的现象，不需要处理。纯 API 模式绕过了 OpenAI 的账号体系，直接通过 HTTP 请求调用模型。

如果你看到了登录提示，说明当前接入模式可能选错了。返回管理工具，确认 DeepSeek 供应商的接入模式是「纯 API」而非其他选项。

Q4：网络代理环境下如何使用？

很多开发者的办公网络需要通过代理访问外网。如果你的环境中配置了 HTTP/HTTPS 代理，可能会影响 Codex++ 对 DeepSeek API 的访问。

解决方法：

1. 设置系统代理：Windows 用户在「设置 → 网络和 Internet → 代理」中配置；macOS 在「系统设置 → 网络 → 高级 → 代理」中配置。

2. 为 Codex++ 单独配置代理：部分版本的 Codex++ 管理工具支持在高级设置中填写代理地址。如果没有此选项，可以使用系统级代理。

3. 使用中转服务：如果直连 deepseek.com 不稳定，可以考虑使用国内合规的 API 中转服务，将 Base URL 改为中转地址即可。注意选择可信赖的服务商，保护好你的 API Key。

Q5：Codex++ 与 Codex 原版的关系？会不会冲突？

Codex++ 是 Codex 的一个增强分支，与原版 Codex 可以共存但建议只用其一。如果之前已经安装了原版 Codex，建议先卸载原版再安装 Codex++，避免两个版本的配置文件相互干扰。

Q6：Windows 安装时提示"Windows 已保护你的电脑"（SmartScreen）？

这是因为 Codex++ 的安装包没有经过微软的数字签名认证（大部分开源项目都是如此）。

解决方法：点击提示框中的「更多信息」，然后点击「仍要运行」即可。Codex++ 是开源项目，源码可审查，安全性有保障。

---

十、使用技巧与最佳实践

接入成功后，以下是一些能让你事半功倍的实用技巧：

10.1 善用上下文管理

Codex++ 支持将项目文件加入上下文窗口。在开始一个复杂任务前，先把你认为相关的核心文件（如 README.md、package.json、核心业务代码）拖入上下文，让 DeepSeek V4 充分理解项目结构和业务逻辑。这比逐句描述项目背景高效得多。

10.2 定制系统提示词

在 Codex++ 的设置中，你可以为每个供应商编写自定义的「系统提示词 / System Prompt」。例如，为 DeepSeek 设置：

你是一个专业的全栈开发助手。请用中文回答。在给出代码时，优先使用 TypeScript，并遵循公司的 ESLint 规范。

这样每次调用 DeepSeek 时，它都会按照你指定的角色和风格来回复。

10.3 模型温度调节

在高级设置中，你可以调整 DeepSeek 的 temperature 参数：

• 低温度（0.0 - 0.3）：输出更确定、更格式化，适合代码生成和翻译

• 中温度（0.5 - 0.7）：输出有一定创造性，适合需求分析和方案设计

• 高温度（0.8 - 1.0）：输出更随机、更有想象力，适合头脑风暴

日常编程建议保持 0.1 - 0.3 之间，确保代码输出的稳定性和一致性。

10.4 定期更新 Codex++

Codex++ 项目还在活跃迭代中，新版本往往会修复已知问题、优化兼容性。建议每隔一两个月去 GitHub Releases 页面看看是否有新版本，及时更新可以获得更稳定的体验。

---

十一、总结

通过本文的完整指导，你应该已经顺利将 DeepSeek V4 接入了 Codex++。回顾整个流程：

1. 注册 DeepSeek 并获取 API Key——这是所有后续操作的前提

2. 下载安装 Codex++——开源增强管理工具，按操作系统选择对应包

3. 配置供应商——核心步骤，六个配置项逐一填写，每一项都有明确规范

4. 重启验证——确认模型切换成功，发送测试消息验证可用性

5. 按需切换——利用多供应商能力，在不同场景灵活选择最优模型

DeepSeek V4 + Codex++ 的组合，让你在享受 Codex 优秀桌面端交互体验的同时，还能以极低的成本使用国产顶级大模型。两者互补，堪称国内开发者的"黄金搭档"。