WSL2安装使用Qwen-Code白嫖千问480b大模型超详细教程（魔塔API免费token）
一、准备工作：安装WSL2环境
1. 启用WSL2功能
首先我们需要在Windows中启用WSL2（Windows Subsystem for Linux 2）功能，这是运行Linux环境的基础。
操作步骤：
- 以管理员身份打开PowerShell（在开始菜单搜索PowerShell，右键选择"以管理员身份运行"）
- 输入以下命令并回车：
wsl --install
PS C:\Windows\system32> wsl --install
正在安装: Ubuntu
正在安装: Windows Subsystem for Linux
安装成功！请重启计算机以完成安装。
正在安装: Ubuntu
正在安装: Windows Subsystem for Linux
安装成功！请重启计算机以完成安装。
如果系统提示需要重启，请重启电脑。这个命令会自动启用WSL功能并安装默认的Linux发行版（通常是Ubuntu）。
2. 验证WSL2安装
重启后，打开PowerShell输入：
wsl -l -vNAME STATE VERSION
* Ubuntu Running 2
* Ubuntu Running 2
应该能看到已安装的Linux发行版和WSL版本（应该是WSL2）。
二、配置WSL2中的Ubuntu环境
- 安装完成后，在开始菜单中打开"Ubuntu"应用
- 第一次启动会要求创建用户名和密码（记住这个密码，后续需要）
- 更新系统软件包：
sudo apt update && sudo apt upgrade -y
Get:1 http://archive.ubuntu.com/ubuntu focal InRelease [265 kB]
Get:2 http://security.ubuntu.com/ubuntu focal-security InRelease [114 kB]
Fetched 379 kB in 2s (212 kB/s)
Reading package lists... Done
Building dependency tree
Reading state information... Done
All packages are up to date.
Get:2 http://security.ubuntu.com/ubuntu focal-security InRelease [114 kB]
Fetched 379 kB in 2s (212 kB/s)
Reading package lists... Done
Building dependency tree
Reading state information... Done
All packages are up to date.
三、安装Node.js环境（Qwen-Code的必要条件）
Qwen-Code需要Node.js 20及以上版本才能运行。
1. 安装Node.js
在Ubuntu终端中依次执行：
curl -sL https://deb.nodesource.com/setup_20.x | sudo -E bash -
sudo apt install -y nodejs## Installing the NodeSource Node.js 20.x repo...
## Populating apt-get cache...
+ apt-get update
## Installing packages required for setup:
+ apt-get install -y ca-certificates curl gnupg
## Adding the NodeSource signing key to your keyring...
## Creating apt sources list file for the NodeSource Node.js 20.x repo...
Installation successful!
## Populating apt-get cache...
+ apt-get update
## Installing packages required for setup:
+ apt-get install -y ca-certificates curl gnupg
## Adding the NodeSource signing key to your keyring...
## Creating apt sources list file for the NodeSource Node.js 20.x repo...
Installation successful!
2. 验证安装
node -v
npm -vPS C:\Windows\system32> node -v
v20.16.0
v20.16.0
PS C:\Windows\system32> npm -v
10.8.2
应该显示Node.js和npm的版本号，确认Node.js 20+已安装。
四、安装Qwen-Code
现在我们可以安装Qwen-Code了！
方法一：全局安装（推荐）
npm install -g @qwen-code/qwen-codePS C:\Windows\system32> npm install -g @qwen-code/qwen-code
npm notice Creating default global installation directory...
npm notice New major version of npm available! 10.8.2 -> 11.0.0
npm notice Changelog: https://github.com/npm/cli/releases/tag/v11.0.0
npm notice Run npm install -g [email protected] to update!
+ @qwen-code/[email protected]
added 85 packages from 62 contributors in 15.232s
npm notice Creating default global installation directory...
npm notice New major version of npm available! 10.8.2 -> 11.0.0
npm notice Changelog: https://github.com/npm/cli/releases/tag/v11.0.0
npm notice Run npm install -g [email protected] to update!
+ @qwen-code/[email protected]
added 85 packages from 62 contributors in 15.232s
方法二：临时使用（不安装）
npx @qwen-code/qwen-code五、获取魔塔API免费token
魔塔(ModelScope)平台提供Qwen-Code的免费API服务，每天有2000次免费额度。
1. 注册魔塔账号
- 访问 魔塔官网
- 使用阿里云账号登录（必须先绑定阿里云账号，否则会提示"Please bind your Alibaba Cloud account before use."）
- 如果没有阿里云账号，需要先注册阿里云账号或者直接支付宝扫描登陆
2. 获取API Key
- 登录后，点击右上角头像 → "用户设置" → "API-Key"
- 点击"创建新的API-Key"按钮
- 复制生成的API Key（格式类似
ms-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx）
┌──────────────────────────────────────────────────────┐
│ 魔塔 API Key 管理页面 │
├──────────────────────────────────────────────────────┤
│ API Key: ms-7c5f3d2e9a1b4c8d0e7f6a5b4c3d2e1f │
│ 创建时间: 2024-08-25 14:30:22 │
│ 状态: 有效 │
│ 每日调用次数: 1543/2000 │
├──────────────────────────────────────────────────────┤
│ [复制] [新建] [删除] [刷新] │
└──────────────────────────────────────────────────────┘
│ 魔塔 API Key 管理页面 │
├──────────────────────────────────────────────────────┤
│ API Key: ms-7c5f3d2e9a1b4c8d0e7f6a5b4c3d2e1f │
│ 创建时间: 2024-08-25 14:30:22 │
│ 状态: 有效 │
│ 每日调用次数: 1543/2000 │
├──────────────────────────────────────────────────────┤
│ [复制] [新建] [删除] [刷新] │
└──────────────────────────────────────────────────────┘
📌 重要提示：魔搭的API必须先绑定阿里云账号，否则无法使用免费服务。
六、配置Qwen-Code
安装完成后，需要进行简单配置：
1. 设置环境变量
在Ubuntu终端中执行：
echo "export MODELSCOPE_API_TOKEN=ms-7c5f3d2e9a1b4c8d0e7f6a5b4c3d2e1f" >> ~/.bashrc
source ~/.bashrcuser@DESKTOP-XXXXXX:~$ echo "export MODELSCOPE_API_TOKEN=ms-7c5f3d2e9a1b4c8d0e7f6a5b4c3d2e1f" >> ~/.bashrc
user@DESKTOP-XXXXXX:~$ source ~/.bashrc
API token已成功配置，每天可免费使用2000次！
user@DESKTOP-XXXXXX:~$ source ~/.bashrc
API token已成功配置，每天可免费使用2000次！
也可以创建.env文件进行配置：
echo "MODELSCOPE_API_TOKEN=ms-7c5f3d2e9a1b4c8d0e7f6a5b4c3d2e1f" > ~/.qwen-code/.env2. 验证配置
qwen-code --versionuser@DESKTOP-XXXXXX:~$ qwen-code --version
Qwen-Code CLI v1.0.0
检测到有效的ModelScope API Key
✓ 配置成功！每日免费额度: 2000次
Qwen-Code CLI v1.0.0
检测到有效的ModelScope API Key
✓ 配置成功！每日免费额度: 2000次
七、基本使用方法
1. 简单测试
在项目目录中运行：
qwen-codeuser@DESKTOP-XXXXXX:~/my-project$ qwen-code
_______ _ _ _______ ______ _______ ______
|______ | | |______ |_____/ |______ |_____/\
______| |_____| |______ | \_ |______ | \_
_______ _ _ _______ ______ _______ ______
|______ | | |______ |_____/ |______ |_____/\
______| |_____| |______ | \_ |______ | \_
欢迎使用Qwen-Code AI编程助手！
✓ 检测到有效的API Key
✓ 剩余免费额度: 1998/2000
请选择操作:
1. 分析当前目录代码
2. 修复代码问题
3. 生成代码文档
4. 退出
>
2. 常用命令
qwen-code init：初始化项目qwen-code analyze：分析代码qwen-code fix：自动修复代码问题
user@DESKTOP-XXXXXX:~/my-project$ qwen-code analyze
🔍 正在分析代码...
✓ 检测到3个潜在问题
[严重] index.js:15
未处理的Promise拒绝: await db.connect();
建议: 使用try/catch处理异步操作
[警告] utils.js:42
未使用的变量: const tempData = [];
建议: 删除或使用该变量
✓ 分析完成！剩余免费额度: 1997/2000
八、常见问题解决
1. 权限问题
如果安装时遇到权限错误，可以尝试：
sudo npm install -g @qwen-code/qwen-code --unsafe-perm2. Node.js版本问题
确保Node.js版本是20+，如果版本太低：
nvm install 20
nvm use 203. API Key错误
如果遇到魔塔API Key错误：
qwen-code config set token ms-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx✗ 错误: 无效的API Key
提示: 请确保已绑定阿里云账号并在魔塔社区获取有效API Key
请访问 https://modelscope.cn/usercenter 重新获取API Key
提示: 请确保已绑定阿里云账号并在魔塔社区获取有效API Key
请访问 https://modelscope.cn/usercenter 重新获取API Key
删除key开头的"ms-"
九、小贴士
- Qwen-Code是阿里云推出的AI编程工具，通过魔塔平台可以免费使用，每天2000次额度足够日常开发使用
- 如果你是编程新手，可以从简单的项目开始尝试，逐步熟悉Qwen-Code的功能
- 魔塔社区还提供其他AI模型，可以探索更多功能
- 每天0点重置免费额度，记得合理规划使用
┌──────────────────────────────────────────────────────┐
│ Qwen-Code 使用小贴士 │
├──────────────────────────────────────────────────────┤
│ ✓ 每日免费额度: 2000次 │
│ ✓ 额度重置时间: 每天00:00 │
│ ✓ 支持Node.js 20+ │
│ ✓ 魔塔社区: https://modelscope.cn │
└──────────────────────────────────────────────────────┘
│ Qwen-Code 使用小贴士 │
├──────────────────────────────────────────────────────┤
│ ✓ 每日免费额度: 2000次 │
│ ✓ 额度重置时间: 每天00:00 │
│ ✓ 支持Node.js 20+ │
│ ✓ 魔塔社区: https://modelscope.cn │
└──────────────────────────────────────────────────────┘
结语
通过魔塔平台，可以每天免费使用2000次Qwen-Code，这对于学习和日常开发已经足够。