qwen-code

环境要求

• Linux / macOS / Windows 终端环境
• 选择 NPM 安装方式时需要 Node.js 22+
• 一个可用的模型 API Key（Qwen / OpenAI / Anthropic / Gemini 等）
• 可访问外网以下载安装脚本或 npm 包

安装与启动步骤

1. 1安装（Linux/macOS）

   执行官方安装脚本，自动下载并安装独立的 qwen 命令行工具，无需预装 Node.js。

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

   复制

2. 2安装（Windows）

   在 PowerShell 中执行官方安装脚本，同样为独立安装包，不依赖 Node.js。

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

   复制

3. 3备选安装方式

   不想用脚本时可用 NPM（需 Node.js 22+）或 Homebrew（macOS/Linux）安装。

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

   复制

4. 4重启终端

   安装完成后必须重启终端，让环境变量生效，否则可能找不到 qwen 命令。

5. 5进入项目目录

   切换到你要让 AI 协助的代码仓库根目录，Qwen Code 会以此为工作目录。

   cd /path/to/your-project

   复制

6. 6启动 Qwen Code

   在项目目录执行 qwen，进入交互式终端会话界面。

   qwen

   复制

7. 7配置认证

   在会话内运行 /auth，按提示选择模型提供方并填入 API Key，之后即可对话。

   /auth

   复制

关键配置

如何确认成功

终端成功进入 Qwen Code 交互式会话，用 /auth 配置好密钥后提问能正常返回结果即表示可用。

常见问题

注意事项

• 安装完成后务必重启终端，否则环境变量可能不生效。
• 除终端外还支持桌面应用、Web UI、编辑器插件和聊天工具集成。
• 支持 OpenAI、Anthropic、Gemini、Qwen 等多种协议，也可接 Ollama / vLLM 本地模型。
• 无界面自动化场景可用 qwen -p "..." 在脚本或 CI/CD 中调用。