落英

Windows 从零安装 Qwen Code（通义千问编程助手）完整教程

Qwen Code 是阿里巴巴通义千问团队出品的开源终端 AI 编程助手，专为 Qwen 系列模型优化。支持 OpenAI / Anthropic / Gemini 兼容 API，可以帮你理解代码、重构、写测试、自动化任务。

本文面向 Windows 用户，从零开始完整安装 Qwen Code，并配置阿里云 API Key 或 Coding Plan。

整体流程

安装 Node.js ──→ 安装 Qwen Code ──→ 获取 API Key ──→ 配置认证 ──→ 启动使用

第一步：安装 Node.js

Qwen Code 通过 npm 安装，需要 Node.js 22 或更高版本。

下载 Node.js

下载地址：https://nodejs.org/

选择 LTS（长期支持）版本，下载 Windows 安装包（.msi 文件）。

安装 Node.js

双击 .msi 安装包，关键步骤：

步骤说明
安装路径默认 C:\Program Files\nodejs\ 即可
自定义设置保持默认全选
勾选✅"Automatically install the necessary tools"

验证安装

打开 CMD 或 PowerShell，输入：

node --version
npm --version

输出示例：

v22.14.0
11.2.0

（可选）配置 npm 镜像

如果下载速度慢，可以临时指定镜像源。Qwen Code 支持两种方式安装，配置镜像对后续都有帮助：

npm config set registry https://registry.npmmirror.com

验证：

npm config get registry

输出应为：https://registry.npmmirror.com

第二步：安装 Qwen Code

提供两种方式，任选其一。

方式一：一键安装脚本（推荐）

以管理员身份运行 CMD 或 PowerShell，执行以下命令：

powershell -Command "Invoke-WebRequest 'https://qwen-code-assets.oss-cn-hangzhou.aliyuncs.com/installation/install-qwen.bat' -OutFile (Join-Path $env:TEMP 'install-qwen.bat'); & (Join-Path $env:TEMP 'install-qwen.bat')"

脚本会自动安装 Node.js（如未安装）和 Qwen Code，并配置环境变量。

建议安装完成后重启终端，确保环境变量生效。

方式二：npm 手动安装

如果已安装 Node.js，直接用 npm 全局安装：

npm install -g @qwen-code/qwen-code@latest

如果网络慢，使用国内镜像：

npm install -g @qwen-code/qwen-code@latest --registry=https://registry.npmmirror.com

验证安装

qwen --version

如果正常输出版本号，说明安装成功。

💡 提示：如果 qwen 命令找不到，检查 npm 全局目录是否在 PATH 中：

npm config get prefix

默认路径是 C:\Users\<用户名>\AppData\Roaming\npm，将其添加到系统 PATH 即可。

第三步：获取 API Key

Qwen Code 支持多种认证方式。推荐以下两种：

方式 A：API Key（推荐）

访问阿里云百炼平台获取 API Key：

国内站：https://bailian.console.aliyun.com/ 国际站：https://modelstudio.console.alibabacloud.com/

  1. 登录后进入模型广场，找到 Qwen3.6-Plus 或 Qwen3-Coder 模型
  2. 点击 "API Key" 或 "查看 API Key"
  3. 创建并复制 API Key（格式：sk-xxxxxxxxxxxx）

方式 B：Coding Plan（包月套餐）

如果日常使用量大，推荐订阅 Coding Plan：

国内站：https://bailian.console.aliyun.com/#/efm/coding-plan-index 国际站：https://modelstudio.console.alibabacloud.com/?tab=coding-plan#/efm/coding-plan-index

  • 固定月费，包含较高调用额度
  • 支持 Qwen3.6-Plus / Qwen3.5-Plus / GLM-4.7 / Kimi-K2.5 等多种模型
  • 性价比高于按量计费

⚠️ 注意：Qwen OAuth 免费额度已于 2026 年 4 月 15 日 停用。请使用 API Key 或 Coding Plan 替代。

第四步：配置认证

交互式配置（推荐）

首次启动 Qwen Code 时，会自动引导你配置认证：

qwen

按提示选择认证方式：

  1. 选择 API Key 或 Alibaba Cloud Coding Plan
  2. 输入你的 API Key
  3. 系统自动生成 ~/.qwen/settings.json 配置文件

也可以随时在会话中运行 /auth 重新配置。

手动配置 settings.json

编辑 ~/.qwen/settings.json（不存在则创建），示例如下：

API Key 方式：

