安装与离线准备

选择独立安装包、npm 或 Homebrew，核对 Node.js 要求与离线文件。

This page has not been translated into English yet. The original Chinese version is shown below.

Qwen Code 推荐安装器会优先使用当前平台可用的独立归档。如果回退到 npm，PATH 中需要 Node.js 22 或更高版本及 npm。

推荐安装器

Linux / macOS：

curl -fsSL https://qwen-code-assets.oss-cn-hangzhou.aliyuncs.com/installation/install-qwen-standalone.sh | bash

Windows PowerShell：

irm https://qwen-code-assets.oss-cn-hangzhou.aliyuncs.com/installation/install-qwen-standalone.ps1 | iex

这些命令会下载并执行官方安装脚本。完成后重新打开终端，确保新的 PATH 生效；qwen 暂时找不到时先检查终端是否仍使用旧环境。

方式	命令与前提
npm	`npm install -g @qwen-code/qwen-code@latest`，需要 Node.js 22+
Homebrew	`brew install qwen-code`，官方列出 macOS / Linux

独立归档可用时不应一概要求用户先装 Node.js；npm 安装和安装器回退到 npm 时才需要满足该运行环境前提。

官方 Overview 指出，可以先下载 release archive，再给安装器传 --archive PATH，并将 SHA256SUMS 放在归档旁边。归档需与平台匹配；该页没有在此列出每个平台的完整离线命令，其他参数以对应安装器官方说明为准。

离线安装只解决程序文件获取，不会自动提供模型服务、依赖缓存或远程认证。模型接入另见认证。

进入代码项目并运行：

cd /path/to/your-project
qwen

首次启动会提示连接模型，之后可用会话内 /doctor 检查当前认证和环境。完成首个任务见快速上手，各客户端入口见选择使用界面。