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 用户在终端中执行： Windows 用户在 PowerShell 中执行： 运行后按菜单选择要使用的模型： deepseek-v4-flash （第 1 项）、 deepseek-v4-pro （第 2 项）、 deepseek-v4-flash-vision-exp （第 3 项，额外支持 图片输入 ）；第 9 项为恢复默认的 Codex 配置，删除 deepseek 相关配置。首次运行会提示输入 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 语法合法；校验失败则中止，不修改任何文件。 再次运行脚本，可以在菜单中切换模型，或恢复到安装前的默认配置（菜单第 9 项）。

首先，创建模型目录文件 ~/.codex/models.json ，向 Codex 声明 DeepSeek 模型的元数据。文件内容如下（与一键脚本写入的内容一致，包含 deepseek-v4-flash 、 deepseek-v4-pro 、 deepseek-v4-flash-vision-exp 三个模型）。其中 deepseek-v4-flash-vision-exp 的 input_modalities 包含 image ，Codex 正是据此判断该模型可以接收图片： 然后，编辑 Codex 配置文件 ~/.codex/config.toml （不存在则新建），添加以下内容。其中 experimental_bearer_token 填入你的 API Key（在 DeepSeek Platform 获取）： config.toml 字段说明 ​ 配置完成后，Codex CLI、ChatGPT 桌面端、VS Code 的 Codex 插件都会读取同一份配置文件，无需分别配置： Codex CLI ：进入项目目录，执行 codex 命令。启动信息中显示 model: deepseek-v4-flash （或你选择的模型）即为生效。 cd /path/to/my-project codex Codex CLI ：进入项目目录，执行 codex 命令。启动信息中显示 model: deepseek-v4-flash （或你选择的模型）即为生效。 ChatGPT 桌面端 ：Mac 端模型选择器中显示「自定义」即为生效；Windows 端可能显示「自定义」或「DeepSeek-V4-Flash」。显示为「自定义」时，实际使用的就是你选择的 DeepSeek 模型。 ChatGPT 桌面端 ：Mac 端模型选择器中显示「自定义」即为生效；Windows 端可能显示「自定义」或「DeepSeek-V4-Flash」。显示为「自定义」时，实际使用的就是你选择的 DeepSeek 模型。 VS Code 的 Codex 插件（Codex IDE extension） ：与 Codex CLI 共用同一份配置，安装插件后即可直接使用。 VS Code 的 Codex 插件（Codex IDE extension） ：与 Codex CLI 共用同一份配置，安装插件后即可直接使用。 切换到 DeepSeek 后，如果发现之前的历史会话不见了，无需担心——它们并没有被删除。Codex 会按登录方式分组存放会话记录：使用 ChatGPT 官方订阅产生的会话与使用第三方 API（如 DeepSeek）产生的会话分属两组，界面上只显示与当前配置匹配的一组。恢复原配置（例如通过一键脚本菜单第 9 项）即可重新看到之前的会话，此时 DeepSeek 的会话会被隐藏。切换后需重启 ChatGPT 客户端才会生效。 1. 将 DeepSeek 配置为模型提供方 方式一：一键配置脚本（推荐） 方式二：手动编辑配置文件 config.toml 字段说明 config.toml 字段说明