API Error: 400 无效的请求: Claude Desktop 模型路由未配置 - Claude Desktop

Quick fix

升级 cc-switch 至 v3.16.0+，并在供应商表单中显式配置 Haiku 和 Opus 等子任务模型的路由规则。

Symptom

报错原文复制

API Error: 400 无效的请求: Claude Desktop 模型路由未配置: claude-haiku-4-5-20251001 (Claude Desktop model route is not configured: claude-haiku-4-5-20251001)

Cause

在 Claude Desktop 的 Agent 或 Code 场景中，系统会自动调用不同的模型（例如主任务使用 Sonnet/Opus，而子任务或轻量任务调用 Haiku）。如果 cc-switch 代理层仅配置了主模型的路由，未将 Haiku 或 Opus 等内部调用模型纳入路由规则，或者模型名与渠道白名单未正确对齐，就会触发此路由未配置错误。该错误也可能以 JSON 格式出现，例如提示 claude-opus-4-7 路由未配置。

Fix

1. 1

   将 cc-switch 升级到 v3.16.0 或更高版本，该版本已修复此问题并支持 claude-haiku-4-5-20251001 等日期别名。

2. 2

   在 cc-switch 的 Claude Desktop 供应商表单中，显式编辑并配置 Opus、Sonnet 和 Haiku 的 route id，将其映射到对应的上游模型，确保模型名、渠道白名单和实际 provider 模型正确对齐。

Affected Versions

ToolClaude Desktop

Version3.15.0

PlatformsWindowsmacOS

Source Issues

本页汇总自 3 个真实 issue

• #2940claude desktop无法路由opus模型
• #3283对于claude desktop 使用agent时，调用的haiku模型cc switch没有正确的处理
• #3288Haiku 模型已配置，但是路由报错

FAQ

为什么主模型可以正常使用，但开启 Agent 模式后就报错？

Agent 模式会自动触发子任务并调用 Haiku 等轻量模型。如果只配置了主模型的路由，代理层无法处理这些未配置的模型请求。请在配置中显式添加 Haiku 等模型的路由规则。

配置了 Haiku 模型，为什么还是路由报错？

通常是因为模型名、渠道白名单和实际 provider 模型之间没有正确对齐。请确保在供应商表单中显式配置了对应的 route id，并升级到支持日期别名的新版本。

相关问题

401 Unauthorized: Incorrect API key provided切换到 OpenAI Official 或关闭代理后，需手动清空 ~/.codex/auth.json 中残留的第三方 OPENAI_API_KEY 并重启 Codex 以恢复官方 OAuth 登录。2 issues mergedapi failed deserialize json body into按错误类型回退 Claude Code、升级 cc-switch、关闭本地代理或停止发送不支持的字段。7 issues mergedAuthorization header is badly formatted在 cc-switch 中开启“本地路由”选项，并将 API 格式设置为“原生”，即可解决 GitHub Copilot 接入 Claude Code 时的 400 认证头格式错误。2 issues merged