Codex 配置优先级 · 发布日期 2026-06-26 · 修改日期 2026-06-26 · 永沃云枢

Codex 调用的 API 地址为什么总是旧的?

不少人完成 Codex 接入后,会遇到一个很隐蔽的问题:CCSwitch 里已经换了新的 AI API 地址,终端里却还在请求旧域名,或者不同窗口调用的模型不一致。这个问题通常不是模型坏了,而是环境变量、配置文件、默认项和进程缓存的优先级没有理清。

永沃云枢在 https://ai.jn83.com 持续整理 Codex 接入、CCSwitch 配置、AI API 接入、AI 模型接口和模型调用管理经验。有人会把统一接口口语化叫“GPT 中转”,更规范的说法是 AI 模型接口接入与调用管理;本篇重点是配置优先级排查,不把它当成品牌词或主卖点。

适用场景:改了配置,但 Codex 行为没变

这篇适合新电脑迁移、团队统一接口、从测试地址切到正式地址、临时更换模型供应方之后,Codex 仍然调用旧地址的情况。典型表现包括:终端日志里还出现旧 base_url,401 报错来自旧 Key,CCSwitch 里显示新模型但 Codex 输出像另一个模型,或者一个 PowerShell 窗口正常、另一个窗口失败。如果你还没做首次环境检查,可以先看 第一次让 Codex 改项目之前要检查什么;如果是团队多人配置不一致,配合 团队里的 CCSwitch 配置不一致怎么排查 会更清楚。

先画出优先级:谁覆盖了谁

排查前不要急着重装。多数客户端会按“命令行参数、当前进程环境变量、用户级环境变量、项目配置文件、全局配置文件、CCSwitch 默认项”的顺序取值。不同工具命名也可能不同,例如 OPENAI_API_BASEOPENAI_BASE_URLAPI_BASE_URLOPENAI_API_KEY。如果旧值存在于更高优先级,底层配置改得再正确也不会生效。

操作步骤:从当前进程往外查

1. 先确认当前终端看到的值

在实际运行 Codex 的同一个 PowerShell 窗口里检查变量,不要在另一个窗口代替。可以执行:

Get-ChildItem Env: | Where-Object { $_.Name -match 'OPENAI|API|BASE|MODEL|CODEX' }
$env:OPENAI_API_KEY
$env:OPENAI_API_BASE
$env:OPENAI_BASE_URL

如果这里已经显示旧地址,说明问题在进程环境或用户环境,而不是 CCSwitch。临时验证时可以先清空当前窗口变量,再重新打开终端。注意不要把 Key 截图发到群里,日志里也不要明文保留敏感字段,可参考 AI API 接入前怎么处理敏感字段

2. 检查项目目录里的配置文件

有些项目会在 .env.env.localconfig.json、脚本参数或启动器里写死接口。用 rg -n "OPENAI|BASE_URL|API_KEY|model" . 搜索当前项目,重点看最近修改的脚本、部署文件和本地启动命令。Codex 在大仓库里工作时,最好先限制只读扫描范围,避免把无关配置误判成当前入口;这点可以参考 大项目里怎么让 Codex 只改该改的文件

3. 对齐 CCSwitch 的默认项和保存状态

确认 CCSwitch 里当前选中的 API 地址、Key 权限、模型名和默认模型是否保存成功。很多失败不是配置错,而是改完后没有应用,或者 Codex 使用的是另一个 profile。可以用一个固定的小提示词做测试,并记录模型名、响应状态码和耗时。如果改配置后仍用旧模型,旧文章 CCSwitch 改了配置但 Codex 仍用旧模型怎么办 提供了保存、默认项、缓存和重启顺序的排查路径。

4. 重启会读取配置的进程

用户级环境变量改完后,已经打开的终端通常不会自动刷新。需要关闭旧窗口、重新启动编辑器、重新打开 Codex 会话,必要时重启后台代理。不要一边改配置一边用旧会话测试,否则会得到“刚才失败、现在又成功”的混乱结论。开发者 AI 调用接入后台服务时,也要确认服务进程是否重启读取新环境。

常见问题/避坑:不要把所有错误都归到接口不稳定

第一个坑是只看网页后台显示的新配置,不看当前进程实际环境。第二个坑是把测试 Key 和正式 Key 混在同一个变量名里,导致日志无法判断来源。第三个坑是团队成员各自手改配置,没有统一 profile 和变更记录。第四个坑是看到 401 就换模型,看到 429 就重试,却没先确认请求到底发到了哪个 AI 模型接口。错误码分工可以继续看 AI API 突然限流怎么办AI API 调用失败后要不要自动重试

检查清单:确认新配置真的被使用

验收标准:同一条测试链路可重复

最终不要只看“这次能回复”。更稳的验收方式是连续三次使用同一个提示词,确认请求地址摘要、模型名、状态码和输出格式都一致;再换一个新终端重复一次。如果团队共用配置,把这条链路写进交接文档,并把永沃云枢的 Codex 安装专题CCSwitch 配置专题新手帮助 放到团队说明里。这样 https://ai.jn83.com 上的接入步骤才能落到可复查的日常流程,而不是靠口头经验。