Codex 接入 DeepSeek 官方教程：Windows/macOS 一键配置、模型切换与恢复（2026）

如果你条件有限，强烈推荐国内 API 站

这是站主自主搭建纯 GPT API 站，无需梯子，实时更新 GPT 最新模型（仅支持电脑端），价格是官方的 三分之一，操作简单，连接稳定，价格便宜，保证没有任何掺水、收集信息等低劣行为，保证爽用 GPT。

• 考普 AI 官网入口

想把 Codex 的请求改由 DeepSeek API 处理，当前有一条可以核验的官方路线：DeepSeek 已发布“接入 Codex”文档，并提供 Windows PowerShell 与 macOS/Linux 的一键配置脚本。配置前要先明确，这是把 Codex 指向 DeepSeek API，不是把 DeepSeek 变成 OpenAI 官方模型，也不会改变 ChatGPT 账号权益。本文按官方页面在 2026 年 8 月 27 日的内容整理，脚本、模型和计费规则变化时应以原页面为准。

一、先看结论：官方脚本解决了什么问题？

DeepSeek 官方文档说明，Codex 通过 Responses API 与模型交互，而 DeepSeek API 原生支持这种格式。Codex CLI、ChatGPT 桌面端和 VS Code 的 Codex IDE 扩展共用同一份配置文件，因此按官方页面完成一次配置后，多个客户端可以读取同一组 DeepSeek 设置。

官方脚本主要替你完成四件事：

1. 备份现有的 ~/.codex/config.toml；
2. 写入 ~/.codex/models.json，告诉 Codex 可用模型及其能力；
3. 增加 DeepSeek provider 和必要的接口配置；
4. 校验配置文件，并保留可恢复路径。

这条路线适合已经安装 Codex、愿意自己承担 API 费用并能管理密钥的开发者。如果你只是想比较网页端效果，先看 Codex 网页版、App、CLI 与 IDE 区别，不必为了尝试一次模型就修改本地环境。

二、运行前准备

1. 先安装并启动一次 Codex

你需要先安装 Codex CLI 或 ChatGPT 桌面端，并至少成功运行过一次，使当前用户的 .codex 目录已经创建。安装方式可参考 Codex 下载、安装与配置主指南。

常见的全局配置位置如下：

系统	常见位置	说明
macOS/Linux	~/.codex/	若设置了 CODEX_HOME，以自定义目录为准
Windows	%USERPROFILE%\\.codex\\	PowerShell 与图形客户端的用户目录可能不同
项目级	受信任仓库内的 .codex/	只在确认来源可信的项目中使用

路径、全局配置和项目级配置的覆盖关系，参见 Codex config.toml 与 .codex 文件夹配置指南。

2. 准备 DeepSeek API Key

在 DeepSeek Platform 创建自己的 API Key。密钥只应在本机脚本提示时输入，或通过系统密钥管理/环境变量提供；不要写进文章、截图、Git 仓库、AGENTS.md 或前端代码。DeepSeek 的账单、限速、模型权限和数据规则以其当前控制台及服务条款为准，本文不写固定价格或固定额度。

3. 先备份重要配置

如果你已经配置了 MCP、代理、项目可信目录或自定义 provider，建议退出 Codex 后复制一份不含密钥的 config.toml。官方脚本也会创建备份目录，但保留自己的副本更容易比较变更。

三、Windows PowerShell 一键配置

1. 打开 PowerShell，确认 Codex 已退出或当前没有正在运行的任务。
2. 打开 DeepSeek 官方“接入 Codex”文档，核对 Windows 脚本地址和内容。
3. 按官方页面当前命令执行：

irm https://cdn.deepseek.com/api-docs/codex-deepseek-setup-en.ps1 | iex

irm | iex 会下载并立即执行远程脚本。即使域名正确，也应先查看脚本来源；公司电脑或受管设备应遵循管理员的软件安装流程。不要把聊天群、网盘或短链接提供的同名脚本替换进来。

4. 按提示输入以 sk- 开头的 DeepSeek API Key；
5. 在菜单中选择模型；
6. 等待脚本报告备份、写入和语法校验结果；
7. 重启 Codex，检查模型列表与最小测试任务。

如果 PowerShell 因执行策略阻止脚本，不要长期关闭系统安全策略；先查看 Codex Windows 安装与登录排查，按当前用户、当前进程的安全设置逐项排查。

四、macOS/Linux 一键配置

在终端中打开 DeepSeek 官方页面，核对脚本地址后执行：

