导读：OpenAI Codex 是一款强大的 AI 编程助手，但官方模型价格不菲。DeepSeek V4 作为国产大模型的新星，不仅性能强悍，价格更是只有 GPT 系列的十分之一。本文将手把手教你如何在 Codex 桌面版中接入 DeepSeek 模型。
一、为什么选择 DeepSeek？
DeepSeek V4 发布后，在多项基准测试中表现亮眼：
• 性价比极高：DeepSeek V4 Flash 输入仅 $0.27/百万 tokens，缓存命中低至 $0.07/百万
• 性能强悍：编程任务表现出色，推理能力接近 Claude Opus 4.6
• 双协议支持：同时兼容 OpenAI 和 Anthropic 两种 API 格式
价格对比：
|
|
|
|
|---|---|---|
💡 选择 DeepSeek V4 Flash 可以节省 90% 以上的成本！
二、核心问题：协议不兼容
Codex 新版本（v0.81.0 及以上）使用的是 OpenAI Responses API，而 DeepSeek 官方 API 使用的是 Chat Completions API。这两个协议不兼容，直接配置会导致工具调用失败。
具体表现：
• 工具调用报错：insufficient tool messages following tool_calls message
• 推理模型报错：Missing reasoning_content field
解决方案：需要一个「中间代理层」，将 Codex 发出的 Responses API 请求转换为 DeepSeek 能理解的 Chat Completions API 请求。
目前主要有三种解决方案：
1. Moon Bridge - 官方推荐的 Go 语言代理。社区开发者维护。功能更全。
2. CCX：配置简单
3. Codex-bridge：轻量方案
三、方案一：Moon Bridge（官方推荐）
Moon Bridge 是 DeepSeek 官方文档中推荐的开源代理方案，功能完整，支持 V4 的推理模式扩展。
3.1 环境准备
• Node.js 18+（下载地址）
• Go 1.25+（下载地址）
• Codex CLI（安装命令：npm install -g @openai/codex）
3.2 获取 DeepSeek API Key
第一步：访问 DeepSeek 开放平台
第二步：注册或登录账号
第三步：进入 API Keys 管理页面
第四步：点击「创建 API Key」，复制并妥善保存
3.3 克隆项目并配置
打开命令行终端，执行以下命令克隆项目：
git clone https://github.com/ZhiYi-R/moon-bridge.git
cd moon-bridge
在项目目录下创建 config.yml 配置文件：
mode: "Transform"
server:
addr: "127.0.0.1:38440"
provider:
providers:
deepseek:
base_url: "https://api.deepseek.com/anthropic"
api_key: "sk-你的DeepSeek密钥"
models:
deepseek-v4-pro:
context_window: 1000000
max_output_tokens: 384000
extensions:
deepseek_v4:
enabled: true
default_reasoning_level: "high"
routes:
moonbridge:
to: "deepseek/deepseek-v4-pro"
default_model: "moonbridge"
3.4 启动代理服务
在终端中运行：
go run ./cmd/moonbridge --config config.yml
代理默认监听 127.0.0.1:38440，保持终端窗口打开。
3.5 生成 Codex 配置文件
打开另一个终端，在 moon-bridge 目录下执行：
CODEX_HOME_DIR="${CODEX_HOME:-$HOME/.codex}"
mkdir -p "$CODEX_HOME_DIR"
MODEL="$(go run ./cmd/moonbridge --config config.yml --print-codex-model)"
go run ./cmd/moonbridge \
--config config.yml \
--print-codex-config "$MODEL" \
--codex-base-url "http://127.0.0.1:38440/v1" \
--codex-home "$CODEX_HOME_DIR" \
> "$CODEX_HOME_DIR/config.toml"
这会在 ~/.codex/ 目录下生成 config.toml 和 models_catalog.json 文件。
3.6 启动 Codex
cd /path/to/your-project
CODEX_HOME="$HOME/.codex" codex --cd "$PWD"
现在 Codex 会通过 Moon Bridge 将请求转发到 DeepSeek V4。
四、方案二：用CCX（最简单）
4.1 下载地址
Windows：ccx: https://pan.quark.cn/s/2d43ca4e5aef Switch: https://pan.quark.cn/s/57b769c2ff0b
Mac：ccx: https://pan.quark.cn/s/b8a553da956c Switch: https://pan.quark.cn/s/d9cd3eb9ce31
Linux：ccx: https://pan.quark.cn/s/dc582154254e Switch: https://pan.quark.cn/s/a6b587a76c8c
4.2 解压并配置API Key FDEVpY1RmT0RVdkxVZ1hrZXNHcHNRTGszdVhRc0JLbmhTcURJV2lhYzhpY0VPSXVONWNCcnFNUk5FZTJjaWM1TjJXdTAvNjQwP3d4X2ZtdD1wbmcmYW1w;from=appmsg" class="rich_pages wxw-img" data-ratio="0.33464052287581697" data-s="300,640" data-type="png" data-w="765" type="block" data-imgfileid="100001215" data-aistatus="1">解压后找到.env文件填上API Key即可。API地址填 https://api.deepseek.com
4.3 启动代理程序
因为Codex只支持OpenAI自家的模型。想用DeepSeek， 加一个翻译官——本地代理。Codex发的是Responses请求，代理翻译成Chat补全请求发给DeepSeek，再把结果翻译回来。
4.1 下载地址
Windows：ccx: https://pan.quark.cn/s/2d43ca4e5aef Switch: https://pan.quark.cn/s/57b769c2ff0b
Mac：ccx: https://pan.quark.cn/s/b8a553da956c Switch: https://pan.quark.cn/s/d9cd3eb9ce31
Linux：ccx: https://pan.quark.cn/s/dc582154254e Switch: https://pan.quark.cn/s/a6b587a76c8c
4.2 解压并配置API Key FDEVpY1RmT0RVdkxVZ1hrZXNHcHNRTGszdVhRc0JLbmhTcURJV2lhYzhpY0VPSXVONWNCcnFNUk5FZTJjaWM1TjJXdTAvNjQwP3d4X2ZtdD1wbmcmYW1w;from=appmsg" class="rich_pages wxw-img" data-ratio="0.33464052287581697" data-s="300,640" data-type="png" data-w="765" type="block" data-imgfileid="100001215" data-aistatus="1">解压后找到.env文件填上API Key即可。API地址填 https://api.deepseek.com
4.3 启动代理程序
因为Codex只支持OpenAI自家的模型。想用DeepSeek， 加一个翻译官——本地代理。Codex发的是Responses请求，代理翻译成Chat补全请求发给DeepSeek，再把结果翻译回来。
五、方案三：codex-bridge（轻量方案）
如果你更喜欢 Node.js 生态，codex-bridge 是个更轻量的选择。
5.1 克隆项目
git clone https://github.com/wujfeng712-ui/codex-bridge.git ~/.codex/codex-bridge
cd ~/.codex/codex-bridge
5.2 创建环境变量文件
在项目目录下创建 .env 文件：
# DeepSeek API 密钥
DEEPSEEK_API_KEY=sk-你的DeepSeek密钥
# 可用模型列表
DEEPSEEK_MODELS=deepseek-v4-pro,deepseek-v4-flash,deepseek-reasoner
# 默认供应商
DEFAULT_PROVIDER=deepseek
# 日志级别
LOG_LEVEL=info
5.3 配置 Codex
编辑 ~/.codex/config.toml 文件：
[model_providers.deepseek_proxy]
name = "DeepSeek Proxy"
base_url = "http://127.0.0.1:4000/v1"
env_key = "DEEPSEEK_API_KEY"
wire_api = "responses"
[profiles.deepseek_pro]
model = "deepseek-v4-pro"
model_provider = "deepseek_proxy"
[profiles.deepseek_flash]
model = "deepseek-v4-flash"
model_provider = "deepseek_proxy"
5.4 启动代理
cd ~/.codex/codex-bridge
node index.js
代理默认监听 127.0.0.1:4000。
5.5 启动 Codex
codex --profile deepseek_flash
六、常见问题排查
1. 连接被拒绝（connection refused）
→ 检查代理服务是否正在运行，确认端口配置一致
2. Codex 无法看到 DeepSeek 模型
→ 重新运行配置生成步骤，确保 models_catalog.json 存在于 CODEX_HOME 目录
3. 认证错误（401 Unauthorized）
→ 检查 DeepSeek API Key 是否正确，确认账户余额充足
4. 工具调用失败
→ 确认使用的是代理方案而非直连。DeepSeek 不支持 Responses API，必须通过代理转换
5. 图片输入失败
→ Moon Bridge 的图片功能需要单独配置视觉模型提供商，或在配置中禁用 visual
七、最佳实践建议
经过实际使用，推荐以下分工策略：
复杂架构设计、大规模重构 → Claude Opus 4.6 / GPT-5.4
问题定义不清晰时需要更强的推理能力
日常代码编写、格式化、测试 → DeepSeek V4 Flash
质量足够，成本极低
意图识别、日志分类 → DeepSeek V4 Flash + 缓存
缓存命中率高，成本最低
八、总结
Codex 桌面版接入 DeepSeek 模型的核心在于解决协议兼容问题。
选择建议：
• 新手入门：推荐用CCX，配置简单
• 追求稳定：推荐 Moon Bridge，官方支持
📌 参考资料
• DeepSeek 官方文档：api-docs.deepseek.com
• Moon Bridge 项目：github.com/ZhiYi-R/moon-bridge
• codex-bridge 项目：github.com/wujfeng712-ui/codex-bridge
• CliGate 项目：github.com/codeking-ai/cligate
• OpenAI Codex CLI：github.com/openai/codex
