快速上手：安装、认证与第一个任务
安装 Qwen Code（安装脚本、npm、Homebrew）、用 /auth 连接模型服务、完成第一个会话、Git 与 bug 修复工作流、常用命令和新手技巧。
开始之前
确保你有：一个打开的终端或命令提示符；一个代码项目；以及阿里云百炼（ModelStudio）的 API key 或 Token Plan 订阅（也可以用第三方提供商或自定义服务，见「认证与模型服务」）。
第 1 步：安装 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
irm https://qwen-code-assets.oss-cn-hangzhou.aliyuncs.com/installation/install-qwen-standalone.ps1 | iex安装后如果 qwen 没有立即出现在 PATH 上，建议重启终端。离线安装：下载发布归档并用 --archive PATH 运行安装器，把 SHA256SUMS 放在归档旁边。
手动安装：先安装 Node.js 22 或更高版本，然后 npm install -g @qwen-code/qwen-code@latest；macOS 和 Linux 也可以用 Homebrew：brew install qwen-code。
第 2 步：设置认证
用 qwen 命令启动交互会话时，会提示你配置认证：
qwen # 首次使用会提示设置认证
/auth # 随时在会话里更改认证方式首次运行的菜单让你连接模型提供商，选项有：Alibaba ModelStudio（推荐的设置，进入子菜单：Coding Plan、Token Plan 或 Standard API Key）；Third-party Providers（选内置提供商，如 DeepSeek、Grok、MiniMax、Z.AI、Kimi、Idealab、ModelScope、OpenRouter、Requesty 等，用 API key 连接）；Custom Provider（手动连接本地服务器、代理或不受支持的提供商）。注意：Qwen OAuth 已于 2026 年 4 月 15 日停用，如果你之前用它，请切换到上述方式之一。Qwen Code 把配置和定制存放在 .qwen 目录里：~/.qwen/ 放用户级设置（如 settings.json）和全局自定义命令，<project>/.qwen/ 放项目特定文件，如自定义命令和摘要。用 /doctor 随时检查当前配置。
第 3 步：开始你的第一个会话
在任何项目目录里打开终端并启动 Qwen Code：
cd /path/to/your/project
qwen你会看到 Qwen Code 的欢迎画面，带有你的会话信息、最近的对话和最新动态；输入 /help 查看可用命令。
与 Qwen Code 对话
问第一个问题：先从了解代码库开始，例如 what does this project do?、explain the folder structure，也可以问它自己的能力：what can Qwen Code do?。Qwen Code 按需读取你的文件，你不必手动添加上下文，它还能访问自己的文档，回答关于它功能的问题。
做第一个代码改动：试一个简单的任务，如 add a hello world function to the main file。Qwen Code 会找到合适的文件、展示建议的改动、请求你的批准，然后编辑。它在修改文件之前总是请求许可；你可以逐个批准改动，或为本会话启用「Accept all」模式。
配合 Git 使用：让 Git 操作变成对话：what files have I changed?、commit my changes with a descriptive message、create a new branch called feature/quickstart、show me the last 5 commits、help me resolve merge conflicts。
修 bug 或加功能：用自然语言描述：add input validation to the user registration form，或修复现有问题：there's a bug where users can submit empty forms - fix it。Qwen Code 会定位相关代码、理解上下文、实现解决方案并在有测试时运行测试。
其他常见工作流：重构（refactor the authentication module to use async/await instead of callbacks）、写测试（write unit tests for the calculator functions）、更新文档（update the README with installation instructions）、代码评审（review my changes and suggest improvements）。Qwen Code 是你的 AI 结对程序员：像对一位乐于助人的同事那样对它说话，描述你想达成什么，它会帮你做到。
必备命令
| 命令 | 作用 | 示例 |
|---|---|---|
qwen | 启动 Qwen Code | qwen |
/auth | 更改认证方式（会话内） | /auth |
/doctor | 检查当前认证和环境 | /doctor |
/help | 显示可用命令的帮助 | /help 或 /? |
/compress | 用摘要替换聊天历史以节省 token | /compress |
/clear | 清除对话历史并释放上下文 | /clear（别名 reset、new） |
/theme | 更改视觉主题 | /theme |
/language | 查看或更改语言设置 | /language；/language ui zh-CN 设置界面语言，/language output Chinese 设置模型输出语言 |
/quit | 立即退出 | /quit 或 /exit |
完整命令列表见「命令」页。
给新手的技巧
- 请求要具体：不要说「fix the bug」，试试「fix the login bug where users see a blank screen after entering wrong credentials」。
- 用分步指令：把复杂任务拆成步骤：1. 为用户资料创建新的数据库表；2. 创建获取和更新用户资料的 API 端点；3. 构建让用户查看和编辑信息的网页。
- 让 Qwen Code 先探索：改动之前先让它理解你的代码，如「analyze the database schema」。
- 用快捷键省时间：按
?查看所有可用的键盘快捷键；用 Tab 补全命令；按 ↑ 调出命令历史；输入/查看所有斜杠命令。
获取帮助：在 Qwen Code 里输入 /help 或问「how do I...」；社区在 GitHub Discussions；遇到问题见「排障」。