Codex 是 OpenAI 的编程助手,它通过 Responses API 与模型通信,而 DeepSeek API 原生支持该协议,因此可以把 Codex 的模型提供商切换为 DeepSeek。配置只需改一次——Codex CLI、ChatGPT 桌面版与 VS Code 的 Codex 扩展共用同一份 ~/.codex/config.toml。本文整理一键脚本与手动配置两种方法、字段说明、生效验证与常见报错排查。 Codex接入DeepSeek的前置条件与文件位置
动手前先确认三件事:
- 已安装 Codex:Codex CLI 或 ChatGPT 桌面版需安装并至少启动过一次,以生成 ~/.codex 目录。
- 已获取 DeepSeek API Key:在 DeepSeek 开放平台(platform.deepseek.com/api_keys)创建,格式为 sk- 开头。
- 知道配置写在哪:用户级配置为 ~/.codex/config.toml(Windows 为 %USERPROFILE%\.codex\config.toml);项目级配置为项目目录下的 .codex/config.toml,优先级更高。
注意区分:Codex 与 DeepSeek 之间走的是 Responses API(配置项 wire_api = "responses"),这正是 DeepSeek 原生支持的协议,也是能否跑通的关键。三个客户端(Codex CLI、ChatGPT 桌面版、VS Code 扩展)共享同一份配置,改一次即可全部生效。
Codex接入DeepSeek的配置步骤
方法一:一键脚本(官方推荐)
- 确保 Codex CLI 或 ChatGPT 桌面版已安装并启动过一次;
- macOS / Linux 在终端执行:bash <(curl -fsSL https://cdn.deepseek.com/api-docs/codex-deepseek-setup-en.sh);Windows 在 PowerShell 执行:irm https://cdn.deepseek.com/api-docs/codex-deepseek-setup-en.ps1 | iex;
- 首次运行按提示输入 API Key(sk- 开头);
- 按菜单选择:1 = 配置 deepseek-flash(支持图片输入),2 = 配置 deepseek-v4-pro,9 = 恢复默认 Codex 配置;
- 关键提示:脚本会先把原 config.toml 备份到 ~/.codex/backup-deepseek/,再写入 models.json 与 config.toml,并在写入前校验语法(校验失败则不修改任何文件);你原有的 MCP 配置与项目信任设置都会保留。
方法二:手动编辑配置文件
- 创建模型目录文件 ~/.codex/models.json,其内容从 DeepSeek 官方文档复制(声明 DeepSeek 模型的上下文窗口、支持的推理档位、工具调用格式等元数据,使 Codex 能像内置模型一样调用);其中 deepseek-flash 的 input_modalities 含 image,用于开启图片输入;
- 编辑(不存在则新建)~/.codex/config.toml,写入以下官方配置:
- 把 experimental_bearer_token 换成你自己的 DeepSeek API Key;
- 关键提示:base_url 用 https://api.deepseek.com/(Codex 官方配置不带 /v1);wire_api 必须是 "responses",写成 "chat" 或加 /v1 都可能无法正常工作;
支持的DeepSeek模型与配置字段说明
当前官方支持接入 Codex 的 DeepSeek 模型如下(以 DeepSeek 官方文档为准):
说明:新版一键脚本会移除旧版写入的 deepseek-v4-flash / deepseek-v4-flash-vision-exp 条目,仅保留 deepseek-flash 与 deepseek-v4-pro。若你此前用过旧脚本,重跑一次即可更新。
config.toml 主要字段含义:
| |
|---|
| |
| 使用的模型提供商,需与 [model_providers.<id>] 段一致 |
preferred_auth_method / forced_login_method | 用 API Key 认证,跳过 ChatGPT 账号登录 |
| |
| 内置联网搜索,DeepSeek 模型下设为 disabled |
| |
| |
| |
| 通信协议,responses 即 Responses API |
experimental_bearer_token | |
配置是否生效的验证方式
- Codex CLI:进入项目目录运行 codex,若启动横幅显示 model: deepseek-flash,说明配置已生效。
- ChatGPT 桌面版:模型选择器显示「Custom」或所选模型名(如 DeepSeek-Flash)都表示已生效;显示 Custom 时实际使用的即为 deepseek-flash。
- VS Code 的 Codex 扩展:与 Codex CLI 共用同一份配置,安装扩展即可使用,无需单独配置。
提示:切换提供商后,若发现此前的会话「不见了」,并非数据被删除。Codex 按登录方式分组存储会话——官方 ChatGPT 订阅创建的会话与第三方 API(如 DeepSeek)创建的会话相互隔离,只会显示与当前配置匹配的那一组。恢复原配置(如脚本菜单选项 9)即可找回旧会话,切换后重启 ChatGPT 客户端生效。
Codex接入DeepSeek常见报错与排查
- 启动横幅未显示 deepseek-flash:配置未生效——确认改的是 ~/.codex/config.toml,并重开终端或重启客户端。
- 401 认证失败:API Key 错误——检查 experimental_bearer_token 是否为有效的 sk- Key。
- 402 余额不足:账户余额不足——前往 DeepSeek 平台充值。
- 429 请求速率达到上限:TPM/RPM 触顶——降低请求频率,稍后重试。
- 400 格式错误 / 422 参数错误:请求体格式或参数不符合要求——按错误信息提示修正。
- 500 服务器故障 / 503 服务器繁忙:服务端问题——稍等后重试。
- 模型无法调用:可能仍指向旧模型名——重跑脚本,或改用 deepseek-flash / deepseek-v4-pro。
- 想恢复原配置:重跑脚本选菜单 9,或从 ~/.codex/backup-deepseek/ 恢复备份。
Codex接入DeepSeek常见问题
Q:Codex 能接入 DeepSeek 吗?
A:能。Codex 通过 Responses API 通信,DeepSeek API 原生支持,配置 model_provider 为 deepseek 即可。
Q:接入要改哪个文件?
A:用户级 ~/.codex/config.toml(Windows 为 %USERPROFILE%\.codex\config.toml),另需 ~/.codex/models.json 模型目录文件。
Q:有没有更简单的办法?
A:有。用官方一键脚本自动完成备份、写 models.json 与 config.toml、语法校验,是最省事的方式。
Q:要用哪些 DeepSeek 模型名?
A:当前为 deepseek-flash(支持图片输入)与 deepseek-v4-pro;旧脚本的 deepseek-v4-flash 条目已被新版移除。
Q:base_url 要加 /v1 吗?
A:Codex 官方 Responses 配置用 https://api.deepseek.com/,不带 /v1;带 /v1 会改变路径,容易导致调用失败。
Q:ChatGPT 桌面版显示 Custom 正常吗?
A:正常。显示 Custom 或模型名都表示生效;显示 Custom 时实际使用的即为 deepseek-flash。
Q:切换后以前的会话不见了怎么办?
A:不是丢失。Codex 按登录方式分组存储会话,恢复原配置即可找回,切换后重启客户端生效。
Q:接入 DeepSeek 要付费吗?
A:DeepSeek API 按 token 计费,具体价格与账户赠送额度以 DeepSeek 开放平台官方定价页为准。
Q:报 401 或 402 怎么处理?
A:401 是 API Key 错误,检查 experimental_bearer_token;402 是余额不足,前往 DeepSeek 平台充值。
以上就是Codex接入DeepSeek教程的全部内容,Codex 的配置字段、支持的 DeepSeek 模型名与一键脚本行为可能随双方官方更新而变动,具体请以 DeepSeek 开放平台文档(api-docs.deepseek.com)与 Codex 官方仓库最新公布为准。