Codex 提示 Model not found、unsupported model、404 怎么解决？

先给结论：404 只是结果，先找出是哪一层拒绝了模型

同一句 Model not found，至少可能来自五类问题：模型名写错或已弃用、账号未获得模型、客户端配置固定旧模型、官方后端异常、API 或自定义 provider 的地址与权限错误。

第一步：保留完整错误，确认认证方式和请求地址

先记录错误原文，不要只截“404”三个字符。至少保留模型名、URL 域名、request ID、发生时间和使用界面，然后运行：

codex --version
codex login status

使用 ChatGPT 登录：先从 /model 选择当前可用模型

OpenAI 官方 Models 文档说明，交互式 CLI 可以用 /model 切换模型和推理强度；启动时可用 --model 或 -m，非交互任务也支持：

# 交互会话中
/model

# 临时指定模型
codex --model <从 /model 看到的模型名>
codex exec -m <模型名> "Reply with exactly OK."

不要从社交平台截图猜一个新模型名，也不要认为“API 模型页存在”就等于 ChatGPT 登录的 Codex 一定可用。官方文档明确区分 ChatGPT 登录推荐模型和 API 可用模型；部分模型还可能只向特定套餐或界面开放。

官方参考：Codex Models。

检查 config.toml、启动参数和已经弃用的模型

OpenAI 官方说明，ChatGPT 桌面应用、Codex CLI 与 IDE 扩展在同一环境中使用同一份 config.toml。即使模型选择器已经更新，以下位置仍可能把请求固定到旧模型：

• config.toml 顶层的 model = "..."；
• profile、项目级 .codex/config.toml 或自定义 agent 配置；
• 命令行 --model / -m；
• 脚本、快捷方式、CI 参数或 IDE 工作区设置。

先备份配置，再临时移除自己添加的模型覆盖，让客户端使用推荐默认值；也可以明确选择 /model 当前列出的模型。官方当前文档还标注：使用 ChatGPT 登录时，一些旧模型已经弃用，旧脚本需要迁移到 Models 页面列出的当前模型。

完成后更新 Codex 到当前版本并重启 App、CLI 或 IDE 扩展。不要删除 auth.json，也不要把整个 .codex 目录发给别人“远程修复”。

官方参考：Config basics、Configuration reference。

模型列表里有但请求 404：可能是官方灰度或后端故障

这种情况真实发生过。OpenAI 官方 Codex 仓库 issue #26892 记录了模型在本地列表中可见，但 Desktop 与 CLI 请求都返回 404 Model not found；OpenAI 工作人员随后确认是后端问题并表示已修复。这说明“本地能看到模型”不能百分之百证明实际响应后端已经同步。

1. 在同一账号尝试一个 /model 中的其他推荐模型；
2. 查看 OpenAI Status 是否有 ChatGPT / Codex 事件；
3. 查看 openai/codex issues 是否有同一模型、同一日期的大量报告；
4. 若其他模型可用，先切换工作，不要持续重装；
5. 问题持续时提交新的 request ID、时间和版本，不要只回复“same”。

不要把某次后端事件永久写成套餐规则，也不要凭个别用户评论断言某个模型永远只对 Plus 或 Pro 开放。模型和套餐可用性应以当前账号模型选择器与官方 Models 页面为准。

API Key 或自定义 provider：再检查模型 ID、权限、wire API 与 base URL

只有在 API Key 或自定义 provider 场景里，endpoint 和 base_url 才是核心变量。OpenAI 高级配置文档说明，自定义 model provider 决定 base URL、wire API、认证和可选请求头；Codex 支持 Responses API，也能连接支持 Chat Completions 的 provider，但官方已将 Chat Completions 支持标记为弃用方向。

• 模型 ID：使用该 provider 实际提供的模型标识；云厂商还可能要求 deployment 名而不是公开模型名。
• 账号权限：模型存在不等于当前 API project 或组织已经获得权限。
• 认证变量：确认环境变量属于当前 provider，不要混用 ChatGPT Session。
• base URL：是否需要 /v1 取决于 provider 文档和 Codex 配置方式，不存在对所有 404 都有效的统一后缀。
• wire API：确认配置为 provider 支持的 Responses 或 Chat Completions 方式。

官方参考：Custom model providers。

仍然失败：准备一份可复现、已脱敏的错误报告

向官方仓库、工作区管理员或支持团队提交时，建议包含：

• 发生日期、精确时间和时区；
• 操作系统、Codex App / CLI / IDE 扩展版本；
• ChatGPT 登录、OpenAI API Key 或自定义 provider；
• 失败模型名，以及同账号下哪个推荐模型可以正常运行；
• 脱敏后的完整错误、request ID、cf-ray（如有）；
• 最小复现命令，不包含项目代码和私密路径；
• 是否在 App、CLI 或 IDE 多个界面复现。

不要提交：auth.json、API Key、Session、设备代码、验证码、恢复码、完整环境变量或带私有仓库内容的日志。401、403 或 OAuth 回调失败不是同一类问题，请使用Codex 登录故障分流。

Codex Model not found / 404 常见问题

Codex 提示 404 Model not found 是网络问题吗？

不一定。网络问题通常不能解释“同一账号的模型 A 正常、模型 B 稳定 404”。先保留请求 URL 和 request ID，再判断是模型、账号、配置、provider 还是服务端。

The model is not supported when using Codex with a ChatGPT account 怎么办？

从 /model 选择当前账号展示的推荐模型，并移除脚本或配置中固定的旧模型。不要用 API 模型存在来推断 ChatGPT 登录一定支持。

Codex 404 是否都要给 URL 加 /v1？

不是。ChatGPT 登录访问 Codex 官方后端时不要套用第三方 API 教程；自定义 provider 是否需要 /v1 应以该服务商和 Codex provider 配置文档为准。

删除 models_cache.json 有用吗？

它最多用于排除本地列表缓存，无法修复账号权限或官方后端。先更新客户端、重启、使用 /model 和对照模型，避免直接删除全部配置与凭证。

重新充值 Plus / Pro 能修复 404 吗？

只有错误被明确确认是套餐不包含目标模型时，套餐才可能相关。模型名写错、客户端旧、provider 地址错误或官方后端故障都不会因为重复充值自动修复。先核对当前账号套餐和模型选择器。