🚀 快速开始
⚠️ 安装前准备
在安装 Qwen CLI 之前，请确保您的系统已满足以下要求：
- 已安装 Python 3.8 或更高版本
- 拥有阿里云通义千问 API 密钥
- 具备基本的命令行操作能力
✅ 一键安装命令
如果您已满足上述要求，可以直接使用以下命令安装：
pip install qwen-cli
📋 详细安装步骤
1
安装 Python
Windows 系统需要先安装 Python 环境：
# 访问 https://python.org 下载最新版本
# 或使用 Chocolatey 安装
choco install python
安装完成后，打开命令提示符验证安装：
python --version
pip --version
重要提示
安装时请勾选 "Add Python to PATH" 选项，否则需要手动配置环境变量。
2
安装 Qwen CLI
使用 pip 安装 Qwen CLI：
pip install qwen-cli
如果遇到权限问题，使用：
pip install --user qwen-cli
3
配置 API 密钥
设置您的阿里云通义千问 API 密钥：
# 设置环境变量
set QWEN_API_KEY=your_api_key_here
# 或使用配置文件
qwen config --api-key your_api_key_here
1
安装 Python
macOS 用户可以使用 Homebrew 安装 Python：
# 使用 Homebrew 安装
brew install python3
# 或从官网下载 https://python.org
验证安装：
python3 --version
pip3 --version
2
安装 Qwen CLI
pip3 install qwen-cli
如果遇到权限问题，使用：
pip3 install --user qwen-cli
3
配置 API 密钥
# 添加到 shell 配置文件
echo 'export QWEN_API_KEY=your_api_key_here' >> ~/.zshrc
source ~/.zshrc
# 或使用配置命令
qwen config --api-key your_api_key_here
1
安装 Python
使用包管理器安装 Python：
# Ubuntu/Debian
sudo apt update
sudo apt install python3 python3-pip
# CentOS/RHEL
sudo yum install python3 python3-pip
# Arch Linux
sudo pacman -S python python-pip
2
安装 Qwen CLI
pip3 install qwen-cli
如果遇到权限问题，使用：
pip3 install --user qwen-cli
3
配置 API 密钥
# 添加到 bash 配置
echo 'export QWEN_API_KEY=your_api_key_here' >> ~/.bashrc
source ~/.bashrc
# 或使用配置命令
qwen config --api-key your_api_key_here
✅ 验证安装
测试 Qwen CLI
运行以下命令验证安装是否成功：
# 查看版本信息
qwen --version
# 测试对话
qwen "你好，请介绍一下你自己"
成功标志
如果您看到通义千问的回复，说明安装配置成功！
❓ 常见问题解答
如何获取阿里云通义千问 API 密钥？
+
安装时出现 pip 不是内部或外部命令？
+
这通常是因为 Python 没有正确添加到系统环境变量：
- 重新安装 Python，确保勾选 "Add Python to PATH"
- 手动添加 Python 安装目录到系统 PATH
- 使用 python -m pip 命令替代 pip
Qwen CLI 有哪些常用命令？
+
# 基本对话
qwen "你的问题"
# 从文件读取输入
qwen -f input.txt
# 保存输出到文件
qwen "你的问题" -o output.txt
# 使用特定模型
qwen --model qwen-turbo "你的问题"
如何更新 Qwen CLI？
+
# 检查更新
pip list --outdated
# 执行更新
pip install --upgrade qwen-cli
API 调用失败怎么办？
+
请检查以下几点：
- API 密钥是否正确设置
- 网络连接是否正常
- 阿里云账户是否有足够余额
- API 调用频率是否超限