模型名是第一检查点
Codex 工具读取的模型名称需要与 UUcode 网关支持的模型配置一致。团队应维护一份允许模型列表，避免个人随意填写不存在的名称。
Codex Model Fix
Codex 报 model not found 时，用 UUcode 快速定位模型配置
doc.uucode.top 的通用排查页面列出 Codex 运行报 model not found。通过 UUcode 模型网关和请求日志，团队可以把本地配置、模型名称和 Key 状态逐项确认。
- Codex 专项
- model not found
- 请求日志
auth.json 与配置文件也要核对
文档中心还提到 auth.json 格式错误和配置文件无法写入。模型报错不一定只来自模型，也可能来自配置文件读取异常。
请求日志验证是否进入网关
如果 UUcode 控制台没有请求记录，优先排查本地 Codex 配置路径和环境变量；如果有记录，再根据错误码检查模型路由和额度。
01
确认模型名称
对照团队在 uucode.top 允许的模型列表，修正 Codex 配置中的 model 字段。
02
检查配置文件
按 doc.uucode.top 的 Codex 教程确认配置文件位置、写入权限和 auth.json 格式。
03
复测并看日志
重新运行 Codex，并在 UUcode 请求记录中判断错误是否来自本地配置、鉴权或模型路由。
常见问题
model not found 一定是平台问题吗？
不一定。常见原因包括模型名称写错、本地配置未生效、Key 没有权限或网关模型未开启。
UUcode 如何帮助排查？
UUcode 提供统一网关和请求记录，可以确认请求是否到达平台以及返回了什么错误。