主题
Qwen Code 安装与使用
Qwen Code 是阿里开源（Apache 2.0）的终端编程 Agent，对标 Claude Code：你在终端描述任务，它自主读代码、改文件、跑命令。对国内用户的优势是网络可直连、有免费额度、模型国产。终端工作流习惯与《Claude Code 进阶玩法》相通。
1. 安装
需要 Node.js 20 以上（推荐 22）。先验证环境：
bash
node -v
npm -v全局安装 Qwen Code：
bash
npm install -g @qwen-code/qwen-code@latest安装慢或失败时，先按《Claude Code 全平台安装》第 5 节配置 npm 镜像，或使用官方文档提供的一键安装脚本。
2. 验证与首次启动
bash
qwen --version能打印版本号即安装成功。进入你的项目目录后启动：
bash
cd 你的项目目录
qwen首次启动会出现认证方式选择界面（方向键切换）。
3. 登录与免费额度
- Qwen OAuth（推荐）：选择后跳转浏览器登录 qwen.ai 账号（支持支付宝/淘宝账号快捷登录），凭证自动管理。免费额度为每天约 1000～2000 次请求，日常单人使用足够；
- 阿里云百炼 Coding Plan：重度使用时，在
/auth里选择订阅计划，输入专属 API Key； - OpenAI 兼容接口：也可以接入第三方模型平台，按官方文档配置环境变量即可。
登录信息随时可以用 /auth 重新配置。
4. 第一次真实任务
不要先问"你能做什么"。直接给它一件真实工作：
- 进入一个真实项目目录并启动
qwen； - 先让它读，再让它改：
text
先分析这个项目：入口文件、目录结构、主要依赖和运行方式，列出来，先不要改任何代码。- 确认它理解正确后，再交代一个小的真实改动（修一个已知小问题、补一个函数），并写清验收标准；
- 每一步让它跑测试或构建验证，不要口头确认"改好了"。
新项目建议先执行 /init，让它为项目生成说明文件（QWEN.md），后续每次启动都会自动带上这份上下文。
5. 常用命令
| 命令 | 作用 |
|---|---|
/init | 为当前项目生成 QWEN.md 项目说明 |
/auth | 重新配置登录与模型接入方式 |
/doctor | 检查安装与环境问题 |
/clear | 清空当前会话上下文 |
Qwen Code 另提供 VS Code、JetBrains 与 Zed 的集成方式，见官方文档。
6. 常见问题
6.1 qwen: command not found
全局 npm 目录不在 PATH 里。参照《Claude Code 全平台安装》第 7.2 节排查 npm 全局路径。
6.2 免费额度用尽或请求受限
第二天额度会重置；重度使用可在 /auth 切换到阿里云百炼 Coding Plan，或改用 API Key 方式。
6.3 OAuth 登录页面打不开
检查终端代理与系统代理是否一致；国内网络一般可直连，不需要代理。