Skip to content
CC Switch WikiUnofficial Community Wiki

Not found (404) - CC Switch

Quick fix

Upgrade cc-switch to v3.16.3 for the 404 from /v1/ appended wrongly to a Base URL, and enable the media fallback so images cannot trip the breaker.

Symptom

Section titled “Symptom”
Error output
Not found (404)

Cause

Section titled “Cause”

The Base URL of providers such as Zhipu GLM already contains a version path (https://open.bigmodel.cn/api/coding/paas/v4). Older cc-switch connectivity test logic appended /v1/chat/completions unconditionally, making the final request path .../v4/v1/chat/completions, which upstream rejects with 404. Separately, with Codex, requesting the /v1/responses endpoint can also 404 when upstream does not support it.

On the other hand, sending an image to a model that does not accept image input (Xiaomi MiMo, for instance) makes upstream return a 404 saying No endpoints found that support image input. Older cc-switch did not distinguish that error type and tripped the global circuit breaker outright, blocking every Claude Code window.

Fix

Section titled “Fix”

  1. Upgrade cc-switch to v3.16.3 or newer. That version reworked provider detection to do a lightweight reachability probe against base_url, removed the hard-coded test request that produced the doubled version path, and fixed the 404 fetching a model list on a /v{N} endpoint.

  2. For the image request tripping the circuit breaker, upgrade to v3.16.2 or newer and enable the 媒体回退 rectifier (unsupported-image fallback rectifier) in settings. With it on, an image block is replaced automatically with an [Unsupported Image] placeholder when upstream is a text-only model, avoiding the global block.

Affected Versions

Section titled “Affected Versions”
ToolCC Switch
Version3.16.0 - 3.16.2
PlatformsmacOS

Source Issues

Section titled “Source Issues”

This page is distilled from 3 real issues

FAQ

Section titled “FAQ”
Why does the Claude CLI work while Codex reports 404?
Codex requests the /v1/responses endpoint by default while the Claude CLI uses /v1/chat/completions. If the upstream provider (a custom dpv4 GLM, say) does not support /responses, it returns 404. Make sure the provider config supports Codex routing, or upgrade cc-switch for better endpoint compatibility.
Testing Zhipu GLM reports Rate limited (429). What is that?
Usually the official Zhipu rate limit triggered by too many requests, unrelated to the 404 path assembly. Retry later, or check the quota on your API key.
Section titled “Related problems”
codex never shows the ds model - CodexCodex desktop needs an official login state to show third-party models. Enable keep-official-login-when-switching in cc-switch and restart.3 issues mergedVolcengine Agent Plan Auto-Identify Model List Failed 404Manually modify config.toml to match official docs and add models in modelCatalog to bypass 404.2 issues mergedOnly 258k context in codex - CodexOnce cc-switch maps a minimax model onto gpt-5.5, the hard-coded Codex and Claude Code context limits apply and the 1M context is lost.3 issues merged

This is an unofficial community wiki with no affiliation to the cc-switch authors or the project itself. Its content is compiled from the project's public GitHub issues. This site distributes no software.