接入 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 项）。
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 客户端才会生效。