如何在Codex中接入DeepSeek V4模型：OpenAI Codex CLI 配置第三方模型完整指南

如何在Codex中接入DeepSeek V4模型：OpenAI Codex CLI 配置第三方模型完整指南

上一篇我们讲了如何在 Claude Code 中接入 DeepSeek V4，这次轮到 Codex。OpenAI Codex CLI 同样支持配置第三方模型提供商，让你在不同模型间灵活切换，最大化性价比。

一、为什么要在 Codex 中接 DeepSeek？

如果你的主要工具是 Codex CLI，那么接 DeepSeek V4 的原因和 Claude Code 一样：

模型	输出价格 (每百万token)	日常编程一天的成本
GPT-5	$14-56	$3-15
GPT-4.1	$8	$1.5
DeepSeek V4	≈$0.55 (¥4)	≈$0.05 (¥0.4)

成本差异巨大。 日常写代码、改bug、加注释这些工作，DeepSeek V4 完成得非常好，没必要每次都用 GPT-5。

---

二、准备工作

在开始之前，请确保：

✅ Codex CLI 已安装（参考《Codex 小白入门教程》）

✅ 拥有 DeepSeek API Key（到 https://platform.deepseek.com 注册获取）

✅ 终端操作基础（会打开终端、运行命令即可）

---

三、配置方法

Codex CLI 支持通过配置文件或环境变量来接入第三方模型。DeepSeek 的 API 兼容 OpenAI 的接口格式，所以配置起来非常顺畅。

方法一：通过 Codex 配置文件（推荐）

Codex CLI 会在用户目录下生成配置文件。

步骤 1：找到 Codex 配置目录

# 查看 Codex 的配置路径
codex --help | grep config

一般在：
Windows: C:\Users\你的用户名\.codex\
Mac/Linux: ~/.codex/

步骤 2：创建或编辑配置文件

在配置目录下创建/编辑 config.json（或 settings.json，取决于 Codex 版本）：

{
  "modelProviders": {
    "deepseek": {
      "name": "DeepSeek",
      "apiBase": "https://api.deepseek.com/v1",
      "apiKey": "sk-你的DeepSeek密钥",
      "models": [
        {
          "id": "deepseek-chat",
          "name": "DeepSeek V4",
          "maxTokens": 8192,
          "contextWindow": 128000
        }
      ]
    }
  }
}

步骤 3：在 Codex 中使用 DeepSeek

# 启动时指定 DeepSeek 模型
codex --model deepseek/deepseek-chat

或者在对话中切换
/model deepseek/deepseek-chat

方法二：通过环境变量（简单直接）

如果你不想编辑配置文件，直接修改环境变量是最快的方式。

DeepSeek 的 API 完全兼容 OpenAI 接口格式，所以你只需要把 OpenAI 的 API 地址替换为 DeepSeek 的即可。

临时设置（仅当前终端窗口有效）：

Windows PowerShell:

$env:OPENAI_BASE_URL="https://api.deepseek.com/v1"
$env:OPENAI_API_KEY="sk-你的DeepSeek密钥"
codex

Mac/Linux:

export OPENAI_BASE_URL="https://api.deepseek.com/v1"
export OPENAI_API_KEY="sk-你的DeepSeek密钥"
codex

永久设置：

Windows:

Win+R → sysdm.cpl → 高级 → 环境变量

新建 OPENAI_BASE_URL = https://api.deepseek.com/v1

设置 OPENAI_API_KEY = 你的 DeepSeek Key

重启终端

Mac/Linux:

echo 'export OPENAI_BASE_URL="https://api.deepseek.com/v1"' >> ~/.zshrc
echo 'export OPENAI_API_KEY="sk-你的DeepSeek密钥"' >> ~/.zshrc
source ~/.zshrc

⚠️ 注意：这种方式会让 Codex 的所有请求都走 DeepSeek，如果你想同时保留 OpenAI 模型和 DeepSeek，用方法一（配置文件）更好。

方法三：使用自定义 Provider 脚本（Codex 高级功能）

如果你的 Codex 版本支持 --provider 参数：

# 方式A：直接通过命令行参数
codex --provider deepseek --model deepseek-chat

方式B：设置默认 provider
codex config set provider deepseek
codex config set model deepseek-chat

方法四：LiteLLM 统一代理（管理多个模型的终极方案）

如果你想同时使用 OpenAI、DeepSeek、Anthropic 等多个提供商的模型，LiteLLM 是最好的管理方案。

1. 安装 LiteLLM：

pip install litellm

2. 配置 codex_litellm.yaml：

