0. 先厘清 3 个事实#

1. 官方 CLI 包名：@qwen-code/qwen-code。
2. 免费调用途径：摩搭社区（ModelScope）每天提供 2000 次免费额度。
3. 付费途径：阿里云百炼（DashScope）按量收费，无免费额度。

下文全部围绕 “摩搭社区免费版” 展开。

1. 安装 Node.js ≥ 20#

1
# macOS / Linux 推荐 nvm
2
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
3
source ~/.bashrc
4
nvm install 20 && nvm use 20        # 验证：node -v 显示 v20.x.x

2. 安装 CLI（二选一）#

场景 命令 零安装（用完即走） npx @qwen-code/qwen-code 全局安装（推荐长期用） npm i -g @qwen-code/qwen-code

安装后执行 qwen --version 能看到版本号即可。

3. 获取摩搭社区 API 令牌（免费）#

1. 打开 https://www.modelscope.cn 并登录。
2. 右上角头像 → 「访问令牌」 → 「创建令牌」，复制以 ms- 开头的字符串。
3. 回到模型页 Qwen3-Coder-480B-A35B-Instruct 点击 「在线体验」 确认有剩余额度即可。

4. 配置环境变量（三选一）#

方式 操作 临时 终端里直接 export，关闭窗口后失效 长期 把下面三行追加到 ~/.zshrc 或 ~/.bashrc，然后 source ~/.zshrc 项目级 在项目根目录新建 .env 文件，CLI 会自动读取

1
# 摩搭社区免费接口
2
export OPENAI_BASE_URL="https://api-inference.modelscope.cn/v1"
3
export OPENAI_API_KEY="ms-你的令牌"
4
export OPENAI_MODEL="Qwen/Qwen3-Coder-480B-A35B-Instruct"

5. 命令行实战#

1
# 1. 让 AI 写个 Python 快排
2
qwen "写一个原地快速排序的 Python 函数，带中文注释"
3

4
# 2. 解释当前目录所有 .py 文件
5
qwen explain .
6

7
# 3. 进入交互模式
8
qwen chat

第一次调用会下载 <1 MB 的 tiny client，随后就能看到回复。