{
  "modelProviders": {
    "openai": [
      {
        "id": "qwen3.6-plus",
        "name": "qwen3.6-plus",
        "baseUrl": "https://dashscope.aliyuncs.com/compatible-mode/v1",
        "description": "Qwen3-Coder via Dashscope",
        "envKey": "DASHSCOPE_API_KEY"
      }
    ]
  },
  "env": {
    "DASHSCOPE_API_KEY": "sk-你的APIKey"
  },
  "security": {
    "auth": {
      "selectedType": "openai"
    }
  },
  "model": {
    "name": "qwen3.6-plus"
  }
}

Coding Plan 方式：

{
  "modelProviders": {
    "openai": [
      {
        "id": "qwen3.6-plus",
        "name": "qwen3.6-plus (Coding Plan)",
        "baseUrl": "https://coding.dashscope.aliyuncs.com/v1",
        "description": "qwen3.6-plus from ModelStudio Coding Plan",
        "envKey": "BAILIAN_CODING_PLAN_API_KEY"
      }
    ]
  },
  "env": {
    "BAILIAN_CODING_PLAN_API_KEY": "sk-你的CodingPlanKey"
  },
  "security": {
    "auth": {
      "selectedType": "openai"
    }
  },
  "model": {
    "name": "qwen3.6-plus"
  }
}

环境变量方式

也可以使用环境变量配置，优先级高于 settings.json：

set DASHSCOPE_API_KEY=sk-你的APIKey
set QWEN_MODEL=qwen3.6-plus

PowerShell：

$env:DASHSCOPE_API_KEY = "sk-你的APIKey"
$env:QWEN_MODEL = "qwen3.6-plus"

第五步：启动 Qwen Code

一切就绪，进入你的项目目录启动 Qwen Code：

cd C:\Users\你的用户名\Projects\my-project
qwen

首次启动会显示欢迎界面，包含会话信息、最近对话等。

基础使用示例

# 探索项目结构
explain the folder structure

# 写代码
add input validation to the user registration form

# 重构
refactor the auth module to use async/await

# Git 操作
commit my changes with a descriptive message

常用命令

命令说明
qwen启动交互式会话
/auth切换认证方式
/doctor检查配置状态
/help查看帮助
/model切换模型
/clear清除屏幕
/quit退出

完整命令速查

从零到启动的完整命令序列：

:: 1. 安装 Node.js（需手动下载安装）
::    https://nodejs.org/

:: 2. 安装 Qwen Code（任选其一）
npm install -g @qwen-code/qwen-code@latest --registry=https://registry.npmmirror.com

:: 3. 启动并配置认证
qwen
:: 然后按提示输入 API Key

:: 4. 也可以用 /auth 重新配置

常见问题

Q1: qwen 命令找不到

npm list -g --depth=0

检查 @qwen-code/qwen-code 是否在列表中。如果不在，重新安装。

如果在但命令找不到，将 npm 全局目录添加到系统 PATH：

  1. 运行 npm config get prefix 获取路径
  2. 系统环境变量 → Path → 新增该路径

Q2: npm install 报网络错误

网络不稳定时使用国内镜像：

npm install -g @qwen-code/qwen-code@latest --registry=https://registry.npmmirror.com

Q3: 提示 "Qwen OAuth 已停用"

Qwen OAuth 免费额度已于 2026 年 4 月 15 日 停用。请使用 API Key 或 Coding Plan：

qwen
/auth

选择 API Key 或 Alibaba Cloud Coding Plan 进行配置。

Q4: 启动后显示 "No API Key configured"

运行 /doctor 检查配置状态：

/doctor

根据提示补充 API Key 或配置文件。

Q5: 如何切换模型？

在 Qwen Code 会话中运行：

/model

会列出所有已配置的模型，选择即可切换。也可以在 settings.json 中添加多个模型：

{
  "modelProviders": {
    "openai": [
      {
        "id": "qwen3.6-plus",
        "name": "Qwen3.6-Plus (Dashscope)",
        "baseUrl": "https://dashscope.aliyuncs.com/compatible-mode/v1",
        "envKey": "DASHSCOPE_API_KEY"
      },
      {
        "id": "qwen3.5-plus",
        "name": "Qwen3.5-Plus (Dashscope)",
        "baseUrl": "https://dashscope.aliyuncs.com/compatible-mode/v1",
        "envKey": "DASHSCOPE_API_KEY"
      }
    ]
  }
}

Q6: Windows 下编码显示乱码？