bash <(curl -fsSL https://cdn.deepseek.com/api-docs/codex-deepseek-setup.sh)

脚本启动后，输入 API Key 并选择模型。若终端提示 ~/.codex 不存在，先运行一次 Codex，再重试；如果你使用了自定义 CODEX_HOME，应确认脚本和客户端读取的是同一个目录。

macOS 用户还要注意 Apple Silicon 与 Intel 的 Codex 安装路线不同，安装本身的问题可参考 Codex macOS 安装与 Homebrew 配置。Linux 服务器上则要额外检查当前用户、文件权限、代理和凭据存储位置。

五、模型怎么选？

截至本文核查日，DeepSeek 官方接入页面在菜单中列出以下模型：

模型	适合先测试的方向	需要留意
deepseek-v4-flash	日常代码修改、快速问答	具体速度、上下文和价格以 DeepSeek 当前页面为准
deepseek-v4-pro	更复杂的代码分析和规划	可能有不同的计费与可用资格
deepseek-v4-flash-vision-exp	需要图片输入的任务	官方配置声明支持 image；仍要看客户端与服务端状态

六、切换模型、查看备份与恢复默认

官方脚本可以重复运行。再次运行时通常有三种用途：

• 切换模型：重新选择 flash、pro 或视觉模型；
• 重新写入配置：用于修复被手动改坏的 provider 字段；
• 恢复默认：选择菜单中标为第 9 项的恢复选项，移除 DeepSeek 相关配置。

脚本会把原来的 config.toml 备份到 ~/.codex/backup-deepseek/，同时写入 models.json。恢复后建议重启所有 Codex 客户端，并用 codex --version、codex --help 和一个不含敏感代码的小任务确认状态。不要直接删除整个 .codex 文件夹；其中可能还有认证状态、日志和其他客户端数据。

七、手动配置时要检查哪些字段？

如果你不想执行远程脚本，可以参照 DeepSeek 官方页面手动维护 models.json 与 config.toml。重点不是盲抄一段“万能配置”，而是逐项核对：

1. provider 的 base_url 是否是 API 根地址，而不是网页首页；
2. wire_api 是否与服务端的 Responses 协议一致；
3. env_key 是否只写环境变量名，而不是把真实 Key 写入 TOML；
4. models.json 中的模型 slug 是否与服务端当前 ID 完全一致；
5. 工具调用、流式输出、上下文窗口和图片输入是否真的被服务端支持；
6. MCP、代理、项目可信设置是否因手动合并而丢失。

OpenAI 的 Codex 配置参考可用于理解 provider、沙箱和审批字段；DeepSeek 的 Codex 接入文档才是本页脚本、模型 ID 和恢复菜单的优先来源。

八、常见报错排查

现象	优先检查	不建议的做法
~/.codex 不存在	先运行一次 Codex，确认 CODEX_HOME	直接在任意目录新建一套配置
401/403	API Key、DeepSeek 账户权限、账单状态	把 Key 发给他人“代测”
400/404	base_url、Responses 路径、模型 ID	反复更换未经文档确认的模型名
模型列表没有更新	重启客户端，检查实际读取的 models.json	复制多个版本配置互相覆盖
MCP 或信任设置消失	对比备份与当前 config.toml	直接删除整个 .codex 目录
图片任务失败	选视觉模型，确认 input_modalities 与服务端能力	仅凭模型名称判断支持图片

遇到认证链路本身的问题，可继续看 Codex 登录失败、localhost 回调与 token 交换排查。分享日志前要删掉 API Key、请求头、邮箱、项目路径和代码内容。

九、FAQ

接入 DeepSeek 后还需要 ChatGPT Plus 吗？

这是两套不同的使用路线。自定义 provider 使用 DeepSeek API 的账号和计费；ChatGPT 订阅权益、OpenAI 官方 Codex 入口和 API 账单不能相互替代。具体权限以各自平台当前页面为准。

官方脚本会不会删除我的 MCP 配置？

DeepSeek 文档说明脚本会保留已有 MCP 和项目可信设置，并在冲突时提示处理；但不同版本可能变化。执行前保留自己的备份，完成后逐项检查。

能不能把 DeepSeek API Key 写进 config.toml？

不建议。使用 env_key 指向环境变量或系统密钥存储，避免密钥进入仓库、同步盘、终端录屏和日志。

十、总结

Codex 接入 DeepSeek 的关键不是复制一段神秘配置，而是确认四个事实：Codex 客户端已经初始化、API 协议和模型 ID 来自当前官方文档、密钥没有泄露、原配置可以随时恢复。想快速尝试时优先用官方脚本；需要精细控制时再手动审查 models.json、config.toml、工具调用和费用。

继续阅读：Codex 教程中心 · Codex 下载、安装与配置主指南 · Codex config.toml 与 .codex 文件夹配置指南