Codex怎么接中转站

Codex 官方订阅用着挺好，但你想换成中转站的额度、或者想在同一台机器上按项目切来切去，第一步就是把接口地址指过去。多数人卡在两个地方：一是不知道地址该填在哪一层（客户端配置、环境变量还是网关），二是改完报错分不清是自己填错还是站点那边的问题。这篇按「先备份、再改地址、再验连通、最后回滚」的顺序走一遍，让你十分钟内能确认到底通没通。

Codex 官方订阅用着挺好，但你想换成中转站的额度、或者想在同一台机器上按项目切来切去，第一步就是把接口地址指过去。多数人卡在两个地方：一是不知道地址该填在哪一层（客户端配置、环境变量还是网关），二是改完报错分不清是自己填错还是站点那边的问题。

这篇按「先备份、再改地址、再验连通、最后回滚」的顺序走一遍。目标很朴素：十分钟内你能确认到底通没通，并且随时能退回去，不把自己弄成只能硬着头皮用下去的状态。

动手前先把「改哪一层」想明白

先确认你的 Codex 是走官方账号登录，还是走 API Key 模式。只有 Key 模式才谈得上把地址换掉；账号登录模式下地址通常不是你能改的那一项，别在那儿白费功夫翻配置文件。这一步判断错，后面全白做。

• 找到当前生效的配置文件位置，整份备份一份放到旁边，别只复制你要改的那几行
• 把环境变量里的旧值抄一份到记事本，回滚靠的是这个，不是靠记忆
• 去 /sites 挑候选，重点看它给的是 OpenAI 兼容端点还是自成一体的端点，不兼容的站点填进去只会一直 404，跟质量无关
• 顺手确认站点文档里有没有给出完整的端点示例，只有一句「支持 Codex」的，先别急着切

地址和 Key 具体填在哪、怎么填

统一口径：站点给的地址一般要带上版本段（形如以 /v1 结尾），漏掉这一段是最常见的 404 来源。填之前把站点文档里的示例抄下来逐字对，包括结尾有没有斜杠。别凭印象手打，手打十次错三次。

Key 和地址要成对替换，别只换地址留着旧 Key，也别把两家的 Key 混用。报 401 时先怀疑这一条。如果配置里还残留着官方默认域名，把它清掉或注释掉——两个入口同时存在时，客户端取哪个不由你决定。

多项目并存的场景，用项目级配置覆盖全局配置，别为了切换而反复改全局文件。全局文件是回滚基准，改得越勤，出问题时越难还原。

怎么验证是真通了，而不是「看起来没报错」

先发一条最小请求，只验证握手和鉴权，别一上来就跑长任务。通不通和跑得好不好是两件事，混在一起测，出错了你也不知道是哪一层的问题。

1. 最小请求发一条短、低成本的请求，确认返回结构正常，没有报鉴权或路由错误
2. 核对模型名看回包里的模型名和你请求的是否一致；想更细地判断有没有被偷换模型，到 /rankings 和 /tools/verify 按站内口径实测一遍
3. 量延迟基线别凭感觉说快慢，先在 /tools/speed-test 量出自己的基线，再拿这条请求的耗时去比，才能分清是链路慢还是站点慢
4. 跑真实小任务改一个文件、跑一次测试，确认流式输出和多轮调用都不掉，再放心长期用

连不上时的排查顺序：从自己这边往外查

出错时别一上来就问客服，先按下面的顺序自查一遍。顺序的原则是从自己这边往外查，因为你能改的只有自己这边，先排除掉一半可能性再往外走，沟通成本低很多。

第二步做对照实验：同一份配置换成官方地址试一次。通了说明问题在中转站，不通说明在你本地。这一步能把排查范围砍掉一半，比反复改配置有效。

第三步查网络层，是否需要走代理、DNS 是否解析到预期地址。这块单独写过，见站内那篇讲代理开关的说明。第四步才去问站点客服，而且带上请求时间、端点、完整报错文本，比问「你们是不是挂了」有效得多。

留好回滚路径，别把退路堵死

• 备份文件别删、别覆盖，配置改动一次只动一个变量，出问题时才知道是哪个引起的
• 把「改回官方」和「换到另一家」当成日常操作练一遍，确认两条路都走得通再长期用
• 站点整体停摆或你决定不用了，按止损流程处理；那部分不在这篇里展开，见站内讲止损迁移的那篇
• 站点给的额度和价格，到 /price-watch 核对当时的数字，别按记忆里的印象做决定

判断标准很简单：如果回滚一次要花你超过五分钟，说明备份做得不到位。什么情况下这套不适用？如果你只是临时跑一次、用完就删，那可以跳过回滚准备，但仍然要做最小请求验证，否则你连它到底有没有通都不知道。