Codex 国内怎么配 API Key / Base URL（踩坑 401/429）

Key、Base URL 与模型要同源，旧配置先备份

配置 Codex 时，密钥、接口地址和模型名称必须来自同一服务的交付信息，不能把不同来源的设置拼在一起。更换接入前先备份原有配置文件与认证文件，再核对套餐支持的模型和客户端协议。只换密钥却保留旧接口，或只换接口却沿用旧密钥，都是认证失败的常见原因；尚未确认接入成功时，不要靠更换套餐排查问题。备份文件也不要公开分享。

在订单页保存 API Key 和接口地址，不要公开分享。模型名称也要按同一服务的交付说明填写，不能看到别处的示例就直接照搬。

已有配置时，先备份 config.toml 和 auth.json。备份要保留修改前的内容；如果需要回到原服务，应恢复配套配置，不要只恢复其中一个文件。备份中也可能含有密钥，不要随排错截图一起发出去。

官网教程的手动配置要点是：

• config.toml 中：model_providers.OpenAI.base_url = "https://api.novamodelhub.com"。
• 客户端协议：wire_api = "responses"。
• 模型示例：gpt-5.5，以交付与教程为准。
• auth.json 中：{"OPENAI_API_KEY":"真实Key"}。

这些是核对要点，不是一份可以直接覆盖原文件的完整配置。完整操作请按 文档中心 的对应系统教程执行，不要自行补接口后缀，也不要把第三方脚本里的地址混进来。

Windows：在 PowerShell 配置，分清桌面版与 CLI

在 Windows 上接入 Codex，应先备份已有配置，再按官网教程选择桌面版或命令行模式，在指定终端执行对应脚本。命令行环境缺失时先安装所需运行环境和客户端，不要把安装客户端与配置接口混为一步。完成后还要完全退出并重启客户端，发送简单请求并核对用量；仅凭脚本结束，不能判断密钥和接口已经可用，也不能省略重启后的请求测试。

打开 Windows 教程，确认自己要配置的是桌面客户端还是 CLI。以下脚本使用 PowerShell，不要放进 CMD。

需要查找现有配置、完成备份时，在 PowerShell 输入：

explorer $env:USERPROFILE\.codex

对应目录为 C:\Users\用户名\.codex。修改前先保存其中已有的 config.toml 和 auth.json。

桌面版使用：

