API Error: 404 Claude Code 路径拼接或未注册路由

Quick fix

检查 API 地址是否被错误拼接，或升级 cc-switch 以修复 OpenAI 兼容模式及本地路由缺失导致的 404 问题。

Symptom

报错原文复制

API Error: 404(/aillm/online/chat/completions/v1/messages)

Cause

在 cc-switch 中遇到 404 错误通常由以下两种路径处理机制引起： 1. API 路径错误拼接：在使用“OpenAI Chat Completions”等兼容模式时，早期版本未正确转换 API 格式，而是直接在用户填写的完整请求地址后盲目拼接 /v1/messages，导致请求指向不存在的嵌套路径。 2. 本地路由未注册：在适配 Claude Desktop 等客户端时，客户端初始化会请求 GET /v1/models 获取模型列表，若 cc-switch 版本未注册该本地路由接口，也会直接返回 404。

Fix

1. 1

   修改 cc-switch 中的 API 请求地址，仅填写 Base URL（如 https://padd.cn/aillm/online），不要包含完整的 /chat/completions 路径，避免路径被重复拼接。

2. 2

   升级 cc-switch 至最新版本，以应用针对 OpenAI 兼容模式 URL 拼接逻辑（修复 #924）以及本地路由 /v1/models 接口转发的官方修复。

Affected Versions

ToolClaude Code

Version未知

PlatformsWindows

Source Issues

本页汇总自 2 个真实 issue

• #882使用OpenAI Chat Completions（需要开启代理）功能没成功转换API格式
• #2339bugs

FAQ

为什么配置第三方平台（如 MiMo/Codex）时也会报 404？

这通常是因为 cc-switch 尚未完全集成该平台的特定 API 格式或接口，导致请求被路由到错误的上游端点。建议检查官方文档或等待后续版本适配。

除了 404，终端还提示 503、429 或 403 错误是什么原因？

这些错误通常与上游 API 提供商的限流（429）、服务不可用（503）或鉴权失败（403）有关，并非 cc-switch 本地的路径拼接问题。请检查你的 API Key 状态及上游服务健康度。

相关问题

无法应用于claude code for VS Code - Claude Code删除 VS Code 中关于 claude code 的旧代理设置，并在 cc-switch 中重新开关“应用到Claude Code插件”选项即可解决。1 issues mergedHTTP 401 超出256K上下文限制 - CC Switch & Codex在 Codex 的 config.toml 中调低 AUTO COMPACT 触发阈值，避免请求体实际 Token 数超过上游 Kimi 的 256K 限制。2 issues merged正文内容频繁出现在 thinking（思考）块内，visible text 块几乎为空升级 cc-switch 至包含 PR #4210 的版本，将预注入 thinking 占位符改为反应式处理即可解决长上下文会话冻结与正文折叠问题。1 issues merged