一文搞定：如何用 Codex++ 让 Codex 接入 DeepSeek

从协议原理到四步实操，再到五种方案横向对比——一份真正能照着做的保姆级教程

OpenAI Codex 很强，但额度烧得也快。本文手把手教你用 Codex++ 无痛接入 DeepSeek，实现「额度自由」，全程可视化操作，零代码基础也能一次成功。

一、为什么 Codex 不能直接换 DeepSeek？

许多开发者第一次尝试接入 DeepSeek 时，都会走一条弯路：把 Codex 设置里的 Base URL 改成
https://api.deepseek.com/v1，API Key 换成 DeepSeek 的，然后满怀期待地点击发送——结果报错。

这不是偶然，而是两种完全不同的 API 协议在”打架”。

一文搞定：如何用 Codex++ 让 Codex 接入 DeepSeek

▲ Responses API 与 Chat Completions API 协议不兼容示意图

Codex 桌面端使用的是 OpenAI 独家的 Responses API，而 DeepSeek 等国产模型使用的是行业通用的 Chat Completions API。两者之间的差异，不只是 URL 路径不同这么简单：

差异点	Responses API（Codex 原生）	Chat Completions API（DeepSeek）
请求路径	/responses	/chat/completions
请求格式	包含 input 字段，工具定义嵌套方式不同	包含 messages 数组，工具定义在 tools 字段
响应格式	output 数组，每项带 type 标识	choices 数组，含 message 对象
思维链字段	summary 字段	reasoning_content 字段
流式事件格式	事件类型名称不同	SSE 事件以 data: 前缀传输

简单来说，Codex 说”法语”，DeepSeek 说”英语”，直接对话谁也听不懂谁。你需要一个翻译官——在本地跑一个协议转换层，让 Codex 发出的”法语”请求被实时翻译成 DeepSeek 能听懂的”英语”，再把 DeepSeek 的”英语”响应翻译回 Codex 认识的”法语”。

这就是所有接入方案的核心工作：协议转换。

搞懂了这个原理，你就清楚为什么直接改 Base URL 行不通——请求路径、消息格式、工具调用结构、流式解析全部不兼容，任何一个环节出错都会导致功能异常或直接报错。

二、Codex++：最推荐的接入方案

在所有现成的接入工具中，Codex++ 是目前配置最简单、功能最完善的方案。它的核心思路很优雅：不修改 Codex App 的原始安装文件，而是通过外部 launcher 启动 Codex，并使用 Chromium DevTools Protocol（CDP）注入增强脚本，在浏览器层面完成协议翻译和功能增强。

GitHub 地址：
github.com/bignett/codex-plusplus（最新版 v1.1.7+）

▲ Codex++ 工作原理：外部启动 + 协议转换

▲ Codex++ 接入 DeepSeek 四步配置流程

下载安装 Codex++

前往 GitHub 的 Releases 页面下载最新版本（提议 v1.1.7 或更高），不要去微软商店下载——商店版本更新滞后，可能缺少关键功能。

安装完成后，桌面会出现两个图标：

Codex++：启动器，用它来启动 Codex
Codex++ 管理工具：配置中心，用来添加供应商、管理模型、查看使用记录

配置 DeepSeek 供应商

打开「Codex++ 管理工具」，点击「添加供应商」→ 选择「纯 API」，然后填写以下信息：

Base URL：https://api.deepseek.com/v1
API Key：粘贴你的 DeepSeek API Key（在 platform.deepseek.com 注册并获取，提议先充值 10 元测试）
上游协议：必须选 Chat Completions ⚠️

⚠️ 关键提醒：上游协议必定要选 Chat Completions，不能选 Responses。选错了等于翻译官用错了词典，所有请求都会解析失败。

模型选择：

模型	特点	适用场景
deepseek-chat（V4 Pro）	通用对话，速度快、性价比高	日常代码编写、问答、重构
deepseek-reasoner	带推理链，思考更深但 token 消耗大	复杂逻辑推理、算法设计

DeepSeek 官方已推荐使用新模型名 deepseek-v4-flash 和 deepseek-v4-pro，旧别名将在 2026-07-24 后废弃。

开启页面增强

在 Codex++ 管理工具中找到「页面增强」选项，打开启用。

这一步超级重大但容易被忽略。Codex 在 API 模式下默认会禁用插件/Skills 功能，而「页面增强」通过脚本注入的方式解锁了这些功能，让你在用 DeepSeek 的同时也能使用部分 Skills 和插件。

可选操作：在脚本市场安装 Codex Context Used Meter——实时监控上下文使用量，协助你在超过 50% 时及时开新对话，避免 token 浪费。

用 Codex++ 启动 Codex

配置完成后，必须点击桌面上的「Codex++」图标来启动 Codex，不要使用原来的 Codex 快捷方式。

为什么？由于协议转换层需要在 Codex 启动之前运行。Codex++ 的启动顺序是：

先启动本地代理服务（协议转换层）
再启动 Codex App
Codex 的所有请求自动通过代理转发给 DeepSeek

如果你直接启动 Codex，它绕过了代理，请求会直接发往 OpenAI 的服务器。

三、如何验证接入成功？

接入完成后，许多人会困惑：Codex 界面右下角依旧显示”OpenAI / GPT”，是不是没成功？

这是正常现象。 Codex 界面显示的模型名是本地 UI 状态，不会由于代理转发而改变。正确的验证方式有两个：