在 CMD 中执行以下命令切换到 UTF-8：

chcp 65001

PowerShell 一般无此问题。

更多玩法

Qwen Code 还有更多使用方式：

  • Headless 模式：qwen -p "你的问题"，适合脚本和 CI/CD
  • VS Code 集成：安装 VS Code 扩展，在编辑器中直接使用
  • JetBrains 集成：支持 IntelliJ IDEA、PyCharm 等
  • Daemon 模式：qwen serve，以 HTTP 服务形式运行，多客户端共享一个会话
  • 本地模型：支持接入 Ollama / vLLM 本地部署的模型

接入 DeepSeek 模型

Qwen Code 支持 OpenAI 兼容协议的任意 API，因此可以轻松接入 DeepSeek 系列模型作为备选。

方式一：DeepSeek 官方 API（直连）

在 settings.json 中添加 DeepSeek 的模型配置：

{
  "modelProviders": {
    "openai": [
      {
        "id": "qwen3.6-plus",
        "name": "Qwen3.6-Plus (Dashscope)",
        "baseUrl": "https://dashscope.aliyuncs.com/compatible-mode/v1",
        "envKey": "DASHSCOPE_API_KEY"
      },
      {
        "id": "deepseek-chat",
        "name": "DeepSeek V4 (官方)",
        "baseUrl": "https://api.deepseek.com/v1",
        "description": "DeepSeek V4 直连",
        "envKey": "DEEPSEEK_API_KEY"
      }
    ]
  },
  "env": {
    "DASHSCOPE_API_KEY": "sk-你的阿里云Key",
    "DEEPSEEK_API_KEY": "sk-你的DeepSeekKey"
  },
  "security": {
    "auth": {
      "selectedType": "openai"
    }
  },
  "model": {
    "name": "qwen3.6-plus"
  }
}

方式二：通过 OpenRouter 代理

OpenRouter 提供 DeepSeek V4 的代理访问，无需直接对接 DeepSeek 官方 API：

{
  "modelProviders": {
    "openai": [
      {
        "id": "qwen3.6-plus",
        "name": "Qwen3.6-Plus (Dashscope)",
        "baseUrl": "https://dashscope.aliyuncs.com/compatible-mode/v1",
        "envKey": "DASHSCOPE_API_KEY"
      },
      {
        "id": "deepseek/deepseek-v4",
        "name": "DeepSeek V4 (OpenRouter)",
        "baseUrl": "https://openrouter.ai/api/v1",
        "description": "通过 OpenRouter 接入",
        "envKey": "OPENROUTER_API_KEY"
      }
    ]
  },
  "env": {
    "DASHSCOPE_API_KEY": "sk-你的阿里云Key",
    "OPENROUTER_API_KEY": "sk-or-v1-你的OpenRouterKey"
  },
  "security": {
    "auth": {
      "selectedType": "openai"
    }
  },
  "model": {
    "name": "qwen3.6-plus"
  }
}

在 Qwen Code 中切换模型

配置好多个模型后，在 Qwen Code 会话中运行 /model 即可动态切换：

/model

选择列表中的 DeepSeek V4，立即生效，无需重启。

用环境变量临时切换

如果不修改配置文件，也可以用环境变量临时使用 DeepSeek：

CMD：

set DEEPSEEK_API_KEY=sk-你的DeepSeekKey
qwen -m deepseek-chat -b https://api.deepseek.com/v1

PowerShell：

$env:DEEPSEEK_API_KEY = "sk-你的DeepSeekKey"
qwen -m deepseek-chat -b https://api.deepseek.com/v1

💡 提示：DeepSeek V4 在代码生成、数学推理方面表现优秀，且 API 价格远低于 Claude 旗舰模型。按任务需求灵活切换 Qwen 和 DeepSeek，可以获得最佳性价比。

对比：Qwen Code vs Claude Code

特性Qwen CodeClaude Code
开源✅ 完全开源❌ 闭源
默认模型Qwen3-Coder 系列Claude 系列
接入方式OpenAI / Anthropic / Gemini 兼容Anthropic 协议
安装方式npm / 一键脚本npm / Homebrew
包月套餐Coding Plan（国内友好）Claude Pro / Max
微信渠道✅ 支持✅ 支持
本地模型✅ Ollama / vLLM✅ Ollama
认证方式API Key / Coding PlanAPI Key / OAuth

两者的操作体验非常相似——如果你用过 Claude Code，切换到 Qwen Code 几乎零学习成本。

相关阅读：