Codex 报错 "Unexpected status 404 Not Found"：三种原因及解决方法

Codex 突然不再响应，报出 unexpected status 404 Not Found。先别急着重装，读一下 404 后面那段文字：2026年9月，同一行报错在官方仓库 openai/codex 里出现了三种不同的原因，每一种都有自己的解法。

你遇到的是哪一种 404？

404 Not Found: 后面的文字就说明了原因。对照下表，直接跳到对应章节。

报错片段	原因	怎么做
Unknown error, url: https://chatgpt.com/backend-api/codex/responses	OpenAI 后端故障	查看 status.openai.com，等待恢复
The model `gpt-5.5` does not exist or you do not have access to it	你的账号或客户端的模型目录里没有这个模型	用 /model 或 -m 切换模型
url: https://chatgpt.com/backend-api/codex/responses/compact	config.toml 里有 remote_compaction_v2 = false	删掉这一行，重新打开 Codex

"404 Not Found: Unknown error"：是你这边的问题吗？

不是。当报错里写着 Unknown error，而且 URL 以 /codex/responses 结尾时，故障在 OpenAI 的后端，你在本机改什么都没用。

2026年9月3日就发生了这种情况。issue #42534 在几分钟内收到了 30 多条报告，覆盖 Windows、macOS 和 Linux，经过不同地区的 Cloudflare 节点（VNO、NRT、SIN、MIA）。其中一条报告显示，连模型列表都拉取失败：

failed to refresh available models: unexpected status 404 Not Found: Unknown error,
url: https://chatgpt.com/backend-api/codex/models?client_version=0.149.1

OpenAI 把这次事件记录为 "Elevated errors across ChatGPT and Codex"，受影响的包括 Codex Web、Codex API、CLI 和 VS Code 扩展，并在当天标记为已解决（status.openai.com）。

怎么做：

1. 打开 status.openai.com。如果 Codex 有未关闭的事件，就到此为止，等待即可。
2. 新建对话或切换模型都没用：在 #42534 里试过的人还是收到同样的 404。
3. 不要急着重装或升级。同一个 issue 里有人把 CLI 从 0.152.1 升到 0.153.0，报错完全没变，因为问题不在客户端。

"The model does not exist or you do not have access to it"：怎么切换模型？

这种 404 表示当前配置的模型在这个客户端里对你的账号不可用。切换到列表里的模型能立刻解决；等模型目录更新才能彻底解决。

2026年9月的两个真实案例：

• gpt-5.5（issue #44477 和 #43415，从9月7日起）：模型在 ChatGPT 应用里仍然可用，但 Codex 路由返回 404。同一环境下，gpt-5.6-sol 可以正常使用。
• gpt-6-sol（issue #47412，9月23日）：在 Windows 上，Codex Desktop 使用内置的 CLI（0.153.4），它的模型目录里既没有 gpt-6-sol 也没有 gpt-6-luna，而单独安装的 CLI 0.156.1 两个都有。

怎么做：在会话里打开选择器，从列表中选一个模型：

/model

在终端里，启动时直接指定模型（-m 或 --model 参数定义在 codex-rs/utils/cli/src/shared_options.rs）：

codex -m gpt-5.6-sol

想固定下来，就写进 ~/.codex/config.toml：

model = "gpt-5.6-sol"

想在选择之前看看你的二进制认识哪些模型？调试子命令会以 JSON 输出模型目录：

codex debug models            # 从服务器刷新的目录
codex debug models --bundled  # 只看二进制内置的目录

如果模型在网页上能看到、这里却没有，问题就在客户端，就像 Windows 上的 Codex Desktop 那样。在 Desktop 发布带新目录的版本之前，先用最新的独立 CLI。

URL 以 "/responses/compact" 结尾：为什么对话直接报废？

如果 404 紧跟在 "Context automatically compacted" 之后出现，并且 URL 以 /codex/responses/compact 结尾，原因是你 config.toml 里一个过时的配置项。删掉那一行，压缩功能就恢复了。

issue #42468（2026年9月3日）记录了这个情况：在 Codex Desktop 26.901、core 0.153.0 上，配置文件里有下面这段的用户

[features]
remote_compaction_v2 = false

会把压缩请求发到一个已下线的端点。最糟的是连锁反应：对话一直高于压缩阈值，于是之后的每一轮都会再次尝试压缩并以同样方式失败，这个会话就彻底不能用了。

怎么做：

1. 查看你的二进制里各个功能开关的状态：

   codex features list

2. 打开 ~/.codex/config.toml，删掉 remote_compaction_v2 = false 这一行。根据该 issue 的描述，改成 true 或直接删除都能恢复压缩。
3. 升级。在 openai/codex 当前源码的 codex-rs/features/src/lib.rs 里，这个开关已标记为 Stage::Removed，也就是不再作为选项存在。

三种都不是？剩下的怎么排查？

运行本地诊断。codex doctor 会检查安装、配置、登录、网络以及与后端的握手，不会尝试修复任何东西：

codex doctor            # 完整报告
codex doctor --summary  # 只看分组摘要
codex doctor --json     # 脱敏版本，便于附到 issue 里

在9月3日的事件中，有用户在 #42534 里展示了网络、TLS 和登录都正常时，404 在报告里的样子：

handshake transport error http 404 Not Found
ChatGPT inference URL: ... reachable (HTTP 404)

网络和 TLS 都正常、握手却是 404，说明问题在 OpenAI 那边，回到第一节即可。如果 doctor 报出代理、证书或登录问题，那就是本地问题，报告里已经写明是哪一项。

提交 issue 时，附上报错末尾的 cf-ray 和 request id。#42534 里的报告正是靠这些证明了这是后端故障，而不是某一台机器的问题。