解决 Codex API Key 模式下无法使用 5.6 版本的配置问题

最近在折腾 Codex 的配置时，遇到了一个挺让人挠头的问题：明明已经开启了 API Key 模式，并且在配置文件里把版本号改成了 5.6，可界面上一刷新，显示的依然是“自定义”，死活切不过去。

这个问题其实在很多新部署或者刚升级环境的朋友中间挺常见的。今天咱们不扯虚的，直接上手分析一下到底是哪个环节出了问题，以及怎么把 5.6 版本“请”出来。

问题现象复现

首先确认一下症状：

1. 你使用的是官方支持的 API Key 鉴权模式。
2. 打开配置文件（通常是 config.json 或者 .env 之类的），关于模型版本的参数你已经手动改成了 5.6。
3. 重启服务、清除缓存，甚至重启了 Docker 容器，结果前端界面显示的模型版本依然是灰色的“Custom”或者“自定义”。

核心原因分析

出现这种情况，大体逃不出以下三个坑：

1. 配置文件没生效（最常见） 很多时候，我们以为自己在改主配置文件，实际上程序可能运行在容器或者沙盒环境里，读取的是挂载目录下的另一个副本。或者，你修改的是模板文件，而程序实际加载的是运行时生成的动态配置。这就导致“改了寂寞”。

2. 版本号字符串格式不对 Codex 对版本号的读取有时候比较“死板”。你写的是 5.6，但系统可能期望的是 v5.6 或者完整的带哈希值的字符串。一旦格式不匹配，系统为了保险起见，就会回退到默认的自定义模式，防止调用失败的接口。

3. API Key 权限限制 这是最容易被忽视的一点。你的配置文件没问题，但你的 Key 本身可能没有权限访问 5.6 版本的接口。虽然 Codex 客户端通常通过 Key 代理转发，但如果你对接的是上游某个受限的网关，它可能会因为 Key 的等级拒绝特定版本的调用，从而导致客户端回退显示状态。

实操解决方案

别急，咱们一步步来排查。

第一步：找到“真”的配置文件 不要猜，直接用 ps -ef 或者 docker inspect 查看运行进程，确认程序的启动参数里 -config 指向的到底是哪个路径。

如果是 Docker 部署，检查一下你的 docker-compose.yml，确保 volume 映射是正确的。修改映射路径里的文件，然后重启容器。

第二步：修正版本参数 不要只写数字。建议尝试以下几种格式，逐个测试：

• `