方法一：查看 Codex++ 管理工具的使用记录

打开管理工具，找到「使用记录」或「调用日志」，确认模型栏显示的是 deepseek-chat 或 deepseek-v4-pro，而非 gpt-4 等 OpenAI 模型。

方法二：发送一张图片给 Codex

DeepSeek V4 不支持多模态，如果你发送图片后 Codex 报错说”无法识别图片”——祝贺，这恰恰证明请求已经到达了 DeepSeek，接入成功。

四、接入后功能状态全览

▲ 接入 DeepSeek 后 Codex 各功能兼容状态一览

状态	功能	说明
✅ 完全正常	代码编写、调试、重构	核心功能，体验与 GPT 接近
✅ 完全正常	文件读写、项目管理	Codex 的基础操作能力
✅ 完全正常	多轮对话、任务规划	上下文连贯性良好
⚠️ 降级可用	Skills / 插件	需开启「页面增强」，部分不稳定
⚠️ 降级可用	工具调用（Function Calling）	偶有格式解析错误，重试即可
⚠️ 降级可用	上下文窗口	实际约 256K，远小于标称 1M
❌ 完全不可用	AI 生图（Image Gen）	DeepSeek 不具备图像生成能力
❌ 完全不可用	Computer Use（操控电脑）	依赖 OpenAI 专有能力
❌ 完全不可用	识图 / 多模态理解	DeepSeek V4 无视觉能力

一句话总结：代码相关的核心功能基本正常，涉及 OpenAI 专有多模态能力的功能不可用。如果你的使用场景以代码编写、调试、问答为主，DeepSeek 完全够用。

五、常见报错排查手册

接入过程中难免遇到问题，以下是 8 个最常见的报错及解决方案：

问题	缘由	解决方法
配置后界面仍显示 GPT	正常现象	查看管理工具「使用记录」验证
发消息一直 reconnecting	WebSocket 代理未配置	开梯子 TUN 模式，或配置 .env 中的 HTTP_PROXY
发图片报错	DeepSeek V4 不支持多模态	识图需求请换回 GPT
Skills / 插件灰色	页面增强未开启	在管理工具中启用「页面增强」
一次对话消耗大量 token	上下文累积过大	安装 Context Used Meter，超 50% 就开新对话
切换模型后对话记录消失	会话存储在不同位置	Codex++ v1.1.7 有「历史会话恢复」功能
Codex++ 白屏 / 无反应（Windows）	权限不足	右键 → 以管理员身份运行
第二天接入失效	中间件服务未自动启动	设置开机自启，或每次使用前先开管理工具

六、其他接入方案横向对比

▲ 五种 Codex 接入 DeepSeek 方案对比

Codex++ 不是唯一选择。根据你的使用场景，其他方案也有各自的优势：

方案二：EchoBird——多模型频繁切换首选

GitHub: github.com/edison7009/EchoBird

EchoBird 的最大优势是切换模型时会话记录不会丢失。对于需要频繁在不同模型间切换的开发者体验更好。

Mac 用户注意：首次打开可能提示”文件已损坏”，这是 macOS Gatekeeper 的安全拦截，右键 → 打开即可绕过。

方案三：CCX + CCSwitch——不推荐新用户

这是最早出现的方案，需要两个工具配合使用，配置步骤更多，且 CCSwitch 最新版存在已知 bug。除非你已经在用，否则不提议新用户尝试。

方案四：本地网关桥接——Codex CLI 用户适用

如果你使用的是 Codex CLI 而非桌面端，编辑 ~/.codex/config.toml：

[profiles.deepseek-ccx]
model = "deepseek-v4-flash"
model_provider = "ccx-bridge"

[model_providers.ccx-bridge]
name = "Local CCX Gateway"
base_url = "http://localhost:3000/v1"
env_key = "DEEPSEEK_API_KEY"

方案五：OpenRouter BYOK——无需本地服务

不想在本地运行任何服务？通过 OpenRouter 作为中间层：

[profiles.deepseek-openrouter]
model = "deepseek/deepseek-chat"
model_provider = "openrouter"

[model_providers.openrouter]
name = "OpenRouter"
base_url = "https://openrouter.ai/api/v1"
env_key = "OPENROUTER_API_KEY"

五种方案对比总结

方案	适用场景	上手难度	会话保持	需本地服务
Codex++	桌面端主流用户	⭐ 简单	⚠️ 切换可能丢失	是
EchoBird	频繁切换模型	⭐⭐ 中等	✅ 完整保持	是
CCX+CCSwitch	早期用户迁移	⭐⭐⭐ 复杂	⚠️ 不稳定	是
本地网关桥接	Codex CLI 用户	⭐⭐ 中等	N/A	是
OpenRouter BYOK	不想跑本地服务	⭐⭐ 中等	N/A	否

七、模型名映射：Codex 和 DeepSeek 的”翻译规则”

在协议转换过程中，模型名的映射也是一个容易踩坑的细节。Codex 在某些内部流程中会自动请求特定模型名，代理需要将其正确映射到 DeepSeek：

Codex 发出的模型名	映射为 DeepSeek 模型	用途
deepseek-v4-pro	透传	主对话
deepseek-v4-flash	透传	代码审查等轻量任务
gpt-5.4-mini	deepseek-v4-flash	Codex 内部触发的轻量任务