model_list:
  - model_name: gpt-4.1
    litellm_params:
      model: openai/gpt-4.1
      api_key: sk-你的OpenAI密钥
  - model_name: deepseek-v4
    litellm_params:
      model: deepseek/deepseek-chat
      api_key: sk-你的DeepSeek密钥
  - model_name: claude-sonnet
    litellm_params:
      model: anthropic/claude-sonnet-4-20250514
      api_key: sk-ant-你的Anthropic密钥

3. 启动代理并连接 Codex：

# 终端1：启动代理
litellm --config codex_litellm.yaml --port 4000

终端2：设置 Codex 指向代理
export OPENAI_BASE_URL="http://localhost:4000/v1"
codex --model deepseek-v4

这样你就能在一个终端里随时切换任何模型，非常灵活！

---

四、验证配置

方法 1：让 AI 自报家门

你是什么模型？谁开发的？

如果回答说自己来自 DeepSeek，配置就成功了。

方法 2：检查 DeepSeek 控制台

登录 https://platform.deepseek.com → 查看 API 调用记录，如果有消费记录，说明 Codex 的请求确实到了 DeepSeek。

方法 3：快速代码测试

写一个函数检查字符串是否是回文，用 JavaScript

能正常生成代码就行。

---

五、Codex + DeepSeek 的最佳实践

任务分配策略

用 DeepSeek V4（省钱模式）：

• 🟢 日常 CRUD 代码编写
• 🟢 代码注释和文档生成
• 🟢 写单元测试
• 🟢 简单 bug 修复
• 🟢 代码格式化和重构
• 🟢 SQL 查询编写
• 🟢 学习新技术时提问

切回 GPT-4.1 / GPT-5（关键时刻）：

• 🔴 复杂系统架构设计
• 🔴 多文件级大型重构
• 🔴 疑难 bug 调试
• 🔴 安全审计
• 🔴 需要极强创意性的代码生成

切换命令速查

# 启动时指定
codex --model deepseek-v4          # 日常用 DeepSeek
codex --model gpt-4.1              # 复杂任务用 GPT-4.1

对话中切换（在 Codex 界面内）
/model deepseek-v4
/model gpt-4.1

---

六、常见问题排查

Q1: “invalid_api_key” 或认证失败？

原因：DeepSeek Key 格式和 OpenAI Key 格式不同，但接口兼容。

解决：

确认 Key 是否完整复制（没有多余空格）

在 DeepSeek 控制台确认 Key 状态为”有效”

确认账户余额 > 0

Q2: Codex 报 “model not found” ？

使用 DeepSeek 的模型名应该是 deepseek-chat（对应 V4）。如果 Codex 用的是 provider/model 格式，试试：

• deepseek/deepseek-chat
• 或直接用 deepseek-chat

Q3: 生成质量和 OpenAI 模型差距明显？

这是正常的。DeepSeek V4 在代码能力上接近 GPT-4.1，但确实存在差距。改善方法：

• 提问时给出更详细的需求描述
• 分步骤引导，不要一次要求太复杂
• 重要任务切回 GPT-4.1 / GPT-5

Q4: 请求经常超时或返回 429？

DeepSeek 在高峰期可能有服务压力。建议：

• 错峰使用（避开工作日上午 9-11 点）
• 在 Codex 中设置重试
• 使用 LiteLLM 方案做 failover（失败自动切备用模型）

Q5: 能否同时配 OpenAI 和 DeepSeek，随时切换？

可以。用方法一（配置文件方式），两个 provider 互不干扰。或者用 LiteLLM 方案，体验最流畅。

Q6: 代码安全吗？发给 DeepSeek 的代码会不会被泄露？

DeepSeek 的隐私政策表示 API 调用数据会按隐私协议处理。如果你处理核心商业代码，建议：

• 敏感项目只用官方模型（OpenAI/Anthropic 的企业版 API）
• 或者用本地部署的开源模型（如通过 Ollama）

---

七、总结：Codex + DeepSeek = 高性价比 AI 编程

接入 DeepSeek V4 后，你的 Codex 使用成本可以降低 80%-95%。日常写代码几乎感觉不到和 GPT-4.1 的差距，但价格差了 15-30 倍。

配置检查清单：

• [ ] DeepSeek 账号已注册 + API Key 已生成
• [ ] Codex 配置文件中添加了 DeepSeek provider
• [ ] 或环境变量 OPENAI_BASE_URL 已设置
• [ ] 已测试切换模型和代码生成
• [ ] DeepSeek 控制台能看到 API 调用记录

相关阅读：

• 📖 Codex 小白入门教程
• 🔗 Claude Code 接入 DeepSeek V4（上篇）
• ⚖️ Claude Code vs Codex 深度对比

有什么配置上的问题，欢迎在评论区交流！

---

免责声明：本文基于 2025 年 6 月的产品信息撰写。OpenAI Codex CLI 和 DeepSeek 平台的功能、定价可能变化，请以各自官方文档为准。本文由作者实测后撰写，AI 辅助编辑。