unexpected status 404 Not Found: CC Switch Codex /responses

Quick fix

升级 cc-switch 到 v3.16.4+，并在 Codex 供应商表单把上游格式显式设为 Chat Completions。

Symptom

报错原文复制

unexpected status 404 Not Found: CC Switch local proxy failed while handling Codex endpoint /responses.
Provider: DeepSeek; model: gpt-5.5; upstream_status: HTTP 404;
cause: 上游错误 (404):, url: http://127.0.0.1:15721/v1/responses

Cause

Codex 会向本地代理发送 OpenAI Responses API 请求，路径为 /v1/responses。DeepSeek 等只兼容 Chat Completions 的上游没有 /responses 端点，因此返回 HTTP 404。该集群中的主要问题是 cc-switch 本地代理未按 provider 的 apiFormat = "openai_chat" 把 Responses 请求翻译成 /v1/chat/completions，而是把 /responses 直接转发给上游。

维护者说明该问题与 v3.16.4 中「上游格式选择器与模型映射开关解耦」的改动有关：上游格式（Chat Completions / Responses）成为独立且始终可见的选择器，不再被本地路由/模型映射开关绑定。对 DeepSeek 这类只支持 Chat Completions 的供应商，需要显式选择 Chat Completions 才会触发 Responses→Chat 转换。另有用户提到会话中输入图片/多媒体也可能导致类似会话崩溃，但主线修复是上游格式设置；#6334 是同一错误模板下的 HTTP 401 变体，提示 API Key 无效或过期，属于凭据问题，不应与 404 路由转换问题混用同一修复。

Fix

1. 1

   升级 cc-switch 到 v3.16.4 或更新版本。

2. 2

   打开 Codex 供应商配置表单，找到 API 高级选项中的「上游格式」，将其显式设为 Chat Completions。

3. 3

   保存配置后重启 Codex，并新建会话重试。

4. 4

   如果错误是 HTTP 401 且提示 The API Key appears to be invalid or may have expired，请检查并更新该 provider 的 API Key，而不是只修改上游格式。

Affected Versions

ToolCodex

Version3.16.1 - 3.16.3；v3.16.4 或更新版本提供显式上游格式选择修复路径

PlatformsWindowsmacOS

Source Issues

本页汇总自 4 个真实 issue

• #3601unexpected status 404 Not Found: CC Switch local proxy failed while handling Codex endpoint /responses
• #4429不能直接连接deepseek
• #4539Bug: Codex + DeepSeek 返回 404 — /v1/responses 端点未翻译为 Chat Completions API
• #6334unexpected status 401 Unauthorized: CC Switch local proxy failed while handling Codex endpoint /responses. Provider: Kimi For Coding; model: MiniMax-M3; upstream_status: HTTP 401;

FAQ

为什么 MiniMax 可以，但 DeepSeek 报 404？

两者 apiFormat 可能都是 openai_chat，但问题表现为 DeepSeek 特定路由未触发 Responses→Chat 转换。将上游格式显式设为 Chat Completions 后，请求会走 /v1/chat/completions。

我已经开启本地路由了，为什么还是 404？

开启本地路由不等于完成格式转换。v3.16.4 后需要在上游格式选择器中显式选择 Chat Completions，才会触发 Responses→Chat 转换。

重开会话或切换模型有用吗？

有用户称在输入图片/多媒体导致会话崩溃后，重开会话可恢复；但主线 404 问题仍需升级并设置上游格式为 Chat Completions。

出现 401 Unauthorized 也是这个问题吗？

#6334 使用相同错误模板，但 upstream_status 是 HTTP 401，原因是 API Key 无效或过期。应先检查凭据，再排查路由格式。

相关问题

Error running remote compact task在 Codex 设置中关闭远程上下文压缩（Remote Compaction），改用本地压缩即可临时绕过此协议转换缺陷。4 issues mergedDeepSeek前缀缓存命中率骤降 - CC Switch修复升级至 cc-switch v3.16.3 以修复格式转换导致的缓存命中率计算错误。2 issues merged第三方模型仍自称 based on GPT-5 - Codex将 `baseInstructions` 覆盖逻辑从 `if profile != ProxyChat` 块移出，使其对 ProxyChat 生效；当前即使配置了 `baseInstructions` 也不会注入。1 issues merged