Codex: Codex 接入 DeepSeek
最后更新：2026-08-31
DeepSeek 是国内领先的大语言模型，在代码生成方面表现优秀。本节介绍如何在 Codex 中使用 DeepSeek 模型。
📋 前置知识：已完成 Codex CLI 安装，了解基本 API Key 配置
1. 你将学到
- 为什么在 Codex 中使用 DeepSeek
- 官方接入方式
- CCSwitch 第三方工具配置
- DeepSeek 模型 vs OpenAI 模型对比
2. 为什么使用 DeepSeek
| 优势 | 说明 |
|---|---|
| 成本更低 | DeepSeek API 价格远低于 OpenAI |
| 国内网络 | 无需代理即可访问 |
| 代码能力强 | DeepSeek Coder 在代码任务上表现出色 |
| 中文支持好 | 中文理解与生成质量高 |
(1) 价格对比
| 模型 | 输入价格 | 输出价格 |
|---|---|---|
| GPT-5 Codex | $2.50/1M tokens | $10.00/1M tokens |
| DeepSeek V3 | ¥1.00/1M tokens | ¥2.00/1M tokens |
| DeepSeek Coder | ¥1.00/1M tokens | ¥2.00/1M tokens |
3. 官方接入方式
Codex CLI 支持通过 OpenAI 兼容 API 接入 DeepSeek。
(1) 获取 DeepSeek API Key
TEXT
📖 仅展示
1. 访问 platform.deepseek.com
2. 注册/登录账号
3. 进入 API Keys 页面
4. 创建新的 API Key
5. 复制保存（只显示一次）
(2) 配置环境变量
BASH
# macOS/Linux
export OPENAI_API_KEY="sk-你的DeepSeek密钥"
export OPENAI_BASE_URL="https://api.deepseek.com"
# Windows PowerShell
$env:OPENAI_API_KEY="sk-你的DeepSeek密钥"
$env:OPENAI_BASE_URL="https://api.deepseek.com"
# 永久配置（添加到 ~/.zshrc 或 ~/.bashrc）
echo 'export OPENAI_API_KEY="sk-你的DeepSeek密钥"' >> ~/.zshrc
echo 'export OPENAI_BASE_URL="https://api.deepseek.com"' >> ~/.zshrc
source ~/.zshrc
(3) 启动 Codex
BASH
# 指定 DeepSeek 模型启动
codex --model deepseek-coder
# 或使用 DeepSeek V3
codex --model deepseek-chat
▶ 示例 1: Alice 切换到 DeepSeek
BASH
# Alice 想节省成本，切换到 DeepSeek
export OPENAI_API_KEY="sk-deepseek-xxx"
export OPENAI_BASE_URL="https://api.deepseek.com"
cd my-project
codex --model deepseek-coder
# Alice 输入：
> "为 auth 模块添加 OAuth2 支持"
# DeepSeek Coder 正常执行任务
4. CCSwitch 工具
CCSwitch 是社区开发的第三方工具，可以在不同模型提供商之间快速切换。
(1) 安装 CCSwitch
BASH
npm install -g ccswitch
(2) 配置模型提供商
BASH
# 添加 DeepSeek 配置
ccswitch add deepseek \
--api-key "sk-你的DeepSeek密钥" \
--base-url "https://api.deepseek.com" \
--model "deepseek-coder"
# 添加 OpenAI 配置
ccswitch add openai \
--api-key "sk-你的OpenAI密钥" \
--base-url "https://api.openai.com/v1" \
--model "gpt-5-codex"
(3) 快速切换
BASH
# 切换到 DeepSeek
ccswitch use deepseek
# 切换到 OpenAI
ccswitch use openai
# 查看当前配置
ccswitch current
▶ 示例 2: Bob 的多模型工作流
BASH
# 日常开发用 DeepSeek（省钱）
ccswitch use deepseek
codex "修复登录页面的 CSS 问题"
# 复杂架构任务用 OpenAI（更强）
ccswitch use openai
codex "设计微服务拆分方案，生成架构文档"
# 代码审查用 DeepSeek Coder
ccswitch use deepseek
codex "审查 PR #15 的代码质量"
5. DeepSeek vs OpenAI 模型对比
| 维度 | DeepSeek Coder | GPT-5 Codex |
|---|---|---|
| 代码生成 | 优秀 | 优秀 |
| 复杂推理 | 良好 | 更强 |
| 中文理解 | 更好 | 良好 |
| 成本 | 低 | 高 |
| 响应速度 | 快 | 快 |
| 多文件重构 | 良好 | 更强 |
6. auth.json 配置
也可以通过配置文件管理多个 API Key：
JSON
{
"OPENAI_API_KEY": "sk-你的DeepSeek密钥",
"OPENAI_BASE_URL": "https://api.deepseek.com",
"model": "deepseek-coder"
}
BASH
# 写入配置
mkdir -p ~/.codex
cat > ~/.codex/auth.json << 'EOF'
{
"OPENAI_API_KEY": "sk-deepseek-xxx",
"OPENAI_BASE_URL": "https://api.deepseek.com"
}
EOF
7. 注意事项
| 注意点 | 说明 |
|---|---|
| API 兼容性 | DeepSeek API 兼容 OpenAI 格式，但部分高级特性可能不支持 |
| 模型名称 | 使用 deepseek-coder 或 deepseek-chat，不是 gpt-* |
| Base URL | 必须设置 OPENAI_BASE_URL 指向 DeepSeek 端点 |
| 切换回 OpenAI | 记得清除 OPENAI_BASE_URL 环境变量 |
| 额度 | DeepSeek 新用户有免费额度，注意查看余额 |
❓ 常见问题
Q DeepSeek 能完全替代 OpenAI 模型吗？
A 日常开发任务基本可以，但复杂架构推理和多文件全局重构方面，OpenAI 模型仍然更强。建议按任务复杂度选择。
Q CCSwitch 安全吗？
A CCSwitch 是开源社区工具，API Key 存储在本地配置文件中。建议检查其源码确认安全性。
Q 可以同时用两个模型吗？
A 不能在同一会话中切换模型。需要结束当前会话，切换配置后重新启动。
Q DeepSeek 的上下文窗口够大吗？
A DeepSeek V3 支持 128K 上下文，与 OpenAI 模型相当，对大多数项目足够。
Q 切换模型后 Codex 的行为会变吗？
A 基本操作不变，但不同模型的推理能力和输出风格会有差异。DeepSeek 中文理解更好，OpenAI 复杂推理更强。
📖 小节
- 通过
OPENAI_BASE_URL环境变量可接入 DeepSeek - CCSwitch 工具实现多模型快速切换
- DeepSeek 成本更低、中文更好，适合日常开发
- 复杂架构任务建议仍用 OpenAI 模型
- 切换模型需重启 Codex 会话
📝 作业
- 基础题（难度⭐）：配置 DeepSeek API 并成功在 Codex CLI 中使用。
- 进阶题（难度⭐⭐）：用 CCSwitch 配置两个模型提供商，对比同一任务在两个模型下的表现。
- 挑战题（难度⭐⭐⭐）：设计一个自动切换策略——简单任务用 DeepSeek、复杂任务用 OpenAI，编写切换脚本。
