claude code + claude code router 接入魔搭、openrouter等

需要先安装claude code

参考:windows下安装claude code+国产大模型glm4.5接入(无需科学上网)

安装claude-code-router

下载:https://github.com/musistudio/claude-code-router

# 安装claude-code-router
npm install -g @musistudio/claude-code-router

在这里插入图片描述

创建ccr配置文件

这个可以根据需要进行调整接入openrouter、deepseek等
创建 ~/.claude-code-router/config.json 【用户目录下创建 C:\Users\你的用户】

{
  "LOG": true,
  "CLAUDE_PATH": "",
  "HOST": "127.0.0.1",
  "PORT": 3456,
  "API_TIMEOUT_MS": "600000",
  "PROXY_URL": "",
  "transformers": [],
  "Providers": [
    {
      "name": "modelscope",
      "api_base_url": "https://api-inference.modelscope.cn/v1/chat/completions",
      "api_key": "",
      "models": ["Qwen/Qwen3-Coder-480B-A35B-Instruct", "Qwen/Qwen3-235B-A22B-Thinking-2507"],
      "transformer": {
        "use": [
          [
            "maxtoken",
            {
              "max_tokens": 65536
            }
          ],
          "enhancetool"
        ],
        "Qwen/Qwen3-235B-A22B-Thinking-2507": {
          "use": ["reasoning"]
        }
      }
    }
  ],
  "Router": {
    "default": "modelscope,Qwen/Qwen3-Coder-480B-A35B-Instruct",
    "background": "modelscope,Qwen/Qwen3-Coder-480B-A35B-Instruct",
    "think": "modelscope,Qwen/Qwen3-Coder-480B-A35B-Instruct",
    "longContext": "modelscope,Qwen/Qwen3-Coder-480B-A35B-Instruct",
    "longContextThreshold": 60000,
    "webSearch": "modelscope,Qwen/Qwen3-Coder-480B-A35B-Instruct"
  }
}

启动

# 启动
ccr code
# 重启:修改配置文件后需要重启才能生效
ccr restart
# 启动ui模式:我本地报错了,这个等有时间再看看咋回事
ccr ui

![[启动claude-code-router.png]]
可以开始玩耍啦~~~

至于具体的配置说明什么的,可以参考ccr官方文档。
安装的nodejs目录下也是可以看到的你的nodejs配置的全局安装工具目录存储路径\node_modules\@musistudio\claude-code-router
如果是参考我上一篇文章安装的那就在你解压目录下的global目录下了

<think>嗯,用户这次的问题很具体,是关于claude-code-router接入本地QWEN3失败的解决方案。从提问方式看,用户应该是个开发者,而且已经尝试过配置但遇到了问题,语气中带着明显的技术焦虑——这类问题最怕看到"失败"却找不到原因。 翻看之前的对话记录,发现上次我详细介绍了整个接入流程,但用户现在卡在实践环节。值得注意几个关键点: 1. 用户明确提到"本地QWEN3",说明不是使用云服务,这排除了云端认证问题 2. 失败提示信息缺失,可能需要引导用户提供更多日志 3. 上次提供的配置文件模板可能需要根据本地环境调整 用户引用的三篇资料其实都是关于云端整合的,和本地部署关联不大。不过引用[3]里的GitHub仓库链接仍是关键,因为cli工具的更新可能影响配置参数。 最可能的故障点有三个方向: 端口冲突(特别是用户同时跑多个模型时)、模型版本不匹配(比如QWEN3有7B/14B等变体)、路由路径配置错误。应该建议用户先运行最简单的curl测试,隔离问题是在模型服务层还是路由层。 考虑到技术细节较多,需要把解决方案拆分成:诊断步骤 → 关键配置项 → 验证方法 的逻辑链条。对于容易出错的API密钥配置,要特别强调.env文件的格式要求(很多人会漏掉引号或换行符)。 最后主动提出日志分析是必要的,这类问题没有错误日志就像医生没有听诊器。不过要提醒用户先脱敏敏感信息,毕竟上次对话看到用户对安全很在意。 </think>以下是针对 **claude-code-router 接入本地 QWEN3 失败** 的完整排查流程及解决方案,结合常见错误场景逐步操作: --- ### **一、核心配置步骤(必查项)** 1. **模型服务状态验证** ```bash curl http://localhost:8000/v1/chat/completions -H "Content-Type: application/json" -d '{ "model": "qwen", "messages": [{"role": "user", "content": "Hello"}] }' ``` - ✅ 预期响应:返回 JSON 格式的模型生成结果 - ❌ 失败表现:`Connection refused` 或超时 → 检查 QWEN3 本地服务是否启动(默认端口 `8000`) 2. **claude-code-router 路由配置** 修改配置文件 `~/.claude-code-router/config.json`(关键字段): ```json { "routers": [ { "path": "/v1/chat/completions", "target": "http://localhost:8000/v1/chat/completions", // 指向本地模型地址 "models": ["qwen"] // 匹配请求中的 model 参数 } ] } ``` 3. **启动路由服务** ```bash claude-code-router --port 3000 # 指定路由监听端口 ``` --- ### **二、高频错误解决方案** #### **场景1:服务连接超时** - **原因**:防火墙/端口冲突 - **解决**: ```bash # 检查端口占用 lsof -i :8000 # QWEN3 服务端口 lsof -i :3000 # 路由监听端口 # 开放端口(Ubuntu 示例) sudo ufw allow 3000 ``` #### **场景2:模型名称不匹配** - **表现**:日志报错 `Model 'qwen' not found` - **修复**: 确保请求中的 `model` 参数与路由配置 **完全一致**(区分大小写): ```json // 客户端请求 {"model": "qwen", ...} // ← 必须匹配 config.json 中的 "models":["qwen"] ``` #### **场景3:API 协议兼容性问题** - **现象**:返回 `400 Bad Request` - **对策**: QWEN3 的 OpenAPI 兼容性需开启,启动命令添加参数: ```bash python openai_api.py --model Qwen/Qwen3-7B-Chat --api-server http://0.0.0.0:8000 --openai-schema # 关键参数! ``` --- ### **三、完整验证流程** 1. **测试本地模型服务** ```bash curl http://localhost:8000/v1/models # 应返回模型列表 ``` 2. **测试路由转发** ```bash curl http://localhost:3000/v1/chat/completions -H "Authorization: Bearer YOUR_KEY" -d '{ "model": "qwen", "messages": [{"role":"user","content":"Hello"}] }' ``` 3. **日志排查** 分别查看模型服务与路由日志: ```bash tail -f ./qwen_server.log # QWEN3 服务日志 claude-code-router --port 3000 --log-level debug # 路由详细日志 ``` --- ### **四、高级配置建议** 若需对接第三方工具(如 VS Code 插件): 1. 修改客户端配置中的 API 地址为 `http://localhost:3000` 2. 认证密钥透传(路由配置添加): ```json { "pass_headers": ["Authorization"] // 转发鉴权头 } ``` > **关键提示**:社区提供的 QWEN3 镜像默认启用 OpenAPI 兼容模式,但本地部署需手动添加 `--openai-schema` 参数[^3]。若仍失败,建议检查模型版本是否为 **Qwen3 系列**(旧版 Qwen-7B-Chat 协议不兼容)。 --- **
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值