哈喽各位小伙伴，我是小熊！今天带来阿里通义千问旗下 Qwen Code（俗称 qwencode） 的 Node.js 安装全教程 —— 作为阿里官方推出的 AI 编程助手 CLI 工具，基于 Qwen3-Coder 大模型，能直接在终端帮你读代码、写逻辑、做重构，Node.js 环境一键安装

最关键的是，完全免费！无需邀请码！

Qwen Code 里，通过 Qwen OAuth 登录，免费用户每天可以调用 Qwen3.6 Plus，上限 1000 次，没有 token 限制。

一、环境准备：Node.js 必装

Qwen Code 对 Node.js 版本有硬性要求：推荐 v20.0.0

1.1 检查当前 Node.js 版本

打开终端（Windows 用 CMD/PowerShell，macOS/Linux 用 Terminal），执行：

node -v
npm -v

• 出现 v20.x.x / v21.x.x / v22.x.x → 合格
• 版本 <20 或提示 “不是内部命令” → 必须先装 / 升级 Node.js

1.2 安装 / 升级 Node.js（3 种方式）

方式 1：官网下载（新手推荐）

直接去 Node.js 官网：https://nodejs.org/

• 下载 LTS（长期支持版），一路 “下一步” 安装
• 安装完重启终端，再执行 node -v 验证

方式 2：nvm 管理（多版本切换，本人推荐）

适合需要切换 Node.js 版本的同学：

# 1. 安装 nvm（macOS/Linux）
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash

# Windows 去 github 下载 nvm-windows 安装包

# 2. 安装 Node.js 20 LTS
nvm install 20
nvm use 20
nvm alias default 20  # 设为默认

# 3. 验证
node -v  # 显示 v20.x.x 即可

方式 3：包管理器（macOS/Linux）

# macOS（Homebrew）
brew install node@20

# Ubuntu/Debian
curl -fsSL https://deb.nodesource.com/setup_20.x | sudo bash -
sudo apt-get install -y nodejs

二、正式安装（2种方式）

2.1 官方脚本一键安装（本人推荐）

适合完全新手：

# macOS/Linux
bash -c "$(curl -fsSL https://qwen-code-assets.oss-cn-hangzhou.aliyuncs.com/installation/install-qwen.sh)" -s --source bailian
# Windows（管理员 CMD）
curl -fsSL -o %TEMP%\install-qwen.bat https://qwen-code-assets.oss-cn-hangzhou.aliyuncs.com/installation/install-qwen.bat && %TEMP%\install-qwen.bat --source bailian

安装完成后，关闭当前CMD窗口，以使环境变量生效。重新打开一个新的CMD窗口，并运行以下命令，查看当前安装版本。

qwen --version

2.2 Node.js npm 全局安装 qwencode

Node.js 环境就绪后，一行 npm 命令全局安装 Qwen Code，全平台通用！

安装命令（全平台）

打开管理员 /root 权限终端（Windows 右键 “以管理员身份运行”，macOS/Linux 加 sudo）：

# 全局安装最新版 Qwen Code（qwencode）
npm install -g @qwen-code/qwen-code@latest
​# mac/linux权限不够加sudo
sudo npm install -g @qwen-code/qwen-code@latest

验证安装（关键!）

安装完成后，执行：

qwen --version
# 或简写
qwen -v

出现版本号（如 0.14.3）→ 安装成功！ 

提示 “命令不存在”→ 重启终端再试（环境变量未刷新）

三、首次使用：登录授权

安装完第一次运行 qwen，会自动触发登录授权：

登录步骤

终端输入：

qwen

进入以下界面：

选择“Qwen OAuth （免费）”

• 自动跳转到浏览器 → 用 支付宝 / 淘宝 / 阿里云账号 扫码登录
• 登录成功 → 浏览器提示 “授权成功，返回终端”
• 回到终端 → 出现以下界面 → 搞定！

四、快速上手：3 个常用命令体验

登录成功直接开用，自然语言发指令，超丝滑～

4.1 查看帮助

qwen /help

列出所有命令：/clear（清上下文）、/stats（查额度）、/exit（退出）

4.2 代码解释（项目根目录运行）

# 进入你的项目
cd your-project

# 启动 qwen
qwen

# 输入指令
> explain this code  # 解释当前目录代码结构
> 帮我写一个用户登录接口的 Java 代码
> 给这个函数加详细注释

4.3 代码重构 / 生成单测

> refactor this function to be cleaner
> generate unit tests for src/utils.js

写在最后：

还可以在你的VScode中接入qwencode，会让你的开发效率大大提高哦！

有问题欢迎评论区留言或私信，我会及时解答！