蔚蓝技术舱 - 详情

本文将详细介绍如何配置阿里最新发布的 Qwen3-Coder 模型与 Claude Code 的集成方案，实现高效的 AI 编程体验。

前置条件检查

Node.js 版本要求

安装 ClaudeCode + ClaudeCodeRouter 的前提是 Node.js 版本必须 ≥ 20.11.1，否则会遇到以下错误：

ccr start
C:\Users\Administrator\AppData\Roaming\npm\node_modules\@musistudio\claude-code-router\dist\cli.js:4073
    var channels = diagnostics.tracingChannel("fastify.request.handler");
                               ^

TypeError: diagnostics.tracingChannel is not a function
    at node_modules/.pnpm/fastify@5.4.0/node_modules/fastify/lib/wrapThenable.js (C:\Users\Administrator\AppData\Roaming\npm\node_modules\@musistudio\claude-code-router\dist\cli.js:4073:32)
    at __require (C:\Users\Administrator\AppData\Roaming\npm\node_modules\@musistudio\claude-code-router\dist\cli.js:10:50)
    at node_modules/.pnpm/fastify@5.4.0/node_modules/fastify/lib/handleRequest.js (C:\Users\Administrator\AppData\Roaming\npm\node_modules\@musistudio\claude-code-router\dist\cli.js:4132:24)
    at __require (C:\Users\Administrator\AppData\Roaming\npm\node_modules\@musistudio\claude-code-router\dist\cli.js:10:50)
    at node_modules/.pnpm/fastify@5.4.0/node_modules/fastify/lib/reply.js (C:\Users\Administrator\AppData\Roaming\npm\node_modules\@musistudio\claude-code-router\dist\cli.js:9669:21)
    at __require (C:\Users\Administrator\AppData\Roaming\npm\node_modules\@musistudio\claude-code-router\dist\cli.js:10:50)
    at node_modules/.pnpm/fastify@5.4.0/node_modules/fastify/fastify.js (C:\Users\Administrator\AppData\Roaming\npm\node_modules\@musistudio\claude-code-router\dist\cli.js:33400:17)
    at __require (C:\Users\Administrator\AppData\Roaming\npm\node_modules\@musistudio\claude-code-router\dist\cli.js:10:50)
    at Object.<anonymous> (C:\Users\Administrator\AppData\Roaming\npm\node_modules\@musistudio\claude-code-router\dist\cli.js:56105:30)
    at Module._compile (node:internal/modules/cjs/loader:1254:14)

检查当前 Node.js 版本：

#### 检查当前版本
node --version

#### 如果使用 nvm 管理 Node.js
nvm install 20
nvm use 20

#### 或者从官网下载最新 LTS 版本
https://nodejs.org/

升级 Node.js 版本：

下载 NVM Windows 版本：

https://github.com/coreybutler/nvm-windows/releases

安装nvm之后，

卸载电脑上安装的低版本node.js，然后再控制台输入

# 查看可用的 Node.js 版本
nvm list available

# 安装 Node.js 20
nvm install 20.11.1

# 切换到新版本
nvm use 20.11.1

# 验证版本
node --version

魔搭社区APIkey的获取：

首先登录魔搭社区：

https://modelscope.cn/my/overview

重要：必须绑定阿里云账号，否则 API 请求会返回 401 错误：

访问Qwen3-Coder模型页面：

https://modelscope.cn/models/Qwen/Qwen3-Coder-480B-A35B-Instruct/summary

点击右侧的【查看代码范例】获取 API Key

注意：获取的 API Key 会包含 ms- 前缀，使用时需要移除此前缀

安装ClaudeCode + ClaudeCodeRouter了

文档地址：https://github.com/musistudio/claude-code-router/blob/main/README_zh.md

快速入门

安装首先，请确保您已安装 Claude Code：

npm install -g @anthropic-ai/claude-code

然后，安装 Claude Code Router：

npm install -g @musistudio/claude-code-router