&([scriptblock]::Create((irm https://console.novamodelhub.com/install/codex.ps1))) -Mode desktop

CLI 使用：

&([scriptblock]::Create((irm https://console.novamodelhub.com/install/codex.ps1))) -Mode cli

如果缺少 CLI 环境，先安装 Node.js LTS，再执行官网教程中的安装命令：

npm install -g @openai/codex

安装客户端后，仍需按教程配置交付的 Key 与接口地址。不要把桌面模式的命令当成 CLI 配置，也不要在报错后轮流粘贴两个模式，避免难以判断究竟改了哪一套设置。

macOS：在 Terminal 执行对应模式的官网脚本

在 macOS 上接入 Codex，应在终端按照官网教程配置，桌面版和命令行使用各自对应的脚本参数。执行前先备份原有配置，把示例中的密钥占位内容替换为订单交付的真实密钥，不要直接保留示例文字。配置后完全退出并重启客户端，再用简单请求验证；需要求助时隐藏密钥，不能公开包含真实认证信息的命令或截图，已有密钥也要核对来源。

先打开 macOS 教程。查看配置目录可使用：

open ~/.codex

备份已有的 config.toml 和 auth.json 后，再选择对应模式。下面两条命令里的“粘贴你的APIKey”是占位内容，执行前要换成自己的真实 Key。

桌面版：

curl -fsSL https://console.novamodelhub.com/install/codex.sh | bash -s -- "粘贴你的APIKey" "desktop"

CLI：

curl -fsSL https://console.novamodelhub.com/install/codex.sh | bash -s -- "粘贴你的APIKey" "cli"

如果缺少 CLI，先安装 Node.js LTS，再执行：

npm install -g @openai/codex

把真实 Key 放进命令后，不要再把整条命令贴到群聊或公开工单。需要别人协助核对时，保留模式与错误信息，隐藏密钥内容。

配好后怎样验证：重启、简单请求、核对用量

验证 Codex 接入是否成功，应该完全退出并重启客户端，发送一个简单请求，再到用量查询核对实际消耗。客户端能打开、脚本没有报错，都不能代替请求验证。若请求失败，先保存错误详情，再检查密钥、接口地址与模型是否配套；若请求有回复，也应结合用量记录确认，避免把旧配置仍能使用误认为新配置已生效，测试时不要混用其他服务。

可以按这个顺序检查：

1. 完全退出客户端后重新启动，不只关闭当前对话。
2. 发送一个简短、容易核对结果的请求，暂时不要用大型任务试接入。
3. 打开 用量查询，核对这次测试的消耗。
4. 记录所用客户端、模型、请求结果与错误详情，再决定是否继续排查。

如果后续需要调整费用方案，也先完成这一步。密钥和接口没配对时，换成更高档套餐不能解决认证问题。费用选择可另看 Codex 包月 vs 按量，不要把接入排错和计费选型混在一次修改里。

遇到 401：先核对密钥与接口，再查认证残留

Codex 出现认证错误时，应先核对密钥是否完整、接口地址是否与密钥来自同一服务，以及是否残留其他认证配置。只换密钥或只换接口，都会留下不配套的设置。排查时对照订单交付信息和官网教程，检查实际配置后重启验证；更换套餐不能解决认证问题，也不要为了求助公开密钥，保留错误详情即可帮助判断下一步，先确认接入再谈费用。

401 的检查顺序可以固定下来，避免每次都从重装开始：

• Key 是否完整。 对照订单页重新检查，确认没有把示例占位内容当成真实密钥。
• 接口是否匹配。 核对当前 Base URL，不要只看刚刚粘贴的 Key。
• 模型与协议是否对应。 回到套餐说明和交付教程，确认客户端需要的接入方式受支持。
• 是否有其他认证残留。 检查实际使用的认证配置，修改后完全退出并重启，再发简单请求。

每次只围绕有依据的问题修改，保留修改前的备份。不要同时换密钥、换接口、换模型又换套餐，否则即使恢复可用，也难判断是哪项设置造成了问题。

遇到 429 或连接中断：按错误详情分开查

Codex 返回限流错误或连接中断时，不能只凭状态码判断服务不可用。限流错误要先读详情，区分额度不足与请求频率限制，避免连续盲目重试；连接中断则应核对接口地址、网络和客户端错误信息。延迟因网络与路由而异，以自己实测为准。求助时隐藏密钥并提供错误详情，不要用更换套餐代替对接入问题的检查，两类错误应分别记录。

429：额度不足与频率限制不是同一件事

先看错误详情，再到用量查询核对额度。不要看到 429 就立即连续重试，也不要未经判断就充值或升级。

如果详情指向额度不足，应结合所购方案和用量记录核对；如果指向频率限制，则围绕请求频率检查。套餐额度还有剩余，不等于所有频率限制都不存在。标准、进阶套餐要同时留意日额度与周额度；高配没有日额度限制，也仍有周额度。

连接中断：先留下可排查的信息

检查接口地址是否与交付一致，再核对网络和客户端显示的完整错误。整理求助信息时，可以写明系统、桌面版或 CLI、所用模型、问题出现时间和错误文本，隐藏 Key 及含密钥的配置截图。

不要把一次中断写成固定的延迟结论，也不要凭主观感受认定某条路由一定更快。先在自己的网络里复现和核对，再讨论是否需要调整接入。

相关阅读

继续阅读 如何用上 Codex：接口接入上手、GPT API 中转怎么选：看额度、延迟还是价 与 Codex 包月 vs 按量，结合接入配置与费用选择核对自己的方案。

FAQ

国内配置 Codex，关键是让密钥、接口地址和模型名称配套，并在修改前备份原配置。桌面版与命令行要按各自教程执行，配置完成后重启客户端，用简单请求和用量记录验证。认证失败先查密钥与接口，限流错误再区分额度和频率；连接中断则检查地址、网络及错误详情。购买第三方接口服务，不会获得官方聊天订阅权益，具体支持范围应以交付说明为准。