接入 Codex CLI

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 项）。