在用户主目录创建配置文件（需要手动创建目录）：~/.claude-code-router/config.json

Windows 路径示例： C:/Users/Administrator/.claude-code-router/config.json

这里注意：【.claude-code-router】的路径必须有【.】

config.json的示例如下（仅配置了魔搭社区，如要配置其他接入商，可自行参考ClaudeCodeRouter的文档）：

{
  "Providers": [
    {
      "name": "modelscope",
      "api_base_url": "https://api-inference.modelscope.cn/v1/chat/completions",
      "api_key": "填入刚才获取的魔搭apiKey",
      "models": [ "Qwen/Qwen3-Coder-480B-A35B-Instruct" ],
      "transformer": {
        "use": [
          [
            "maxtoken",
            {
              "max_tokens": 65536
            }
          ],
          "enhancetool"
        ]
      }
    }
  ],
  "Router": {
    "default": "modelscope,Qwen/Qwen3-Coder-480B-A35B-Instruct"
  },
  "HOST": "127.0.0.1",
  "LOG": true
}

启动claude-code-router

ccr code

启动后会显示一系列配置信息（关于 Claude 的提示可以忽略，这是内置提示词导致的）：

接下来，enjoy~

重启服务

注意: 如果修改了配置文件，需要重启服务：

ccr restart

接入其他插件

直接接入 Roocode、Cline、Kilocode 等插件

因为魔搭的 URL 是 OpenAI 兼容的，这意味着我们可以很方便地直接将其及接入到我们的插件中去，而仅仅只需要做一点点修改。

配置参数

配置项	值
供应商选择	OpenAI 兼容（也就是 OpenAI Compatible）
Base URL	https://api-inference.modelscope.cn/v1
API KEY	你从魔搭社区创建的密钥
Model	Qwen/Qwen3-Coder-480B-A35B-Instruct
图片支持	❌ 不支持图片输入
Context Windows Sizes	262000
模型温度（temperature）	0.7

这样就可以使用了。

Claude Code官网使用文档

https://docs.anthropic.com/zh-CN/home

1. 高频使用命令

命令	说明	使用频率
`claude`	启动交互式对话（最常用）	⭐⭐⭐⭐⭐
`claude --file <path>`	分析指定文件内容（支持代码、日志、配置等）	⭐⭐⭐⭐⭐
`claude --diff`	对比代码变更（如 Git diff），并提供优化建议	⭐⭐⭐⭐
`claude --project`	分析整个项目结构，理解上下文	⭐⭐⭐⭐
`claude mcp list`	查看当前可用的 MCP（Model Control Plug-ins）工具	⭐⭐⭐
`claude config`	配置模型参数、默认行为和用户偏好	⭐⭐⭐
`claude history`	查看历史对话记录	⭐⭐⭐
`claude --debug`	开启调试模式，输出详细日志信息	⭐⭐
`claude update`	检查并更新到最新版本	⭐⭐
`claude --help`	显示帮助文档与命令用法	⭐⭐

提示：

--file 和 --diff 是开发中最常使用的分析工具。

--project 适合在大型项目中建立上下文理解。

推荐定期运行 claude update 以获取新功能。

2. 会话快捷键

快捷键	功能
`↑` / `↓`	浏览历史输入命令或问题
`⌘K` / `Ctrl+K`	清空当前会话屏幕（保留上下文）
`⌘S` / `Ctrl+S`	将 Claude 当前输出保存为代码片段（Snippet）
`Tab`（双击）	在多个建议之间切换；部分客户端支持转为 Markdown 格式预览
`Alt + Enter`	换行
`Ctrl + C`	退出终端
`/`	查看所有命令
`Esc`	打断正在进行的任务

使用技巧：

使用 ↑ 可快速复用之前的提问，提高效率。

Ctrl+S 适用于保存生成的代码、配置模板等。

双击 Tab 可在多轮建议中导航，尤其在 --diff 或 --file 分析时非常实用。