Qwen Code CLI 安装与使用完全指南

最新推荐文章于 2025-10-29 21:26:29 发布

原创最新推荐文章于 2025-10-29 21:26:29 发布 · 2.2k 阅读

16 ·

CC 4.0 BY-SA版权

文章标签：

#编辑器

部署运行你感兴趣的模型镜像

Qwen Code CLI是一款由阿里巴巴开发的命令行AI编程工具，基于Gemini CLI改造，专为Qwen3-Coder模型优化。它为开发者提供了一个高效、智能的编码辅助环境，支持通过自然语言驱动代码生成与项目管理。

一、Qwen Code CLI简介

Qwen Code CLI是阿里巴巴推出的开源命令行AI编程工具，具有以下特点：

基于Gemini CLI改造：继承了Gemini CLI的核心功能，并针对Qwen3-Coder模型进行了专门优化 ([17†])
强大的代码理解能力：支持分析和操作大型代码库，理解能力强
丰富的工具支持：提供自然语言驱动的代码操作、文件管理、Web搜索等功能
多模型支持：除Qwen3-Coder外，还支持OpenAI、Anthropic等多家模型 ([14†])
无缝集成：可与GitHub、Web搜索等多种服务集成，增强功能

二、安装前准备

系统要求

在安装Qwen Code CLI之前，需要满足以下系统要求：

Node.js 20或更高版本：
- Qwen Code CLI依赖Node.js环境，必须确保版本符合要求
- 可通过Node.js官网下载安装最新版本
- 安装验证：打开终端，输入以下命令查看Node.js版本
```
node -v
```
npm包管理器：
- 通常随Node.js一起安装
- 验证安装：终端中输入
```
npm -v
```
操作系统：
- 支持Windows、macOS和Linux系统 ([29†])

三、安装Qwen Code CLI

全局安装方法

Qwen Code CLI支持以下安装方式：

方法一：使用npm全局安装（推荐）

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

此命令会将Qwen Code CLI全局安装到您的系统中，便于在任何目录下使用 ([9†], [14†])。

方法二：使用npx临时体验

如果不想全局安装，可以使用npx命令临时体验：

npx @qwen-code/qwen-code

此方法无需安装，可直接运行Qwen Code CLI ([2†])。

方法三：从源码安装

对于喜欢尝鲜的用户，可以从GitHub仓库克隆最新代码安装：

git clone <https://github.com/QwenLM/qwen-code>
cd qwen-code
npm install
npm run build
npm link

此方法可以从源码构建并安装Qwen Code CLI ([14†])。

验证安装

安装完成后，可以通过以下命令验证安装是否成功：

qwen --version

如果显示版本信息，说明安装成功 ([15†])。

四、环境配置

1. 配置API密钥

Qwen Code CLI需要配置相应的API密钥才能连接到大语言模型服务。主要支持以下两种配置方式：

方式一：自动配置

首次运行qwen命令时，Qwen Code会引导您通过浏览器完成授权配置 ([2†], [3†])。

方式二：手动设置环境变量

编辑终端的环境变量配置文件（如.bashrc、.zshrc或.profile）：

# 打开配置文件
nano ~/.zshrc# 或 ~/.bashrc

添加以下环境变量（根据您使用的模型服务进行调整）：

# Qwen服务配置export OPENAI_API_KEY=your_qwen_api_key
export OPENAI_BASE_URL="<https://dashscope-intl.aliyuncs.com/compatible-mode/v1>"
export OPENAI_MODEL="qwen3-coder-plus"

# 或者使用iflow服务export OPENAI_API_KEY=your_iflow_api_key
export OPENAI_BASE_URL="<https://iflow.cn/api>"

添加完成后，使配置生效：

source ~/.zshrc# 或 source ~/.bashrc

环境变量配置完成后，您可以在终端中直接使用qwen命令启动 ([14†], [30†])。

2. 模型选择

Qwen Code CLI支持多种模型，主要包括：

模型类型	模型名称	特点	适用场景
Qwen3-Coder	qwen3-coder	480B参数，中等上下文窗口	一般编程任务
Qwen3-Coder-Plus	qwen3-coder-plus	480B参数，1M上下文窗口	大型项目分析
Qwen2.5-Coder	qwen2.5-coder	335B参数，中等上下文窗口	复杂项目管理
Qwen2.5-Coder-Plus	qwen2.5-coder-plus	335B参数，1M上下文窗口	大型代码库操作

使用时可以通过环境变量OPENAI_MODEL指定模型名称，或在运行时通过命令行参数指定 ([19†], [34†])。

五、基本命令与使用方法

启动命令

安装并配置完成后，进入您的项目目录，运行以下命令启动Qwen Code CLI：

cd /path/to/your/project
qwen

初次运行时，系统可能会提示您选择或配置模型服务 ([2†])。

核心交互命令

Qwen Code CLI支持以下核心命令（可以在运行时输入这些命令）：

命令	描述	使用场景
/chat	切换到聊天模式	需要与AI对话时
/edit [文件路径]	编辑指定文件	修改代码文件时
/help	显示帮助信息	需要了解可用命令时
/version	显示版本信息	确认安装版本时
/config	查看或修改配置	管理API设置时
/exit	退出Qwen Code	完成使用时