给 Codex 换过中转站的人,常常在某个时点想切回官方:可能是额度算下来不划算,可能是担心稳定性,也可能只是官方直连这条路重新好走了。麻烦的是,切回去不是把 key 换掉就完事——旧的环境变量、配置文件、第三方插件和终端会话里的残留会继续生效,你以为在用官方,请求其实还打在中转的地址上。这篇按清点、替换、验证三步给一份可照着走的操作顺序。
给 Codex 换过中转站的人,常常在某个时点想切回官方:可能是额度算下来不划算,可能是担心稳定性,也可能只是官方直连这条路重新好走了。麻烦的是,切回去不是把 key 换掉就完事——旧的环境变量、配置文件、第三方插件和终端会话里的残留会继续生效,你以为在用官方,请求其实还打在中转的地址上。
这篇按清点、替换、验证三步给一份可照着走的操作顺序。核心思路只有一句话:先把中转留下的痕迹全部找出来,再动官方配置,最后用一条能证明链路的方法验一遍。哪一步没做完就往下走,后面排查起来会很乱。
先搞清楚中转站的配置被写在了哪几个地方
Codex 的接入配置通常分散在三处:环境变量(终端里 export 的那些)、用户级配置文件、以及项目目录里的局部配置。只改一处,另外两处会继续生效——这是切回官方最常见的翻车点。动手之前先花几分钟把这三处都过一遍。
| 配置位置 | 典型内容 | 影响范围 |
|---|---|---|
| 环境变量 | 地址项、鉴权 key | 当前终端会话或所有新开的 shell |
| 用户级配置文件 | 地址项、默认模型、鉴权方式 | 这台机器上所有项目 |
| 项目局部配置 | 单独的地址覆盖、代理设置 | 只影响这个项目目录 |
| 第三方路由或代理工具 | 自己持有的上游地址 | 全局,且不随配置文件改动而失效 |
- 常见的中转写法是覆盖 base_url 一类的地址项和 api key 项,先把这两类找全,再动手清
- 用一条命令把当前生效的变量打出来看(比如列出所有含相关前缀的环境变量),比凭印象回忆可靠;具体命令随你用的终端和系统不同,不必照抄某一种
- 配置文件的路径可以用工具自带的帮助命令或配置查询命令确认,别靠记忆猜目录
- 如果之前装过第三方路由或代理工具,单独记一笔:它可能自己持有一份上游地址,改配置文件不影响它
清除旧配置:按环境变量、配置文件、本地缓存的顺序
- 环境变量先确认它是写在了 shell 启动文件里还是只在当前会话临时导出——前者要改文件,后者关掉终端就没了,两种处理方式不同。改完开一个新终端,重新列一遍变量确认已经看不到中转相关项
- 配置文件改回官方地址就是删掉中转那几行,不要留注释掉的旧行,有些工具会读到注释之外的空值。删完把文件另存一份备份,命名里带上「改前」字样
- 本地缓存与登录态切回官方一般需要重新走一次登录或重新填 key,旧的凭据文件建议先备份再清,避免出现两边凭据同时存在、工具不知道该用哪个
- 第三方路由或代理停用它持有的上游地址,或者在配置里把它整体关掉再看效果。只改 Codex 自己的配置、不管这一层,请求照样绕道
判断标准很简单:如果你在终端里改了变量,但换个目录、换台机器又变回中转地址,说明真正的源头在用户级文件或系统级设置里,而不是你刚才改的那个地方。这种情况往下改本地文件无效,得去找统一管理机器配置的人。
恢复官方配置并确认走的是官方链路
官方接入的入口和凭据类型在站内对应页面有现行口径,别照着半年前的旧教程填;地址、鉴权方式、可用模型都按当时页面写的来。填完之后不要只看工具没报错就放心,报错消失不等于链路正确。
- 填什么
- 地址、鉴权方式、可用模型,一律以站内当时的页面口径为准,不抄旧教程
- 怎么验
- 看请求实际打到哪个域名,或者用官方侧能查到的用量记录去对一次
- 先跑什么
- 挑一个短任务跑通,再把常用的长任务接上,出问题好定位是哪一步
# 先备份,再改,顺序别反
cp ~/.config/<你的工具目录>/config ~/.config/<你的工具目录>/config.bak-before-official
# 改完后新开一个终端,重新列出相关环境变量确认无残留
env | grep -i <相关前缀>验证与回退:怎么确认真的切干净了
- 验证顺序建议:先确认无中转变量残留,再确认登录态属于官方,最后跑一次真实调用看响应里有没有中转站特有的提示或错误格式
- 如果响应格式、报错措辞跟你印象里的官方不一致,或者用量记录在官方侧查不到,说明链路还没切干净,回到上一步重新排查
- 判断不适用的情况:如果你在团队里办公、机器是统一镜像或由 IT 管理,环境变量可能你在终端里改了但全局还在,这种情况改本地文件无效,要找管机器的人核对
- 留一条回退路径:把改动前的配置另存一份,切过去不顺利可以先退回来,不要在原文件上反复改到自己也记不清改了什么
- 切完后隔几天再抽查一次,确认没有某个后台任务或插件把旧地址又写回去
如果一定要给个判断依据,就去看实际请求落点和工具侧的用量统计对不对得上,而不是看终端里有没有报错。对不上就当成没切干净处理。想对比不同接入方式当下的价格和口径,可以到站内页面核对当时的数字,不要凭记忆下结论。
接下来做什么把清点、替换、验证这三步走完之前,先别急着把旧配置彻底删掉;同时去站内对照页面确认现行官方接入口径,避免照旧教程填错参数→常见问题
我只把 API key 换成官方的,为什么还是走中转?
大概率是地址项没改。key 和地址是两套配置,很多工具会优先读环境变量里的地址,你在配置文件里换成官方也没用。先把当前生效的环境变量列出来确认一遍,再改配置文件,两边都对齐才算切完。
怎么判断自己是不是已经彻底删干净了?
看两点:一是终端新开的会话里不再有中转相关变量,二是跑一次调用后,用量能在官方侧的记录里查到。只看工具没报错不算数,很多残留配置在新会话里才暴露出来。
切回官方之后原来的中转余额怎么办?
那属于另一个问题,跟配置无关。建议先确认官方这边能正常用,再处理余额。余额能不能退、怎么退,看站点的退款与提现条款,站内 退款、提现、余额过期(/guides/refund-withdrawal-terms) 那篇把判断口径讲清了。