1. 前言为什么选择 Codex DeepSeekCodex 是 OpenAI 推出的命令行 AI 编程助手默认对接的是 ChatGPT 账号与 OpenAI 官方模型。对国内开发者来说默认方案有两个明显痛点网络不稳定访问 OpenAI 接口需要代理体验时好时坏。成本偏高高频编码场景下OpenAI 模型的费用相对更高。好消息是Codex 本身支持自定义模型提供商Custom Model Provider只要目标服务兼容 OpenAI 接口协议就能把后端模型替换掉。DeepSeek 恰好提供了与 OpenAI 完全兼容的 API并且国内直连、稳定、无需代理价格低deepseek-chat与deepseek-reasoner都能用于编程代码能力在开源与国产模型中处于第一梯队。本教程以Windows 11为例完整演示从零开始把 Codex 的默认模型换成 DeepSeek 的全过程。macOS/Linux 的配置思路完全一致只是安装命令与路径略有差异。2. 整体配置思路先建立全局认知后面每步操作都会回归到这张图上。Codex 的所有配置集中在一个文件里C:\Users\你的用户名\.codex\config.toml我们要做的事可以概括为三步安装 Codex CLI把 DeepSeek 的 API Key 写进环境变量在config.toml中注册一个名为deepseek的自定义模型提供商并把它设为默认模型。注册 DeepSeek创建 API Key安装 Node.js安装 Codex CLI设置环境变量 DEEPSEEK_API_KEY编写 config.toml运行 codex 验证其中最关键的是下面的配置映射关系配置项含义model_provider当前默认使用哪个提供商model当前默认使用哪个模型[model_providers.deepseek]定义名为deepseek的提供商name提供商显示名称base_urlDeepSeek 的兼容接口地址env_key从哪个环境变量读取 API Keywire_api使用哪种协议DeepSeek 用chat3. 准备 DeepSeek API Key3.1 注册并开通打开 DeepSeek 开放平台https://platform.deepseek.com。使用手机号或邮箱注册账号完成登录。进入控制台在「充值」页面按需充值。DeepSeek 按量计费个人调试充 10 元就能用很久。注意区分chat.deepseek.com是网页版聊天界面platform.deepseek.com才是开放的 API 平台API Key 必须在后者创建。3.2 创建 API Key在左侧菜单点击「API keys」。点击「创建 API key」可以填一个备注名比如codex。创建成功后页面会显示一个形如sk-xxxxxxxxxxxxxxxx的密钥。这个密钥只显示一次请立即复制并妥善保存。它本质上就是账户的支付凭证泄露后可能被他人盗刷。4. 安装 Node.js 与 Codex CLICodex CLI 官方推荐通过 npm 安装因此需要先准备 Node.js 环境。4.1 安装 Node.js打开 PowerShell建议以管理员身份运行使用 winget 安装 LTS 版本winget install OpenJS.NodeJS.LTS也可以到官网https://nodejs.org下载 Windows 安装包一路下一步即可。安装完成后关闭并重新打开 PowerShell验证node-v npm-v能看到版本号如v20.x.x、10.x.x即表示成功。4.2 安装 Codex CLI继续执行npm install-g openai/codex安装过程需要几分钟。完成后验证codex--version如果提示「无法将 codex 识别为 cmdlet」通常是 npm 全局目录没有被加入 PATH重启终端再试一次仍然失败的话检查 Node.js 是否安装完整。5. 写入 DeepSeek API Key 环境变量Codex 不会把密钥写死在代码或配置文件中而是通过环境变量读取这样更安全。5.1 临时设置仅当前终端会话有效PowerShell 中执行$env:DEEPSEEK_API_KEY sk-你的密钥这种方式关闭终端后就会失效适合先做快速测试。5.2 永久设置推荐使用setx把变量写入用户级环境变量setx DEEPSEEK_API_KEYsk-你的密钥setx对之后新打开的终端才生效当前已打开的终端不会自动继承。也可以通过图形界面设置按Win R输入sysdm.cpl进入「高级 → 环境变量」在「用户变量」中新建变量名DEEPSEEK_API_KEY变量值sk-你的密钥设置完成后重新打开一个 PowerShell验证是否生效echo$env:DEEPSEEK_API_KEY能打印出密钥即成功。6. 编写 config.toml 配置 DeepSeek这是把 Codex 切到 DeepSeek 的核心步骤。6.1 创建配置目录PowerShell 执行New-Item-ItemType Directory-Force-Path$env:USERPROFILE\.codex6.2 创建并编辑配置文件执行下面命令用记事本打开配置文件不存在会自动新建notepad$env:USERPROFILE\.codex\config.toml把以下内容完整粘贴进去model deepseek-chat model_provider deepseek [model_providers.deepseek] name DeepSeek base_url https://api.deepseek.com/v1 env_key DEEPSEEK_API_KEY wire_api chat requires_openai_auth false各字段说明model deepseek-chat默认使用 DeepSeek 的对话模型兼顾速度与成本适合日常编码。model_provider deepseek指向下面定义的提供商。base_urlDeepSeek 的 OpenAI 兼容接口https://api.deepseek.com/v1与https://api.deepseek.com均可。env_key DEEPSEEK_API_KEY告诉 Codex 从名为DEEPSEEK_API_KEY的环境变量读取密钥。wire_api chat使用 Chat Completions 协议。DeepSeek 走的是chat而不是 OpenAI 官方的responses。requires_openai_auth false跳过 OpenAI 账号强制登录直接使用第三方模型。保存后关闭记事本。7. 启动并验证重新打开一个 PowerShell确保环境变量已生效执行codex用一段话解释什么是递归如果配置正确Codex 会调用 DeepSeek 返回解释。你可以再加一个简单的编程任务验证代码能力codex用 Python 写一个冒泡排序并加上注释7.1 临时切换为推理模型不需要改动配置文件也可以在启动时用-m指定模型。DeepSeek 的推理模型deepseek-reasoner更适合复杂架构与算法问题codex-m deepseek-reasoner分析这段代码的性能瓶颈7.2 直接验证 API 连通性如果 Codex 一直报错可以先绕过 Codex用 curl 直接测试 DeepSeek 接口是否可用在已设置环境变量的终端中执行curl.exe-X POST https://api.deepseek.com/v1/chat/completions -HContent-Type: application/json-HAuthorization: Bearer$env:DEEPSEEK_API_KEY-d{\model\:\deepseek-chat\,\messages\:[{\role\:\user\,\content\:\hi\}]}能返回 JSON 说明 Key 与网络都没问题再把排查重心放回 Codex 配置上。8. 常用模型与参数建议DeepSeek 主要有两个可用的对话模型模型特点适用场景deepseek-chat响应快、成本最低日常问答、代码补全、一般重构deepseek-reasoner带深度推理速度较慢复杂架构设计、疑难 bug 定位在 Codex 中切换模型有两种方式临时切换codex -m deepseek-reasoner仅本次生效。永久切换修改config.toml顶部的model ...。如果希望接受自动执行命令、减少每次确认可以在config.toml中追加approval_policy on-request其中on-request表示由 Codex 判断有需要时再请求你的批准。更激进的never会让 Codex 自动执行命令风险较高不建议新手开启。9. 常见问题排查9.1 提示「model provider not found」说明config.toml中的model_provider与[model_providers.xxx]的名称不一致。检查两个地方是否完全一致注意大小写。9.2 提示鉴权失败 / 401 / api key 无效确认DEEPSEEK_API_KEY环境变量真的存在echo $env:DEEPSEEK_API_KEY确认 Key 是从platform.deepseek.com创建而不是网页版确认 Key 没有多余空格setx时如果 Key 含特殊字符建议用图形界面设置确认账户余额不为 0。9.3 仍然弹出 ChatGPT 登录界面说明requires_openai_auth false没有生效。检查配置是否真的保存到了C:\Users\你的用户名\.codex\config.tomlCodex 版本是否过旧可执行npm install -g openai/codexlatest升级到最新版文件是否被记事本意外存成了config.toml.txt查看完整文件名去掉多余后缀。9.4 响应很慢或报超时DeepSeek 推理模型deepseek-reasoner速度明显慢于deepseek-chat属于正常现象如果deepseek-chat也超时先按 7.2 的方法用 curl 测试网络连通性。9.5 想彻底卸载换回官方模型执行以下命令卸载npm uninstall-g openai/codex如果要恢复默认配置删除C:\Users\你的用户名\.codex\config.toml即可环境变量可以保留不影响其它程序。10. 总结至此你已经完成了在 Windows 11 下用 DeepSeek 驱动 Codex 的全部配置。整体链路回顾在 DeepSeek 开放平台创建 API Key安装 Node.js 与 Codex CLI把 Key 写入环境变量DEEPSEEK_API_KEY在~/.codex/config.toml中注册自定义提供商用codex命令验证调用。这套方案的收益很明显国产模型、国内直连、成本可控同时保留了 Codex 强大的终端编程体验。日常开发用deepseek-chat遇到复杂问题临时切到deepseek-reasoner是一个比较舒服的组合。
Codex 配置国产模型 DeepSeek 完整教程（Windows 11）
1. 前言为什么选择 Codex DeepSeekCodex 是 OpenAI 推出的命令行 AI 编程助手默认对接的是 ChatGPT 账号与 OpenAI 官方模型。对国内开发者来说默认方案有两个明显痛点网络不稳定访问 OpenAI 接口需要代理体验时好时坏。成本偏高高频编码场景下OpenAI 模型的费用相对更高。好消息是Codex 本身支持自定义模型提供商Custom Model Provider只要目标服务兼容 OpenAI 接口协议就能把后端模型替换掉。DeepSeek 恰好提供了与 OpenAI 完全兼容的 API并且国内直连、稳定、无需代理价格低deepseek-chat与deepseek-reasoner都能用于编程代码能力在开源与国产模型中处于第一梯队。本教程以Windows 11为例完整演示从零开始把 Codex 的默认模型换成 DeepSeek 的全过程。macOS/Linux 的配置思路完全一致只是安装命令与路径略有差异。2. 整体配置思路先建立全局认知后面每步操作都会回归到这张图上。Codex 的所有配置集中在一个文件里C:\Users\你的用户名\.codex\config.toml我们要做的事可以概括为三步安装 Codex CLI把 DeepSeek 的 API Key 写进环境变量在config.toml中注册一个名为deepseek的自定义模型提供商并把它设为默认模型。注册 DeepSeek创建 API Key安装 Node.js安装 Codex CLI设置环境变量 DEEPSEEK_API_KEY编写 config.toml运行 codex 验证其中最关键的是下面的配置映射关系配置项含义model_provider当前默认使用哪个提供商model当前默认使用哪个模型[model_providers.deepseek]定义名为deepseek的提供商name提供商显示名称base_urlDeepSeek 的兼容接口地址env_key从哪个环境变量读取 API Keywire_api使用哪种协议DeepSeek 用chat3. 准备 DeepSeek API Key3.1 注册并开通打开 DeepSeek 开放平台https://platform.deepseek.com。使用手机号或邮箱注册账号完成登录。进入控制台在「充值」页面按需充值。DeepSeek 按量计费个人调试充 10 元就能用很久。注意区分chat.deepseek.com是网页版聊天界面platform.deepseek.com才是开放的 API 平台API Key 必须在后者创建。3.2 创建 API Key在左侧菜单点击「API keys」。点击「创建 API key」可以填一个备注名比如codex。创建成功后页面会显示一个形如sk-xxxxxxxxxxxxxxxx的密钥。这个密钥只显示一次请立即复制并妥善保存。它本质上就是账户的支付凭证泄露后可能被他人盗刷。4. 安装 Node.js 与 Codex CLICodex CLI 官方推荐通过 npm 安装因此需要先准备 Node.js 环境。4.1 安装 Node.js打开 PowerShell建议以管理员身份运行使用 winget 安装 LTS 版本winget install OpenJS.NodeJS.LTS也可以到官网https://nodejs.org下载 Windows 安装包一路下一步即可。安装完成后关闭并重新打开 PowerShell验证node-v npm-v能看到版本号如v20.x.x、10.x.x即表示成功。4.2 安装 Codex CLI继续执行npm install-g openai/codex安装过程需要几分钟。完成后验证codex--version如果提示「无法将 codex 识别为 cmdlet」通常是 npm 全局目录没有被加入 PATH重启终端再试一次仍然失败的话检查 Node.js 是否安装完整。5. 写入 DeepSeek API Key 环境变量Codex 不会把密钥写死在代码或配置文件中而是通过环境变量读取这样更安全。5.1 临时设置仅当前终端会话有效PowerShell 中执行$env:DEEPSEEK_API_KEY sk-你的密钥这种方式关闭终端后就会失效适合先做快速测试。5.2 永久设置推荐使用setx把变量写入用户级环境变量setx DEEPSEEK_API_KEYsk-你的密钥setx对之后新打开的终端才生效当前已打开的终端不会自动继承。也可以通过图形界面设置按Win R输入sysdm.cpl进入「高级 → 环境变量」在「用户变量」中新建变量名DEEPSEEK_API_KEY变量值sk-你的密钥设置完成后重新打开一个 PowerShell验证是否生效echo$env:DEEPSEEK_API_KEY能打印出密钥即成功。6. 编写 config.toml 配置 DeepSeek这是把 Codex 切到 DeepSeek 的核心步骤。6.1 创建配置目录PowerShell 执行New-Item-ItemType Directory-Force-Path$env:USERPROFILE\.codex6.2 创建并编辑配置文件执行下面命令用记事本打开配置文件不存在会自动新建notepad$env:USERPROFILE\.codex\config.toml把以下内容完整粘贴进去model deepseek-chat model_provider deepseek [model_providers.deepseek] name DeepSeek base_url https://api.deepseek.com/v1 env_key DEEPSEEK_API_KEY wire_api chat requires_openai_auth false各字段说明model deepseek-chat默认使用 DeepSeek 的对话模型兼顾速度与成本适合日常编码。model_provider deepseek指向下面定义的提供商。base_urlDeepSeek 的 OpenAI 兼容接口https://api.deepseek.com/v1与https://api.deepseek.com均可。env_key DEEPSEEK_API_KEY告诉 Codex 从名为DEEPSEEK_API_KEY的环境变量读取密钥。wire_api chat使用 Chat Completions 协议。DeepSeek 走的是chat而不是 OpenAI 官方的responses。requires_openai_auth false跳过 OpenAI 账号强制登录直接使用第三方模型。保存后关闭记事本。7. 启动并验证重新打开一个 PowerShell确保环境变量已生效执行codex用一段话解释什么是递归如果配置正确Codex 会调用 DeepSeek 返回解释。你可以再加一个简单的编程任务验证代码能力codex用 Python 写一个冒泡排序并加上注释7.1 临时切换为推理模型不需要改动配置文件也可以在启动时用-m指定模型。DeepSeek 的推理模型deepseek-reasoner更适合复杂架构与算法问题codex-m deepseek-reasoner分析这段代码的性能瓶颈7.2 直接验证 API 连通性如果 Codex 一直报错可以先绕过 Codex用 curl 直接测试 DeepSeek 接口是否可用在已设置环境变量的终端中执行curl.exe-X POST https://api.deepseek.com/v1/chat/completions -HContent-Type: application/json-HAuthorization: Bearer$env:DEEPSEEK_API_KEY-d{\model\:\deepseek-chat\,\messages\:[{\role\:\user\,\content\:\hi\}]}能返回 JSON 说明 Key 与网络都没问题再把排查重心放回 Codex 配置上。8. 常用模型与参数建议DeepSeek 主要有两个可用的对话模型模型特点适用场景deepseek-chat响应快、成本最低日常问答、代码补全、一般重构deepseek-reasoner带深度推理速度较慢复杂架构设计、疑难 bug 定位在 Codex 中切换模型有两种方式临时切换codex -m deepseek-reasoner仅本次生效。永久切换修改config.toml顶部的model ...。如果希望接受自动执行命令、减少每次确认可以在config.toml中追加approval_policy on-request其中on-request表示由 Codex 判断有需要时再请求你的批准。更激进的never会让 Codex 自动执行命令风险较高不建议新手开启。9. 常见问题排查9.1 提示「model provider not found」说明config.toml中的model_provider与[model_providers.xxx]的名称不一致。检查两个地方是否完全一致注意大小写。9.2 提示鉴权失败 / 401 / api key 无效确认DEEPSEEK_API_KEY环境变量真的存在echo $env:DEEPSEEK_API_KEY确认 Key 是从platform.deepseek.com创建而不是网页版确认 Key 没有多余空格setx时如果 Key 含特殊字符建议用图形界面设置确认账户余额不为 0。9.3 仍然弹出 ChatGPT 登录界面说明requires_openai_auth false没有生效。检查配置是否真的保存到了C:\Users\你的用户名\.codex\config.tomlCodex 版本是否过旧可执行npm install -g openai/codexlatest升级到最新版文件是否被记事本意外存成了config.toml.txt查看完整文件名去掉多余后缀。9.4 响应很慢或报超时DeepSeek 推理模型deepseek-reasoner速度明显慢于deepseek-chat属于正常现象如果deepseek-chat也超时先按 7.2 的方法用 curl 测试网络连通性。9.5 想彻底卸载换回官方模型执行以下命令卸载npm uninstall-g openai/codex如果要恢复默认配置删除C:\Users\你的用户名\.codex\config.toml即可环境变量可以保留不影响其它程序。10. 总结至此你已经完成了在 Windows 11 下用 DeepSeek 驱动 Codex 的全部配置。整体链路回顾在 DeepSeek 开放平台创建 API Key安装 Node.js 与 Codex CLI把 Key 写入环境变量DEEPSEEK_API_KEY在~/.codex/config.toml中注册自定义提供商用codex命令验证调用。这套方案的收益很明显国产模型、国内直连、成本可控同时保留了 Codex 强大的终端编程体验。日常开发用deepseek-chat遇到复杂问题临时切到deepseek-reasoner是一个比较舒服的组合。