Qwen Code 接入阿里云百炼：从安装到跑通项目，一篇讲清楚-编程实验室

一、Qwen Code 适合谁？

Qwen Code 是一款运行在终端里的 AI 编程工具，可以通过按量计费、Coding Plan 或 Token Plan 团队版接入阿里云百炼。它的核心价值不是“陪你聊天”，而是把 AI 放进项目目录：读代码、找文件、给方案、改文件、运行命令、检查 Git 变更。

最爽的地方在于：你不用把代码一段段复制到网页里，也不用手动解释整个工程。进入项目目录后执行 qwen，它可以按需读取文件，先理解项目，再根据你的确认进行修改。

适合：想在终端里直接让 AI 读项目、改项目、写测试、做代码审查的开发者。

适合：希望使用阿里云百炼模型、Qwen 系列模型、Coding Plan 或 Token Plan 的团队。

不适合：完全不看 diff、不跑测试、只想“一句话自动改完整个线上项目”的用法。AI Coding 再强，也要和 Git、测试、人工审查一起用。

二、准备工作：先把这 3 件事准备好

开始前只需要准备三样东西：一个终端、一个代码项目、一个阿里云百炼的 API Key 或 Coding Plan / Token Plan 订阅。官方 Quickstart 也把这三项列为前置条件。

终端或命令提示符：Windows 用户建议使用“以管理员身份运行”的 cmd 安装。

本地代码项目：可以是前端、后端、脚本项目，也可以是一个刚创建的新目录。

百炼凭证：按你的计费方式选择普通 API Key、Coding Plan 专属 API Key 或 Token Plan 团队版专属 API Key。

三、快速安装：Windows、macOS、Linux 一次说清

1. macOS / Linux 一键安装

打开终端，执行官方安装命令：

bash -c "$(curl -fsSL https://qwen-code-assets.oss-cn-hangzhou.aliyuncs.com/installation/install-qwen.sh)" -s --source bailian

2. Windows 一键安装

在任务栏搜索 cmd，选择“以管理员身份运行”，然后执行：

curl -fsSL -o %TEMP%\install-qwen.bat https://qwen-code-assets.oss-cn-hangzhou.aliyuncs.com/installation/install-qwen.bat && %TEMP%\install-qwen.bat --source bailian

Windows 安装完成后，关闭当前 cmd 窗口，重新打开一个新的 cmd，再验证版本：

qwen --version

3. 手动安装兜底方案

如果一键脚本失败，可以走手动安装。官方 Quickstart 提到，手动安装前需要 Node.js 20 或更高版本，然后通过 NPM 或 Homebrew 安装。

npm install -g @qwen-code/qwen-code@latest
# 或 macOS / Linux
brew install qwen-code

四、配置接入凭证：/auth 是最省心的方式

安装完成后，在终端输入 qwen 启动 Qwen Code。首次使用会引导你配置认证；也可以在会话里输入 /auth 重新选择认证方式。百炼官方文档给出三种计费方案：Token Plan 团队版、Coding Plan、按量计费。

三种认证方案对比

方案	计费理解	典型模型/入口	适合场景
Token Plan 团队版	按坐席订阅，按 token 消耗抵扣 Credits	示例：qwen3.7-max；token-plan.cn-beijing.maas.aliyuncs.com	团队统一管理、追求强模型、需要工具调用能力
Coding Plan	固定月费订阅，按模型调用次数计量	示例：qwen3.6-plus；coding.dashscope.aliyuncs.com/v1	个人或小团队稳定写代码
按量计费	按实际调用量后付费	北京：dashscope.aliyuncs.com/compatible-mode/v1	先体验、低频使用、临时测试

五、settings.json：看懂这份配置就不怕接错

Qwen Code 的配置文件路径很固定：macOS/Linux 是 ~/.qwen/settings.json，Windows 是 C:\Users\<Windows 用户名>\.qwen\settings.json。它主要解决三件事：API Key 放哪里、请求哪个 baseUrl、默认使用哪个模型。

按量计费示例

{ "env": { "BAILIAN_API_KEY": "YOUR_API_KEY" }, "modelProviders": { "openai": [ { "id": "qwen3.6-plus", "name": "[Bailian] qwen3.6-plus", "baseUrl": "https://dashscope.aliyuncs.com/compatible-mode/v1", "envKey": "BAILIAN_API_KEY", "generationConfig": { "extra_body": { "enable_thinking": true } } } ] }, "security": { "auth": { "selectedType": "openai" } }, "model": { "name": "qwen3.6-plus" }, "$version": 3 }

重点提醒：API Key 不要提交到 Git 仓库。团队环境可以用系统环境变量或独立配置文件管理，避免把密钥写进项目代码。

六、第一次跑通项目：按这个顺序最稳

配置完成后，在项目目录下执行 qwen 即可进入会话。官方文档也建议在项目目录中启动 Qwen Code，让它围绕当前代码工作。

第一句话不要让它直接改代码

建议先让它读项目，而不是一上来就“帮我重构”。你可以这样问：

请先分析这个项目的目录结构、启动方式、主要技术栈和核心模块，不要修改任何文件。

千问出的就是阿里味十足

第二步让它建立项目上下文

可以执行：

/init

这个命令会分析当前目录并创建项目级上下文文件 QWEN.md，用来沉淀项目指令和上下文。

第三步才让它做小修改

请修复登录页输入为空也能提交的问题。
要求：
1. 先列出你准备修改的文件和原因；
2. 等我确认后再修改；
3. 修改后运行现有测试或构建命令；
4. 最后总结 diff 和风险点。

