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 中执行： 运行后按菜单选择操作：第 1 项为修改 Codex 配置，使用 deepseek-flash 模型，该模型同时支持 图片输入 ；第 2 项为使用 deepseek-v4-pro 模型；第 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] 配置段，在 [desktop] 配置段中写入 enabled-reasoning-efforts （原有 [desktop] 段中的其他设置保留）；你原有的 MCP 服务器、项目信任级别等配置全部保留。若存在与 DeepSeek 配置冲突的字段，脚本会删除它们，并逐条打印删除原因。 校验 ：写入前校验 config.toml / models.json 语法合法；校验失败则中止，不修改任何文件。 再次运行脚本，可以重新写入配置（菜单第 1 / 2 项），或恢复到安装前的默认配置（菜单第 9 项）。重新运行菜单第 1 / 2 项，还会补齐新版脚本新增的配置项（如 show_raw_agent_reasoning 、推理强度档位），其他配置不受影响。如果此前用旧版本脚本装过 deepseek-v4-flash / deepseek-v4-flash-vision-exp 这几个条目，重新运行脚本会将它们一并清理，只保留 deepseek-flash 和 deepseek-v4-pro 。 内置联网搜索仅支持 deepseek-v4-pro ，一键脚本默认将其禁用。开启方法见下文 联网搜索 。 首先，创建模型目录文件 ~/.codex/models.json ，向 Codex 声明 DeepSeek 模型的元数据。文件内容如下（与一键脚本写入的内容一致，包含 deepseek-flash 和 deepseek-v4-pro 两个模型）。其中 deepseek-flash 的 input_modalities 包含 image ，Codex 正是据此判断该模型可以接收图片： 然后，编辑 Codex 配置文件 ~/.codex/config.toml （不存在则新建），添加以下内容。其中 experimental_bearer_token 填入你的 API Key（在 DeepSeek Platform 获取）：

如果 config.toml 中已有 [desktop] 配置段，请把 enabled-reasoning-efforts 加到该段里，不要再新建一个 [desktop] ——重复的配置段会导致文件不合法。 config.toml 字段说明 ​ Codex 内置的联网搜索仅在使用 deepseek-v4-pro 时可用。一键脚本会写入 web_search = "disabled" ；如需使用联网搜索，请在运行脚本后将该字段改为 "live" 。上方示例配置默认使用 deepseek-flash ，因此同样禁用了联网搜索。 如需启用联网搜索，请切换到 deepseek-v4-pro ，并在 ~/.codex/config.toml 中将 web_search 设为 "live" ： 保存后重启 Codex。搜索由 DeepSeek 在服务端执行，请求按 Search 接口的 计费规则 计费。 配置完成后，Codex CLI、ChatGPT 桌面端、VS Code 的 Codex 插件都会读取同一份配置文件，无需分别配置： Codex CLI ：进入项目目录，执行 codex 命令。启动信息中显示 model: deepseek-flash 即为生效。 cd /path/to/my-project codex Codex CLI ：进入项目目录，执行 codex 命令。启动信息中显示 model: deepseek-flash 即为生效。 ChatGPT 桌面端 ：模型选择器显示「自定义」或所选模型名（如「DeepSeek-Flash」），都算配置已生效——显示哪种取决于 ChatGPT 版本。显示模型名时，可直接在客户端里切换模型；显示「自定义」时，实际使用的就是 deepseek-flash 。 ChatGPT 桌面端 ：模型选择器显示「自定义」或所选模型名（如「DeepSeek-Flash」），都算配置已生效——显示哪种取决于 ChatGPT 版本。显示模型名时，可直接在客户端里切换模型；显示「自定义」时，实际使用的就是 deepseek-flash 。 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 字段说明