Codex 接入 DeepSeek 模型配置与使用教程

Thu, 06 Aug 2026 23:40:08 +0800

Codex 默认使用 OpenAI 自家模型，但 Codex 也支持配置「模型供应商（model provider）」来接入第三方模型。之前玩过 Claude Code 接 DeepSeek，体验尚可，最近发现 Codex 也支持类似配置了，这里就记录一下 Codex 下接入 DeepSeek 的配置姿势。

前置要求

已安装 Codex CLI：npm i -g @openai/codex
有 DeepSeek API Key，访问 https://platform.deepseek.com/api_keys 获取
Codex 需要 Plus 及以上会员或 API 付费用户

配置文件

Codex 的用户级配置文件位于 ~/.codex，创建新文件，比如 deepseek.config.toml（TOML 格式），在该文件中添加 DeepSeek 作为模型供应商：

model = "deepseek-v4-pro"
model_provider = "deepseek"

[model_providers.deepseek]
name = "DeepSeek"
base_url = "https://api.deepseek.com"
env_key = "DEEPSEEK_API_KEY"
wire_api = "responses"

[tui.model_availability_nux]
"gpt-5.5" = 4
"gpt-5.6-sol" = 4

说明：

base_url：DeepSeek 的 API 端点，与 OpenAI 兼容
DEEPSEEK_API_KEY：指定从哪个环境变量读取 API Key
wire_api：使用 "responses" 协议（OpenAI 兼容方式）

配置 API Key

在 ~/.zshrc 或 ~/.bashrc 中添加：

export DEEPSEEK_API_KEY="sk-xxxxxxxxxxxxxxxxxxxxxxxx"

然后 source ~/.zshrc 使配置生效。

使用

配置完成后，通过 --profile 参数指定使用 DeepSeek：

codex --profile deepseek --dangerously-bypass-approvals-and-sandbox

启动后 Codex 就会走 DeepSeek 的模型。如果想用回 OpenAI 默认模型，不带 --profile 参数即可：

codex

灵活切换 - alias 快捷命令

每次敲 --profile deepseek 有点麻烦，可以在 Shell 配置中定义 alias：

alias codexds="codex --profile deepseek"

之后终端输入 codexds 即启动 DeepSeek 版 Codex，输入 codex 则为默认 OpenAI 版，不用来回改配置。

实际体验

速度：DeepSeek 响应速度不错，日常编码任务够用
价格：DeepSeek API 价格远低于 OpenAI 官价，适合额度紧张时作为补充
代码质量：简单到中等复杂度任务表现可以，复杂逻辑建议切回默认模型

写在最后

Codex 的 model provider 机制让接入第三方模型变得很方便，相比之前 Claude Code 接 DeepSeek 需要迂回设置 ANTHROPIC_BASE_URL，Codex 这套 TOML 配置方式更直觉。如果你 Codex 额度不够用了，又觉得 Claude Code 太贵，试试 DeepSeek 作为补充方案是个不错的选择。

DeepSeek | 进击之路 - Alan的个人博客