进阶 docs.bailian.console.aliyun.com 2026-10-16 14:20:25 · 27 阅读
第23章 Qwen Code
Qwen Code 是一款终端 AI 编程工具，可以通过按量计费、Coding Plan、Token Plan 个人版或 Token Plan 团队版接入阿里云百炼。
应用场景
Qwen Code 支持以下使用场景：
AI 编程辅助：在终端通过自然语言完成代码生成、代码补全与代码审查，提升日常开发效率。详见接入百炼 CLI。
Web 开发：提供目标网站截图，Qwen Code 自动解析页面结构并生成高还原度的前端代码。详见一句话复刻网站样式。
视频制作：给定开源项目仓库地址，一键生成专属宣传视频。详见为开源项目制作宣传视频。
百炼平台集成：通过百炼 CLI 在对话中调用百炼的图像生成、视频生成等模型能力，把 Qwen Code 扩展到更多 AI 场景。详见接入百炼 CLI。
安装 Qwen Code
运行安装命令
macOS/Linux：
打开终端，运行以下命令安装 Qwen Code。
Copybash -c "$(curl -fsSL https://qwen-code-assets.oss-cn-hangzhou.aliyuncs.com/installation/install-qwen.sh)" -s --source bailian
Windows：
在任务栏搜索框里输入cmd，选择以管理员身份运行，打开cmd窗口后运行以下命令安装 Qwen Code。
Copycurl -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
关闭并重新打开cmd窗口
Windows 系统在安装完成后，需关闭当前cmd窗口，以使环境变量生效。重新打开cmd后，运行以下命令查看当前安装版本。
Copyqwen --version
配置接入凭证
启动 Qwen Code 后输入 /auth 命令进行可视化配置。阿里云百炼提供四种计费方案，根据需要选择：
Token Plan 个人版：按 token 消耗抵扣个人 Credits。
Token Plan 团队版：按坐席订阅，按 token 消耗抵扣 Credits。
Coding Plan：固定月费订阅，按模型调用次数计量。
按量计费：按实际调用量后付费。
Token Plan 个人版
启动 Qwen Code 后输入 /auth，依次选择 订阅计划 > 阿里云百炼 Token Plan，输入 Token Plan 个人版专属 API Key 即可完成配置。可用模型请参考 Token Plan 个人版支持的模型。
高级配置：通过 settings.json 配置文件编辑或新建 settings.json 文件，将 YOUR_API_KEY 替换为 Token Plan 个人版专属 API Key。文件路径如下：
macOS/Linux：~/.qwen/settings.json
Windows：C:\Users\\.qwen\settings.json
关键字段说明：env 用于定义存放 API Key 的环境变量，模型条目中的 envKey 需与该环境变量名保持一致；generationConfig.extra_body.enable_thinking 用于开启或关闭模型思考模式；部分示例中的 $version 为配置文件格式版本号，请保留默认值。完整字段以 Qwen Code 产品文档为准。Copy{
"env": {
"BAILIAN_TOKEN_PLAN_API_KEY": "YOUR_API_KEY"
},
"modelProviders": {
"openai": [
{
"id": "auto",
"name": "[Token Plan 个人版] auto",
"baseUrl": "https://token-plan.cn-beijing.maas.aliyuncs.com/compatible-mode/v1",
"envKey": "BAILIAN_TOKEN_PLAN_API_KEY"
},
{
"id": "qwen3.8-max",
"name": "[Token Plan 个人版] qwen3.8-max",
"baseUrl": "https://token-plan.cn-beijing.maas.aliyuncs.com/compatible-mode/v1",
"envKey": "BAILIAN_TOKEN_PLAN_API_KEY",
"generationConfig": {
"extra_body": {
"enable_thinking": true
}
}
},
{
"id": "qwen3.8-flash",
"name": "[Token Plan 个人版] qwen3.8-flash",
"baseUrl": "https://token-plan.cn-beijing.maas.aliyuncs.com/compatible-mode/v1",
"envKey": "BAILIAN_TOKEN_PLAN_API_KEY",
"generationConfig": {
"extra_body": {
"enable_thinking": true
}
}
},
{
"id": "qwen3.7-max",
"name": "[Token Plan 个人版] qwen3.7-max",
"baseUrl": "https://token-plan.cn-beijing.maas.aliyuncs.com/compatible-mode/v1",
"envKey": "BAILIAN_TOKEN_PLAN_API_KEY",
"generationConfig": {
"extra_body": {
"enable_thinking": true
}
}
},
{
"id": "qwen3.7-plus",
"name": "[Token Plan 个人版] qwen3.7-plus",
"baseUrl": "https://token-plan.cn-beijing.maas.aliyuncs.com/compatible-mode/v1",
"envKey": "BAILIAN_TOKEN_PLAN_API_KEY",
"generationConfig": {
"extra_body": {
"enable_thinking": true
}
}
},
{
"id": "qwen3.6-flash",
"name": "[Token Plan 个人版] qwen3.6-flash",
"baseUrl": "https://token-plan.cn-beijing.maas.aliyuncs.com/compatible-mode/v1",
"envKey": "BAILIAN_TOKEN_PLAN_API_KEY",
"generationConfig": {
"extra_body": {
"enable_thinking": true
}
}
},
{
"id": "glm-5.3",
"name": "[Token Plan 个人版] glm-5.3",
"baseUrl": "https://token-plan.cn-beijing.maas.aliyuncs.com/compatible-mode/v1",
"envKey": "BAILIAN_TOKEN_PLAN_API_KEY"
},
{
"id": "glm-5.2",
"name": "[Token Plan 个人版] glm-5.2",
"baseUrl": "https://token-plan.cn-beijing.maas.aliyuncs.com/compatible-mode/v1",
"envKey": "BAILIAN_TOKEN_PLAN_API_KEY"
},
{
"id": "deepseek-v4.1-flash",
"name": "[Token Plan 个人版] deepseek-v4.1-flash",
"baseUrl": "https://token-plan.cn-beijing.maas.aliyuncs.com/compatible-mode/v1",
"envKey": "BAILIAN_TOKEN_PLAN_API_KEY"
},
{
"id": "deepseek-v4-pro",
"name": "[Token Plan 个人版] deepseek-v4-pro",
"baseUrl": "https://token-plan.cn-beijing.maas.aliyuncs.com/compatible-mode/v1",
"envKey": "BAILIAN_TOKEN_PLAN_API_KEY"
},
{
"id": "deepseek-v4-pro-0813",
"name": "[Token Plan 个人版] deepseek-v4-pro-0813",
"baseUrl": "https://token-plan.cn-beijing.maas.aliyuncs.com/compatible-mode/v1",
"envKey": "BAILIAN_TOKEN_PLAN_API_KEY"
},
{
"id": "deepseek-v4-flash-0731",
"name": "[Token Plan 个人版] deepseek-v4-flash-0731",
"baseUrl": "https://token-plan.cn-beijing.maas.aliyuncs.com/compatible-mode/v1",
"envKey": "BAILIAN_TOKEN_PLAN_API_KEY"
}
]
},
"security": {
"auth": {
"selectedType": "openai"
}
},
"tokenPlan": {
"region": "china"
},
"model": {
"name": "auto"
},
"$version": 3
}
Token Plan 团队版
启动 Qwen Code 后输入 /auth，依次选择 订阅计划 > 阿里云百炼 Token Plan，输入 Token Plan 团队版专属 API Key 即可完成配置。可用模型请参考 Token Plan 团队版支持的模型。
高级配置：通过 settings.json 配置文件编辑或新建 settings.json 文件，将 YOUR_API_KEY 替换为 Token Plan 团队版专属 API Key。文件路径如下：
macOS/Linux：~/.qwen/settings.json
Windows：C:\Users\\.qwen\settings.json
Copy{
"env": {
"BAILIAN_TOKEN_PLAN_API_KEY": "YOUR_API_KEY"
},
"modelProviders": {
"openai": [
{
"id": "auto",
"name": "[Token Plan 团队版] auto",
"baseUrl": "https://token-plan.cn-beijing.maas.aliyuncs.com/compatible-mode/v1",
"envKey": "BAILIAN_TOKEN_PLAN_API_KEY"
},
{
"id": "qwen3.8-max",
"name": "[Token Plan 团队版] qwen3.8-max",
"baseUrl": "https://token-plan.cn-beijing.maas.aliyuncs.com/compatible-mode/v1",
"envKey": "BAILIAN_TOKEN_PLAN_API_KEY",
"generationConfig": {
"extra_body": {
"enable_thinking": true
}
}
},
{
"id": "qwen3.8-flash",
"name": "[Token Plan 团队版] qwen3.8-flash",
"baseUrl": "https://token-plan.cn-beijing.maas.aliyuncs.com/compatible-mode/v1",
"envKey": "BAILIAN_TOKEN_PLAN_API_KEY",
"generationConfig": {
"extra_body": {
"enable_thinking": true
}
}
},
{
"id": "qwen3.7-max",
"name": "[Token Plan 团队版] qwen3.7-max",
"baseUrl": "https://token-plan.cn-beijing.maas.aliyuncs.com/compatible-mode/v1",
"envKey": "BAILIAN_TOKEN_PLAN_API_KEY",
"generationConfig": {
"extra_body": {
"enable_thinking": true
}
}
},
{
"id": "qwen3.7-plus",
"name": "[Token Plan 团队版] qwen3.7-plus",
"baseUrl": "https://token-plan.cn-beijing.maas.aliyuncs.com/compatible-mode/v1",
"envKey": "BAILIAN_TOKEN_PLAN_API_KEY",
"generationConfig": {
"extra_body": {
"enable_thinking": true
}
}
},
{
"id": "qwen3.6-plus",
"name": "[Token Plan 团队版] qwen3.6-plus",
"baseUrl": "https://token-plan.cn-beijing.maas.aliyuncs.com/compatible-mode/v1",
"envKey": "BAILIAN_TOKEN_PLAN_API_KEY",
"generationConfig": {
"extra_body": {
"enable_thinking": true
}
}
},
{
"id": "qwen3.6-flash",
"name": "[Token Plan 团队版] qwen3.6-flash",
"baseUrl": "https://token-plan.cn-beijing.maas.aliyuncs.com/compatible-mode/v1",
"envKey": "BAILIAN_TOKEN_PLAN_API_KEY",
"generationConfig": {
"extra_body": {
"enable_thinking": true
}
}
},
{
"id": "deepseek-v4.1-flash",
"name": "[Token Plan 团队版] deepseek-v4.1-flash",
"baseUrl": "https://token-plan.cn-beijing.maas.aliyuncs.com/compatible-mode/v1",
"envKey": "BAILIAN_TOKEN_PLAN_API_KEY"
},
{
"id": "deepseek-v4-pro",
"name": "[Token Plan 团队版] deepseek-v4-pro",
"baseUrl": "https://token-plan.cn-beijing.maas.aliyuncs.com/compatible-mode/v1",
"envKey": "BAILIAN_TOKEN_PLAN_API_KEY"
},
{
"id": "deepseek-v4-pro-0813",
"name": "[Token Plan 团队版] deepseek-v4-pro-0813",
"baseUrl": "https://token-plan.cn-beijing.maas.aliyuncs.com/compatible-mode/v1",
"envKey": "BAILIAN_TOKEN_PLAN_API_KEY"
},
{
"id": "deepseek-v4-flash-0731",
"name": "[Token Plan 团队版] deepseek-v4-flash-0731",
"baseUrl": "https://token-plan.cn-beijing.maas.aliyuncs.com/compatible-mode/v1",
"envKey": "BAILIAN_TOKEN_PLAN_API_KEY"
},
{
"id": "kimi-k2.7-code",
"name": "[Token Plan 团队版] kimi-k2.7-code",
"baseUrl": "https://token-plan.cn-beijing.maas.aliyuncs.com/compatible-mode/v1",
"envKey": "BAILIAN_TOKEN_PLAN_API_KEY",
"generationConfig": {
"extra_body": {
"enable_thinking": true
}
}
},
{
"id": "kimi-k2.6",
"name": "[Token Plan 团队版] kimi-k2.6",
"baseUrl": "https://token-plan.cn-beijing.maas.aliyuncs.com/compatible-mode/v1",
"envKey": "BAILIAN_TOKEN_PLAN_API_KEY",
"generationConfig": {
"extra_body": {
"enable_thinking": true
}
}
},
{
"id": "kimi-k2.5",
"name": "[Token Plan 团队版] kimi-k2.5",
"baseUrl": "https://token-plan.cn-beijing.maas.aliyuncs.com/compatible-mode/v1",
"envKey": "BAILIAN_TOKEN_PLAN_API_KEY",
"generationConfig": {
"extra_body": {
"enable_thinking": true
}
}
},
{
"id": "glm-5.3",
"name": "[Token Plan 团队版] glm-5.3",
"baseUrl": "https://token-plan.cn-beijing.maas.aliyuncs.com/compatible-mode/v1",
"envKey": "BAILIAN_TOKEN_PLAN_API_KEY",
"generationConfig": {
"extra_body": {
"enable_thinking": true
}
}
},
{
"id": "glm-5.2",
"name": "[Token Plan 团队版] glm-5.2",
"baseUrl": "https://token-plan.cn-beijing.maas.aliyuncs.com/compatible-mode/v1",
"envKey": "BAILIAN_TOKEN_PLAN_API_KEY",
"generationConfig": {
"extra_body": {
"enable_thinking": true
}
}
},
{
"id": "glm-5.1",
"name": "[Token Plan 团队版] glm-5.1",
"baseUrl": "https://token-plan.cn-beijing.maas.aliyuncs.com/compatible-mode/v1",
"envKey": "BAILIAN_TOKEN_PLAN_API_KEY",
"generationConfig": {
"extra_body": {
"enable_thinking": true
}
}
},
{
"id": "glm-5",
"name": "[Token Plan 团队版] glm-5",
"baseUrl": "https://token-plan.cn-beijing.maas.aliyuncs.com/compatible-mode/v1",
"envKey": "BAILIAN_TOKEN_PLAN_API_KEY",
"generationConfig": {
"extra_body": {
"enable_thinking": true
}
}
},
{
"id": "MiniMax-M2.5",
"name": "[Token Plan 团队版] MiniMax-M2.5",
"baseUrl": "https://token-plan.cn-beijing.maas.aliyuncs.com/compatible-mode/v1",
"envKey": "BAILIAN_TOKEN_PLAN_API_KEY"
}
]
},
"security": {
"auth": {
"selectedType": "openai"
}
},
"tokenPlan": {
"region": "china"
},
"model": {
"name": "auto"
},
"$version": 3
}
Coding Plan
启动 Qwen Code 后输入 /auth，依次选择 订阅计划 > 阿里云百炼 Coding Plan，选择 Coding Plan 区域（china），输入 Coding Plan 专属 API Key 即可完成配置。可用模型请参考 Coding Plan 支持的模型。
高级配置：通过 settings.json 配置文件编辑或新建 settings.json 文件，将 YOUR_API_KEY 替换为 Coding Plan 专属 API Key。文件路径如下：
macOS/Linux：~/.qwen/settings.json
Windows：C:\Users\\.qwen\settings.json
Copy{
"env": {
"BAILIAN_CODING_PLAN_API_KEY": "YOUR_API_KEY"
},
"modelProviders": {
"openai": [
{
"id": "qwen3.7-plus",
"name": "[Bailian Coding Plan] qwen3.7-plus",
"baseUrl": "https://coding.dashscope.aliyuncs.com/v1",
"envKey": "BAILIAN_CODING_PLAN_API_KEY",
"generationConfig": {
"extra_body": {
"enable_thinking": true
}
}
},
{
"id": "qwen3.6-plus",
"name": "[Bailian Coding Plan] qwen3.6-plus",
"baseUrl": "https://coding.dashscope.aliyuncs.com/v1",
"envKey": "BAILIAN_CODING_PLAN_API_KEY",
"generationConfig": {
"extra_body": {
"enable_thinking": true
}
}
},
{
"id": "qwen3.5-plus",
"name": "[Bailian Coding Plan] qwen3.5-plus",
"baseUrl": "https://coding.dashscope.aliyuncs.com/v1",
"envKey": "BAILIAN_CODING_PLAN_API_KEY",
"generationConfig": {
"extra_body": {
"enable_thinking": true
}
}
},
{
"id": "MiniMax-M2.5",
"name": "[Bailian Coding Plan] MiniMax-M2.5",
"baseUrl": "https://coding.dashscope.aliyuncs.com/v1",
"envKey": "BAILIAN_CODING_PLAN_API_KEY"
},
{
"id": "glm-5",
"name": "[Bailian Coding Plan] glm-5",
"baseUrl": "https://coding.dashscope.aliyuncs.com/v1",
"envKey": "BAILIAN_CODING_PLAN_API_KEY",
"generationConfig": {
"extra_body": {
"enable_thinking": true
}
}
},
{
"id": "kimi-k2.5",
"name": "[Bailian Coding Plan] kimi-k2.5",
"baseUrl": "https://coding.dashscope.aliyuncs.com/v1",
"envKey": "BAILIAN_CODING_PLAN_API_KEY",
"generationConfig": {
"extra_body": {
"enable_thinking": true
}
}
}
]
},
"security": {
"auth": {
"selectedType": "openai"
}
},
"codingPlan": {
"region": "china"
},
"model": {
"name": "qwen3.7-plus"
},
"$version": 3
}
按量计费
启动 Qwen Code 后输入 /auth，选择 使用自己的 API Key > Standard API Key，选择对应地域并输入阿里云百炼 API Key 即可完成配置。可用模型请参考OpenAI 兼容 - 支持的模型。
高级配置：通过 settings.json 配置文件编辑或新建 settings.json 文件，将 YOUR_API_KEY 替换为阿里云百炼 API Key。文件路径如下：
macOS/Linux：~/.qwen/settings.json
Windows：C:\Users\\.qwen\settings.json
baseUrl 按地域设置（URL 中的 {WorkspaceId} 需替换为真实的获取Workspace ID），API Key 需与所选地域对应：
华北2（北京）：https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/compatible-mode/v1
新加坡：https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1
美国（弗吉尼亚）：https://{WorkspaceId}.us-east-1.maas.aliyuncs.com/compatible-mode/v1
Copy{
"env": {
"BAILIAN_API_KEY": "YOUR_API_KEY"
},
"modelProviders": {
"openai": [
{
"id": "qwen3.6-plus",
"name": "[Bailian] qwen3.6-plus",
"baseUrl": "https://{WorkspaceId}.cn-beijing.maas.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
}
如需添加其他模型，在 modelProviders.openai 中以相同格式追加即可。
验证配置
配置完成后，在项目目录下运行以下命令启动 Qwen Code，即可开始对话。
Copyqwen
Qwen Code IDE 插件
Qwen Code 支持在 VS Code 中以插件方式使用，在 IDE 中提供 AI 编程能力。
VS Code
使用前请确保 VS Code 版本为 1.85.0 或更高版本。
打开 VS Code，在扩展市场中搜索 Qwen Code Companion 并安装。
CLI 和 IDE 插件共用同一个 settings.json。如果已按上方步骤完成配置，请跳过此步。否则请按照上方配置接入凭证章节进行配置。
点击右上角图标启动 Qwen Code，通过输入或点击/，选择Switch model切换模型。
Qwen Code 桌面版
Qwen Code Desktop 是 Qwen Code 的图形界面应用，内置 CLI 运行时，无需额外安装命令行工具。桌面版与 CLI 共用同一份 settings.json 配置文件，如果已通过 CLI 完成配置，桌面版打开即可直接使用，无需重复配置。
前往 Qwen Code GitHub Releases 页面，下载适用于您操作系统（macOS、Windows 或 Linux）的桌面版安装包。
如果尚未配置，可通过桌面版图形界面完成：
打开 Qwen Code Desktop，点击左侧设置，选择 AI 页签。
在模型 Provider区域点击+ 连接。
在弹窗中选择 Alibaba ModelStudio 页签，根据计费方案选择对应项：
Coding Plan：固定月费订阅，按模型调用次数计量。
Token Plan：含个人版与团队版，按 token 消耗抵扣 Credits。
Standard API Key：使用已有的百炼 API Key 按量计费。
按照页面提示输入 API Key，完成配置。
常见命令
以下命令适用于 Qwen Code CLI，IDE 插件仅支持部分命令，请以实际使用为准。
命令说明示例/model切换当前会话中使用的模型。/model/auth更改认证方式。/auth/init分析当前目录并创建初始上下文文件（QWEN.md），用于定义项目级指令和上下文。/init/clear清除终端屏幕内容，开始全新对话。/clear/compress用摘要替换聊天历史以节省 Token。/compress/settings打开设置编辑器，可配置语言、主题等。/settings/summary根据对话历史生成项目摘要。/summary/resume恢复之前的对话会话。/resume/stats显示当前会话的详细统计信息。/stats/help显示可用命令的帮助信息。/help或/?/quit退出 Qwen Code。/quit
更多 Qwen Code 的进阶功能，可以参考 Qwen Code 官方文档。
使用案例
接入百炼 CLI
百炼 CLI 安装时会向 ~/.qwen/skills/bailian-cli/ 注册 Skill，Qwen Code 即可通过对话调用百炼能力，能力清单详见百炼 CLI 控制台。前置要求 Node.js 18+。
告诉 Qwen Code 安装百炼 CLI：
Copy请帮我全局安装阿里云百炼 CLI 命令行工具：npm install -g bailian-cli
前往百炼控制台获取 API Key，告诉 Qwen Code 配置：
Copy配置我的 API Key 是：sk-xxxxxxxxxxxxx
API Key 为敏感凭证，请勿泄露。在对话中粘贴明文 API Key 可能被会话记录留存，建议优先通过环境变量或 settings.json 配置 API Key。
直接用自然语言描述需求即可开始使用，例如：
Copy帮我生成 6 张亚马逊电商主图，产品是白色无线蓝牙耳机。
Copy帮我生成一段 30 秒的白色无线蓝牙耳机产品演示视频。
一句话复刻网站样式
指定目标网站截图，Qwen Code 自动解析页面结构，生成高还原度的前端代码。
复刻以下网站的样式操作演示
配置步骤
安装并配置 Qwen Code。
在终端输入qwen进入 Qwen Code。
输入以下内容安装插件，选择 ui-design 完成安装。
Copy/extensions install wshobson/agents
wshobson/agents、vercel-labs/skills 等为第三方仓库，其脚本与代码不受阿里云审核和维护。安装第三方插件或 Skill 前，请自行评估其来源可信度与代码安全性，谨慎在生产环境中使用。
输入以下内容安装 skill。
Copy查看我是否有find skills，没有就直接帮我安装：npx skills add https://github.com/vercel-labs/skills --skill find-skills -y -a qwen-code，然后从 wshobson/agents 帮我安装 web-component-design 到当前目录：npx skills add https://github.com/wshobson/agents --skill web-component-design -y
下载website.png到项目目录，输入以下内容，将自动识别截图的布局、样式，生成网页代码。
Copy/skills web-component-design 根据这个技能，基于 @website.png 帮我复刻一个网页html，注意图片引用需有效。
为开源项目制作宣传视频
给定开源项目仓库地址，即可一键生成专属宣传视频。
仓库地址为：https://github.com/QwenLM/qwen-code。
配置步骤
安装并配置 Qwen Code。
在终端输入qwen进入 Qwen Code。
输入以下内容制作视频。
Copy基于这个技能 https://github.com/QwenLM/qwen-code-examples/blob/main/skills/oss-styles/SKILL.md，帮我为开源仓库：https://github.com/QwenLM/qwen-code 生成一个演示视频
了解更多
Qwen Code 的子智能体、MCP、Skills 等高级功能，请参见Qwen Code 官方文档。
Qwen Code 的使用案例，请参见使用案例。
常见问题
错误码
配置过程中遇到报错，请参考对应计费方案的常见问题文档：
按量付费：错误码
Coding Plan：Coding Plan 常见问题
Token Plan 个人版：Token Plan 个人版常见问题
Token Plan 团队版：Token Plan 团队版常见问题
如何切换模型？
在 Qwen Code 中直接输入 /model 命令，即可从 settings.json 中已配置的模型列表中选择切换。如需添加新模型，请在 settings.json 的 modelProviders 中添加对应配置，然后重启 Qwen Code。
