API文档：Deepseek API 接入 Codex部署教程

博客文章2周前更新 Guyahn

13 0

目前仅 deepseek-v4-flash 支持接入 Codex，deepseek-v4-pro 预计 2026 年 8 月初支持接入 Codex。

Codex 是 OpenAI 推出的 AI 编程助手，通过 Responses API 与模型交互，DeepSeek API 原生支持该格式。

Codex 的各个客户端形态——Codex CLI、ChatGPT 桌面端、VS Code 的 Codex 插件（Codex IDE extension）——共用同一份配置文件，按本文配置一次，即可在所有形态使用 DeepSeek 模型。

1. 将 DeepSeek 配置为模型提供方

方式一：一键配置脚本（推荐）

我们提供了一键配置脚本，自动完成全部配置。运行前请确保已安装 Codex CLI 或 ChatGPT 桌面端，并至少运行过一次（即 ~/.codex 目录已存在）。

macOS / Linux 用户在终端中执行：

bash <(curl -fsSL https://cdn.deepseek.com/api-docs/codex-deepseek-setup.sh)

Windows 用户在 PowerShell 中执行：

irm https://cdn.deepseek.com/api-docs/codex-deepseek-setup-en.ps1 | iex

运行后按菜单选择要使用的模型。首次运行会提示输入 API Key（以 sk- 开头，在 DeepSeek Platform 获取）。

脚本会依次完成以下工作：

备份现有配置：将 ~/.codex/config.toml 备份到 ~/.codex/backup-deepseek/，随时可以还原。
写入模型目录 ~/.codex/models.json：向 Codex 声明 DeepSeek 模型的元数据（上下文窗口长度、支持的推理强度档位、工具调用格式等），使 Codex 能像使用内置模型一样使用 DeepSeek 模型。
修改 ~/.codex/config.toml：只改写必要的字段（见下文字段说明），并新增 [model_providers.deepseek] 配置段；你原有的 MCP 服务器、项目信任级别等配置全部保留。若存在与 DeepSeek 配置冲突的字段，脚本会删除它们，并逐条打印删除原因。
校验：写入前校验 config.toml / models.json 语法合法；校验失败则中止，不修改任何文件。

再次运行脚本，可以在菜单中切换模型，或恢复到安装前的默认配置（菜单第 3 项）。

方式二：手动编辑配置文件

首先，创建模型目录文件 ~/.codex/models.json，向 Codex 声明 DeepSeek 模型的元数据。文件内容如下（与一键脚本写入的内容一致，包含 deepseek-v4-flash 与 deepseek-v4-pro 两个模型）：

点击展开 models.json 完整内容

然后，编辑 Codex 配置文件 ~/.codex/config.toml（不存在则新建），添加以下内容。其中 experimental_bearer_token 填入你的 API Key（在 DeepSeek Platform 获取）：

model = "deepseek-v4-flash"
model_provider = "deepseek"
preferred_auth_method = "apikey"
forced_login_method = "api"
model_reasoning_effort = "high"
model_catalog_json = "~/.codex/models.json"

[model_providers.deepseek]
name = "deepseek"
base_url = "https://api.deepseek.com/"
wire_api = "responses"
experimental_bearer_token = "<你的 DeepSeek API Key>"

config.toml 字段说明

字段	作用
`model`	默认使用的模型
`model_provider`	使用的模型提供方，对应下方 `[model_providers.<id>]` 配置段的 id
`preferred_auth_method`、`forced_login_method`	使用 API Key 认证，跳过 ChatGPT 账号登录
`model_reasoning_effort`	推理强度。值越高，模型思考越深入，回答质量越高，耗时也越长
`model_catalog_json`	自定义模型目录文件（`models.json`）的路径，Codex 从中读取模型元数据
`[model_providers.deepseek]` 中的 `name`	模型提供方的显示名称
`[model_providers.deepseek]` 中的 `base_url`	DeepSeek API 的接口地址
`[model_providers.deepseek]` 中的 `wire_api`	与模型通信使用的协议，`"responses"` 表示 Responses API
`[model_providers.deepseek]` 中的 `experimental_bearer_token`	你的 API Key，直接写在配置文件里

2. 开始使用

配置完成后，Codex CLI、ChatGPT 桌面端、VS Code 的 Codex 插件都会读取同一份配置文件，无需分别配置：

Codex CLI：进入项目目录，执行 codex 命令。启动信息中显示 model: deepseek-v4-flash（或你选择的模型）即为生效。
```
cd /path/to/my-project
codex
```
ChatGPT 桌面端：Mac 端模型选择器中显示「自定义」即为生效；Windows 端可能显示「自定义」或「DeepSeek-V4-Flash」。显示为「自定义」时，实际使用的就是你选择的 DeepSeek 模型。
VS Code 的 Codex 插件（Codex IDE extension）：与 Codex CLI 共用同一份配置，安装插件后即可直接使用。

切换提供方后的历史会话

切换到 DeepSeek 后，如果发现之前的历史会话不见了，无需担心——它们并没有被删除。Codex 会按登录方式分组存放会话记录：使用 ChatGPT 官方订阅产生的会话与使用第三方 API（如 DeepSeek）产生的会话分属两组，界面上只显示与当前配置匹配的一组。恢复原配置（例如通过一键脚本菜单第 3 项）即可重新看到之前的会话，此时 DeepSeek 的会话会被隐藏。切换后需重启 ChatGPT 客户端才会生效。