Skip to content
CC Switch WikiUnofficial Community Wiki

API Error: 404 - Claude Code path assembly or unregistered route

Quick fix

Check whether the API address was assembled wrongly, or upgrade cc-switch for the 404 from OpenAI-compatible mode and the missing local route.

Symptom

Section titled “Symptom”
Error output
API Error: 404(/aillm/online/chat/completions/v1/messages)

Cause

Section titled “Cause”

A 404 in cc-switch usually comes from one of two path handling mechanisms: 1. API path assembled wrongly: in a compatibility mode such as "OpenAI Chat Completions", early versions did not convert the API format properly and simply appended /v1/messages to the full request address you entered, pointing the request at a nested path that does not exist. 2. Local route not registered: when supporting a client such as Claude Desktop, client initialisation requests GET /v1/models for the model list, and a cc-switch version that has not registered that local route endpoint returns 404 outright.

Fix

Section titled “Fix”

  1. Change the API request address in cc-switch to the Base URL only (https://padd.cn/aillm/online, for example) without the full /chat/completions path, so the path is not appended twice.

  2. Upgrade cc-switch to the latest version for the official fixes to OpenAI-compatible mode URL assembly (#924) and forwarding the local /v1/models route.

Affected Versions

Section titled “Affected Versions”
ToolClaude Code
VersionUnknown
PlatformsWindows

Source Issues

Section titled “Source Issues”

This page is distilled from 2 real issues

FAQ

Section titled “FAQ”
Why does configuring a third-party platform (MiMo/Codex) also report 404?
Usually because cc-switch has not fully integrated that platform's specific API format or endpoints, so the request is routed to the wrong upstream endpoint. Check the official documentation, or wait for support in a later version.
Besides 404, the terminal also reports 503, 429, or 403. Why?
Those usually relate to upstream API provider rate limiting (429), service unavailability (503), or authentication failure (403), not local path assembly in cc-switch. Check your API key status and upstream service health.
Section titled “Related problems”
Claude Code cannot be applied in VS CodeRemove old Claude Code proxy settings in VS Code, then toggle Apply to Claude Code plugin in cc-switch again.1 issues mergedHTTP 401 exceeding the 256K context limit - CC Switch & CodexLower the AUTO COMPACT trigger threshold in the Codex config.toml so the real token count of the request body stays under the Kimi 256K limit.2 issues mergedBody text appears in thinking blocks, visible text nearly emptyUpgrade cc-switch to a build with PR #4210. Reactive thinking-placeholder handling fixes long-context freezes and body-text collapse.1 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.