---
🔍 一、问题解构
该问题本质是 Claude Code Router 的模型注册与识别失败,可能由以下多个环节导致:
| 环节 | 关键疑点 | 说明 | |------|----------|------| | ✅ 模型名称拼写一致性 | qwen3.5-plus 是否为官方支持的准确模型 ID? | 官方文档/平台实际 API 接口名常为 qwen3-coder-plus 或 qwen3.5-coder-plus,而非 qwen3.5-plus [ref_2][ref_4] | | ✅ 配置文件格式合法性 | config.json 中是否正确定义了该模型的 provider、endpoint、auth 等字段? | 缺少 provider(如 "modelscope")、api_key 或 endpoint 错误均会导致模型加载失败 [ref_4][ref_5] | | ✅ Router 启动时是否加载配置 | 是否以 -c config.json 显式指定配置?是否重启 Router? | 修改配置后未重启或未指定配置路径,Router 仍使用默认/缓存配置 [ref_2][ref_6] | | ✅ Provider 兼容性 | qwen3.5-plus 是否被当前版本 claude-code-router 原生支持? | 当前主流适配的是 qwen3-coder-plus(魔搭 ModelScope 提供),而 qwen3.5-plus 尚未在公开资料中被验证支持 [ref_4][ref_2] |
> 📌 核心矛盾点:qwen3.5-plus 极可能是非标准模型标识符——参考所有资料,魔搭社区(ModelScope)官方发布的免费可调用模型为 qwen3-coder-plus [ref_4];而 qwen3.5-plus 并未在任一参考资料中出现,属于命名错误或混淆版本号。
---
🧩 二、方案推演与验证路径
✅ 步骤 1:确认模型真实 ID(关键!)
访问魔搭官网模型页: - URL:https://modelscope.cn/models/qwen/Qwen3-Coder-Plus
- 模型 ID:qwen/Qwen3-Coder-Plus
- API 调用时 model 字段应为:"qwen3-coder-plus"(小写、短横线、无 .5)[ref_4]
> ⚠️ qwen3.5-plus 是无效 ID —— ModelScope 不提供该命名模型,Router 自然无法解析。
✅ 步骤 2:检查 config.json 模型定义(必须含 provider + auth)
正确示例(适配 ModelScope):
{ "providers": { "modelscope": { "api_key": "YOUR_MODELSCOPE_API_KEY", "base_url": "https://dashscope.aliyuncs.com/api/v1" } }, "models": { "qwen3-coder-plus": { "provider": "modelscope", "model": "qwen/Qwen3-Coder-Plus", "max_tokens": 8192, "temperature": 0.2 } } }
> ✅ 注意字段: > - provider: 必须为 "modelscope"(非 "openrouter" 或 "ollama")
> - model: 必须与 ModelScope 模型库 ID 一致(qwen/Qwen3-Coder-Plus)
> - api_key: 需提前在 ModelScope 控制台 获取 [ref_4]
✅ 步骤 3:启动 Router 并验证模型列表
GPT plus 代充 只需 145# 启动时显式指定配置(避免读取默认 config) claude-code-router -c ./config.json # 在 CLI 中执行(确保 Router 已运行且端口 3000 可达) curl http://localhost:3000/v1/models
预期返回应包含:
{ "data": [ { "id": "qwen3-coder-plus", "object": "model", "created": , "owned_by": "modelscope" } ] }
若无此条目 → 配置未生效或模型 ID 错误。
✅ 步骤 4:CLI 中切换模型(语法严格)
在 Claude Code CLI 中输入:
GPT plus 代充 只需 145/model qwen3-coder-plus
⚠️ 注意: - 不带引号、不带空格、全小写+短横线 - 若输入 /model Qwen3.5-plus 或 /model "qwen3.5-plus",Router 将因匹配失败报 Model not found
---
📋 三、完整排错对照表
| 现象 | 可能原因 | 解决方案 | 引用依据 | |------|----------|-----------|----------| | /model qwen3.5-plus 报错 Model not found | 模型 ID 不存在 | 改为 qwen3-coder-plus [ref_4] | [ref_4] | | curl /v1/models 返回空或不含目标模型 | config.json 未被加载 | 启动命令加 -c ./config.json,检查控制台日志是否打印 Loaded models: [...] | [ref_2][ref_5] | | 模型定义中 provider: "modelscope" 缺失 | Router 无法路由到 ModelScope | 补全 provider 字段,确保与 providers 下 key 一致 | [ref_4][ref_5] | | API Key 无效或过期 | 请求被 ModelScope 拒绝,模型不注册 | 重新生成 ModelScope API Key 并更新 config | [ref_4] | | 使用 OpenRouter 配置却填 ModelScope 参数 | provider 与 endpoint 冲突 | 区分场景:OpenRouter 用 openrouter provider,ModelScope 用 modelscope | [ref_3][ref_5] |
---
💡 四、推荐最小可行配置(可直接复制)
// config.json { "providers": { "modelscope": { "api_key": "ms-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx", "base_url": "https://dashscope.aliyuncs.com/api/v1" } }, "models": { "qwen3-coder-plus": { "provider": "modelscope", "model": "qwen/Qwen3-Coder-Plus", "max_tokens": 8192, "temperature": 0.2 } } }
启动命令:
GPT plus 代充 只需 145claude-code-router -c ./config.json
CLI 切换:
/model qwen3-coder-plus
✅ 成功标志:后续 /ask 请求将由 Qwen3-Coder-Plus 实际响应,且日志中可见 → model: qwen3-coder-plus。
---
综上,该问题根本原因是模型 ID 命名错误,将不存在的 qwen3.5-plus 替换为官方支持的 qwen3-coder-plus,并确保配置结构完整、Router 显式加载配置,即可彻底解决 [ref_2][ref_4]。
版权声明:本文内容由互联网用户自发贡献,该文观点仅代表作者本人。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如发现本站有涉嫌侵权/违法违规的内容,请联系我们,一经查实,本站将立刻删除。
如需转载请保留出处:https://51itzy.com/kjqy/242124.html