Not found (404) - CC Switch

Quick fix

升级 cc-switch 至 v3.16.3 以修复智谱 GLM 等 Base URL 被错误拼接 /v1/ 导致的 404 报错，并开启媒体回退防止图片请求触发全局熔断。

Symptom

报错原文复制

Not found (404)

Cause

智谱 GLM 等供应商的 Base URL 本身已包含版本路径（如 https://open.bigmodel.cn/api/coding/paas/v4）。旧版 cc-switch 的连通性测试逻辑会强制拼接 /v1/chat/completions，导致最终请求路径变为 .../v4/v1/chat/completions，从而被上游服务器拒绝并返回 404。此外，当使用 Codex 时，若请求 /v1/responses 端点也可能因上游不支持而报 404。

另一方面，当向不支持图片输入的模型（如小米 MiMo）发送图片时，上游会返回 No endpoints found that support image input 的 404 错误。旧版 cc-switch 未区分此错误类型，直接触发全局熔断器，导致所有 Claude Code 窗口被阻断。

Fix

1. 1

   升级 cc-switch 至 v3.16.3 或更高版本。该版本重构了供应商检测逻辑，对 base_url 进行轻量级可达性探测，移除了会导致双重版本路径的硬编码测试请求，同时修复了获取模型列表在 /v{N} 端点上的 404 问题。

2. 2

   针对图片请求导致的 404 熔断问题，请升级至 v3.16.2 及以上版本，并在设置中开启「媒体回退 rectifier」（unsupported-image fallback rectifier）。开启后，当上游为纯文本模型时，图片块会被自动替换为 [Unsupported Image] 占位符，避免全局阻断。

Affected Versions

ToolCC Switch

Version3.16.0 - 3.16.2

PlatformsmacOS

Source Issues

本页汇总自 3 个真实 issue

• #3594[Bug] 图片请求触发全局熔断，导致所有窗口不可用
• #4083[Bug] "Test Model" fails with 404 for Zhipu GLM due to hardcoded /v1/ path appending
• #4631codex app报cause: 上游错误 (404):, url: http://127.0.0.1:15721/v1/responses

FAQ

为什么 Claude CLI 正常，但 Codex 报 404？

Codex 默认请求 /v1/responses 端点，而 Claude CLI 使用 /v1/chat/completions。如果上游供应商（如自定义 dpv4 的 GLM）不支持 /responses 端点，就会返回 404。请确保供应商配置支持 Codex 的路由，或升级 cc-switch 以获取更好的端点兼容性。

测试智谱 GLM 时提示 Rate limited (429) 是怎么回事？

这通常是因为请求频率过高触发了智谱官方的限流，与 404 路径拼接错误无关。请稍后重试或检查 API Key 的配额。

相关问题

codex从来不显示ds的模型 - CodexCodex 桌面端需官方登录态才显示第三方模型，请在 cc-switch 开启「切换第三方时保留官方登录」并重启。3 issues merged火山引擎 Agent Plan 自动识别模型列表失败 404手动修改 config.toml 匹配官方文档，并在 modelCatalog 中手动添加模型列表以绕过 404 错误。2 issues mergedcodex中只有258k上下文 - Codexcc-switch 将 minimax 模型映射为 gpt-5.5 后，会触发 Codex 和 Claude Code 的硬编码上下文限制，导致 1M 上下文失效。3 issues merged