接入指南 › Codex CLI

DeepSeek 接入 Codex CLI 配置教程

结论：Codex 只支持 Responses API，DeepSeek 官方原生支持该协议，所以只需在 ~/.codex/config.toml 里加一个 wire_api = "responses" 的自定义 provider（base_url https://api.deepseek.com，模型 deepseek-flash 或 deepseek-v4-pro），并通过环境变量 DEEPSEEK_API_KEY 提供 Key。2026-10-17 我们在 codex-cli 0.163.0 上确认该配置可被解析并能请求到 DeepSeek 的 /responses 接口。

✓ 文档已核对2026-10-17 核对 Codex 配置参考与 DeepSeek Codex 接入文档

✓ 配置可解析codex-cli 0.163.0 实测：无 Key 时报「Missing environment variable: DEEPSEEK_API_KEY」，假 Key 时 DeepSeek 返回 401，均非解析错误

✓ Key 鉴权与模型 ID 已核对2026-10-17 用真实 Key 调用 GET /models 返回 200：deepseek-flash（DeepSeek-V4.1-Flash）、deepseek-v4-pro

✓ 文本调用通过2026-10-17 codex-cli 0.163.0 + deepseek-flash：codex exec 返回 OK（exit 0）

✓ 工具调用通过同次实测：Codex 在临时目录创建 proof.txt 并用 shell 读回，内容一致

适用范围

Codex 版本	codex-cli 0.163.0（npm 包 @openai/codex，2026-10-17 安装的最新版）
Key 类型	DeepSeek 开放平台 API Key（sk- 开头），按量计费 · 来源
协议	Responses API（Codex 只支持 wire_api = "responses"；DeepSeek 支持 POST /responses，无状态，需每次发送完整历史） · Codex config reference · DeepSeek Responses API
Base URL	`https://api.deepseek.com`
模型 ID	`deepseek-flash` (DeepSeek-V4.1-Flash) · `deepseek-v4-pro` (DeepSeek-V4-Pro-0813) · 价格页 · DeepSeek 价格专题
系统	实测环境 Linux x86_64；macOS / Windows 待验证

第 1 步：安装 Codex 并设置 Key

npm install -g @openai/codex
codex --version          # 本页基于 codex-cli 0.163.0
export DEEPSEEK_API_KEY="sk-..."   # 写进 ~/.bashrc 或 ~/.zshrc 以长期生效

第 2 步：写入 ~/.codex/config.toml

先备份： cp ~/.codex/config.toml ~/.codex/config.toml.bak 2>/dev/null

# ~/.codex/config.toml（用户级；项目级 .codex/config.toml 里的 model_provider 会被忽略）
model = "deepseek-flash"            # 或 "deepseek-v4-pro"
model_provider = "deepseek"
model_reasoning_effort = "high"
web_search = "disabled"             # 内置联网搜索仅 deepseek-v4-pro 可用
model_catalog_json = "~/.codex/models.json"   # 可选：DeepSeek 官方提供的模型元数据文件

[model_providers.deepseek]
name = "DeepSeek"
base_url = "https://api.deepseek.com"
wire_api = "responses"              # Codex 只支持 responses
env_key = "DEEPSEEK_API_KEY"

models.json（可选，去掉元数据警告）：内容较长，请从 DeepSeek 官方文档「Edit the Configuration File Manually」一节复制到 ~/.codex/models.json；不想用就删掉 model_catalog_json 那一行。 DeepSeek Codex 接入文档

DeepSeek 也提供一键配置脚本（会备份并改写配置），见其文档；本页只描述手动配置。

第 3 步：检查是否生效

codex exec --skip-git-repo-check "reply with OK"

成功：输出头部显示 model: deepseek-flash、provider: deepseek，随后模型回复 OK。
没设 Key：ERROR: Missing environment variable: `DEEPSEEK_API_KEY`（已实测）
Key 无效：unexpected status 401 Unauthorized … url: https://api.deepseek.com/responses（已实测）
写成 wire_api = "chat"：Error loading config.toml: wire_api = "chat" is no longer supported（已实测）

恢复默认

mv ~/.codex/config.toml.bak ~/.codex/config.toml   # 或删除上面添加的几行和 [model_providers.deepseek] 段
rm -f ~/.codex/models.json                         # 如果之前没有这个文件
unset DEEPSEEK_API_KEY

待验证

deepseek-v4-pro + web_search = "live"：待验证。
macOS / Windows、Codex IDE 插件和 ChatGPT 桌面端：待验证。
其他厂商（通义、Kimi、GLM 等）接入 Codex：待验证。

常见问题

Codex 能用 Chat Completions 接口接 DeepSeek 吗？

不能。Codex 配置参考写明 wire_api 只支持 "responses"；我们在 codex-cli 0.163.0 上把 wire_api 设为 "chat"，Codex 直接报错「wire_api = "chat" is no longer supported」。DeepSeek 官方支持 Responses API（POST https://api.deepseek.com/responses）。

用哪个模型 ID？

deepseek-flash（DeepSeek-V4.1-Flash，支持图片输入）或 deepseek-v4-pro（DeepSeek-V4-Pro-0813）。旧名 deepseek-v4-flash 仍可调用，但会由 V4.1 Flash 提供服务。

需要什么 Key？

DeepSeek 开放平台的 API Key（sk- 开头），按量计费；不需要 OpenAI 或 ChatGPT 账号。

env_key 和官方示例里的 experimental_bearer_token 有什么区别？

DeepSeek 文档示例把 Key 直接写进 experimental_bearer_token；Codex 配置参考标注该字段「不推荐，请用 env_key」。本页用 env_key 从环境变量读 Key，避免明文写入配置文件。两种写法都是官方文档中的字段。

出现「Model metadata for deepseek-flash not found」警告怎么办？

我们实测：不配 model_catalog_json 时 codex-cli 0.163.0 会给出该警告并使用后备元数据；按 DeepSeek 文档创建 ~/.codex/models.json 并配置 model_catalog_json 后，警告消失。

怎么恢复 Codex 默认配置？

把备份的 config.toml 拷回去（或删除本页添加的 model / model_provider / model_catalog_json 行和 [model_providers.deepseek] 段），再 unset DEEPSEEK_API_KEY。使用 DeepSeek 一键脚本的，可在脚本菜单选 9 恢复。

来源: Codex config reference · Codex advanced config · DeepSeek × Codex · DeepSeek Responses API guide · POST /responses · 核对日期 2026-10-17