Codex 报错 Error running remote compact task: unexpected status 404 Not Found
这个 404 发生在 Codex 压缩上下文时,不代表普通模型请求失败。先看报错 URL:官方 ChatGPT 地址优先排查 Codex 服务或版本回归,自定义域名则优先确认中转站的 responses/compact 路由是否可用。
错误摘要
Codex 报 Error running remote compact task: unexpected status 404 Not Found: {"detail":"Not Found"} 时,先按 URL 区分官方服务和自定义中转;404 表示压缩路由不存在或暂时不可用,连续重试通常无效。
Codex 自动或手动压缩上下文时显示:
Error running remote compact task: unexpected status 404 Not Found: {"detail":"Not Found"}, url: https://api.example.com/responses/compact, cf-ray: <ray-id>, request id: <request-id>
上面使用的是脱敏示例。实际报错中的域名决定了排查方向;cf-ray 和 request id 只是定位单次请求的追踪标识。
这个错误是什么意思
Codex 会在会话接近上下文阈值时自动压缩历史,也可以通过 /compact 手动触发。此时客户端向 responses/compact 发起请求,服务端却返回 404 Not Found 和 {"detail":"Not Found"},说明当前入口没有匹配到可用的压缩路由。
不要把它当成普通网络抖动。网络已经连到服务端并拿到了明确的 HTTP 404;反复重试同一个地址,通常只会继续返回 404。
先看报错 URL
如果 URL 指向 chatgpt.com/backend-api/codex/responses/compact,说明失败发生在 Codex 的 ChatGPT 登录态链路。OpenAI Codex 官方仓库已有 CLI、Desktop 和 JetBrains 多端复现记录,公开案例在短会话里手动执行 /compact 也会失败。这种场景优先查看官方 issue、Codex 状态和客户端更新,不要先改自定义 Base URL。
如果 URL 指向 api.example.com/responses/compact、api.example.com/v1/responses/compact 或其他自定义域名,说明请求走的是中转站。如果普通对话此前一直正常,base_url 已经能够承载普通 Responses 请求,不应因为报错地址里没有 /v1 就把 Base URL 当成首要问题。优先检查:
- 中转站是否只支持普通 Responses 请求,却没有实现对应的
POST /responses/compact路由。 - 该路由以前可用但突然返回 404 时,中转站是否刚刚部署、切换上游或出现路由回归。
- 反向代理、网关或 Worker 是否只放行了普通 Responses 路由,没有转发 compact 子路由。
截图里出现 Context automatically compacted 后连续报错,并不证明压缩已经成功。会话没有被有效压缩时,后续请求仍可能反复触发同一个失败入口。
怎么解决
URL 是官方 ChatGPT 地址
- 打开 openai/codex #38323,确认当前版本是否仍在复现。
- 更新到官方已发布的修复版本;issue 仍未确认修复时,不要靠重装或删除
~/.codex碰运气。 - 急需继续工作时,新建任务并减少一次性上下文,避免旧会话立即再次触发压缩。这只是临时绕过,不代表原任务已修复。
URL 是自定义中转域名
- 如果入口由你维护,为 compact 路由补充转发,并确认请求方法、鉴权头和响应格式都没有被网关改写。
- 修好路由后若错误变成
503 No available channel for model ...-openai-compact,再添加或映射对应 compact 模型。不要用模型映射去修路由 404。
如果确认使用的是中转站,完成以上检查后仍然返回 404,请带上完整报错、出错时间、模型名和 request id 联系中转站售后处理。
部分社区方案会修改 provider 名称、关闭远程压缩功能或提高 model_auto_compact_token_limit。这些配置受 Codex 版本影响,而且可能只是让客户端暂时不调用该路由。根治仍是恢复或补齐中转站的 compact 路由。
一句话结论
responses/compact 返回 404 时先看 URL 分流:官方地址查 Codex 服务回归,自定义域名查 compact 路由和网关转发,连续重试或单纯调高压缩阈值都不能修复缺失的接口。