官方 Quickstart 里也强调，Qwen Code 在修改文件前会展示拟议改动并请求确认。实战中保持这个流程，能显著降低乱改文件的概率。

七、日常开发怎么用：把它当结对程序员

Qwen Code 可以回答项目结构问题，也可以完成代码修改。官方 Quickstart 给出的典型任务包括解释目录结构、添加函数、处理 Git、修复 bug、加功能、重构代码、写单测、更新 README、做代码审查。

常用提示词模板

请先阅读当前项目，不要修改文件。
目标：实现/修复/重构 XXX。
范围：只允许修改 A、B、C 三个文件。
约束：保持现有接口兼容，不引入新依赖。
验收：运行 npm test / npm run build，通过后总结改动。

适合直接交给 Qwen Code 的任务

解释陌生项目：这个项目做什么？入口文件在哪里？启动命令是什么？

小功能开发：给注册表单增加输入校验、错误提示、单元测试。

Bug 修复：把报错日志粘给它，让它定位文件、提出方案、修复并跑测试。

代码审查：review my changes and suggest improvements。

文档更新：根据当前项目补充 README 的安装和启动说明。

八、常用命令速查

命令	作用	建议用法
qwen	启动 Qwen Code	在项目根目录执行
/auth	更改认证方式	切换 API Key、Coding Plan、Token Plan
/model	切换模型	多个模型共存时使用
/init	创建项目上下文	新项目第一次使用时执行
/compress	压缩聊天历史	上下文太长或对话变慢时用
/summary	生成项目摘要	阶段性收口，方便下次继续
/resume	恢复之前会话	继续上次任务
/stats	查看统计信息	观察当前会话消耗
/help	显示帮助	忘记命令时用
/quit	退出	任务完成后退出

九、VS Code 插件：不想只用终端，也可以进 IDE

Qwen Code 支持在 VS Code 中以插件方式使用。官方文档要求 VS Code 版本为 1.85.0 或更高版本，插件名称为 Qwen Code Companion。CLI 和 IDE 插件共用同一个 settings.json；如果 CLI 已经配置好，插件可以复用配置。

打开 VS Code 扩展市场，搜索 Qwen Code Companion 并安装。

确认 CLI 已经完成 settings.json 配置；否则按上面的认证步骤配置。

点击右上角图标启动 Qwen Code，通过 / 或 Switch model 切换模型。

如果你习惯在 IDE 里看文件和 diff，可以用插件；如果你习惯命令行、脚本和自动化，CLI 会更直接。

十、联网搜索 MCP：让它查实时资料

在 Coding Plan 支持的编程工具中，可以通过 MCP 添加联网搜索能力。官方文档说明，Qwen Code、Claude Code 等工具可通过 MCP 扩展联网搜索；部分工具如 Cursor 已内置联网搜索，不需要额外添加。

给 Qwen Code 添加 WebSearch MCP 的命令如下，把 YOUR_API_KEY 替换为开通 MCP 服务时获取的百炼通用 API Key。注意：这个 API Key 是 sk-xxx 格式的百炼通用 API Key，不是 Coding Plan 专属 API Key。

qwen mcp add WebSearch \
-t http \
"https://dashscope.aliyuncs.com/api/v1/mcps/WebSearch/mcp" \
-H "Authorization: Bearer YOUR_API_KEY"

添加后不要只看终端返回“added”。官方文档明确提醒：返回添加成功不代表 MCP 已连接成功，还需要进入 Qwen Code 后执行 /mcp 检查连接状态。

qwen
/mcp
用 websearch MCP 搜索阿里云百炼 Qwen Code 的最新资料，并总结安装步骤

十一、排错：遇到问题按这张图查

1. qwen 命令无法识别

Windows：安装完成后必须关闭当前 cmd，再重新打开，让环境变量生效。

仍不生效：检查是否安装成功，重新执行安装命令，或使用手动安装方案。

2. 认证失败

确认 API Key 类型：普通百炼 API Key、Coding Plan 专属 API Key、Token Plan 专属 API Key 不要混用。

确认 baseUrl 与区域一致：北京和新加坡入口不同，API Key 需要对应所选地域。

3. 上下文太长或输出变慢

执行 /compress，用摘要替换聊天历史，节省 token。

把大任务拆小：先让它只分析一个模块，再让它改一个功能点。

4. 代码改动不可控

要求它“先列计划，不要直接修改文件”。

保持 Git 工作区干净，所有修改都通过 diff 审查。

限制修改范围：明确“只允许改这几个文件”。

十二、推荐实战流程：每天就按这套跑

进入项目目录前，先确认 Git 工作区干净。

第一次使用项目，先执行 /init，建立项目上下文。

任何复杂任务都先让它输出计划，不要直接改文件。

每次只做一个小目标：一个 bug、一个接口、一个页面、一个测试文件。

改完必须让它运行测试、构建或至少解释为什么无法运行。

最后让它总结：修改了哪些文件、为什么改、测试结果、还剩哪些风险。

十三、总结：Qwen Code 的正确打开方式

Qwen Code 接入阿里云百炼后，真正有价值的不是“模型回答得像不像人”，而是能不能把 AI 放进你的开发现场：读项目、找文件、提计划、改代码、跑测试、总结风险。

新手路线很简单：先按官方命令安装，再用 /auth 接入百炼，进项目目录执行 qwen，先让它分析项目，再让它小步修改。只要坚持“先计划、再确认、后修改、必测试”，Qwen Code 就能从聊天助手变成真正能帮你推进项目的 AI 编程搭子。

Qwen Code 接入阿里云百炼：从安装到跑通项目，一篇讲清楚