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。
-
Windows:
在任务栏搜索框里输入
cmd,选择以管理员身份运行,打开cmd窗口后运行以下命令安装 Qwen Code。
-
关闭并重新打开
cmd窗口 Windows 系统在安装完成后,需关闭当前cmd窗口,以使环境变量生效。重新打开cmd后,运行以下命令查看当前安装版本。
配置接入凭证
启动 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 配置文件
编辑或新建
settings.json 文件,将 YOUR_API_KEY 替换为 Token Plan 个人版专属 API Key。文件路径如下:- macOS/Linux:
~/.qwen/settings.json - Windows:
C:\Users\<Windows用户名>\.qwen\settings.json
关键字段说明:
env 用于定义存放 API Key 的环境变量,模型条目中的 envKey 需与该环境变量名保持一致;generationConfig.extra_body.enable_thinking 用于开启或关闭模型思考模式;部分示例中的 $version 为配置文件格式版本号,请保留默认值。完整字段以 Qwen Code 产品文档为准。Token Plan 团队版
启动 Qwen Code 后输入 /auth,依次选择 订阅计划 > 阿里云百炼 Token Plan,输入 Token Plan 团队版专属 API Key 即可完成配置。可用模型请参考 Token Plan 团队版支持的模型。
高级配置:通过 settings.json 配置文件
高级配置:通过 settings.json 配置文件
编辑或新建
settings.json 文件,将 YOUR_API_KEY 替换为 Token Plan 团队版专属 API Key。文件路径如下:- macOS/Linux:
~/.qwen/settings.json - Windows:
C:\Users\<Windows用户名>\.qwen\settings.json
Coding Plan
启动 Qwen Code 后输入 /auth,依次选择 订阅计划 > 阿里云百炼 Coding Plan,选择 Coding Plan 区域(china),输入 Coding Plan 专属 API Key 即可完成配置。可用模型请参考 Coding Plan 支持的模型。
高级配置:通过 settings.json 配置文件
高级配置:通过 settings.json 配置文件
编辑或新建
settings.json 文件,将 YOUR_API_KEY 替换为 Coding Plan 专属 API Key。文件路径如下:- macOS/Linux:
~/.qwen/settings.json - Windows:
C:\Users\<Windows用户名>\.qwen\settings.json
按量计费
启动 Qwen Code 后输入 /auth,选择 使用自己的 API Key > Standard API Key,选择对应地域并输入阿里云百炼 API Key 即可完成配置。可用模型请参考OpenAI 兼容 - 支持的模型。
高级配置:通过 settings.json 配置文件
高级配置:通过 settings.json 配置文件
编辑或新建 如需添加其他模型,在
settings.json 文件,将 YOUR_API_KEY 替换为阿里云百炼 API Key。文件路径如下:- macOS/Linux:
~/.qwen/settings.json - Windows:
C:\Users\<Windows用户名>\.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
modelProviders.openai 中以相同格式追加即可。验证配置
配置完成后,在项目目录下运行以下命令启动 Qwen Code,即可开始对话。
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 插件仅支持部分命令,请以实际使用为准。
命令 | 说明 | 示例 |
|---|---|---|
| 切换当前会话中使用的模型。 |
|
| 更改认证方式。 |
|
| 分析当前目录并创建初始上下文文件(QWEN.md),用于定义项目级指令和上下文。 |
|
| 清除终端屏幕内容,开始全新对话。 |
|
| 用摘要替换聊天历史以节省 Token。 |
|
| 打开设置编辑器,可配置语言、主题等。 |
|
| 根据对话历史生成项目摘要。 |
|
| 恢复之前的对话会话。 |
|
| 显示当前会话的详细统计信息。 |
|
| 显示可用命令的帮助信息。 |
|
| 退出 Qwen Code。 |
|
使用案例
接入百炼 CLI
百炼 CLI 安装时会向 ~/.qwen/skills/bailian-cli/ 注册 Skill,Qwen Code 即可通过对话调用百炼能力,能力清单详见百炼 CLI 控制台。前置要求 Node.js 18+。
- 告诉 Qwen Code 安装百炼 CLI:
- 前往百炼控制台获取 API Key,告诉 Qwen Code 配置:
- 直接用自然语言描述需求即可开始使用,例如:
一句话复刻网站样式
指定目标网站截图,Qwen Code 自动解析页面结构,生成高还原度的前端代码。
复刻以下网站的样式![]() | 操作演示 |
配置步骤
配置步骤
- 安装并配置 Qwen Code。
- 在终端输入
qwen进入 Qwen Code。 - 输入以下内容安装插件,选择
ui-design完成安装。
- 输入以下内容安装 skill。
- 下载website.png到项目目录,输入以下内容,将自动识别截图的布局、样式,生成网页代码。
为开源项目制作宣传视频
给定开源项目仓库地址,即可一键生成专属宣传视频。
仓库地址为:https://github.com/QwenLM/qwen-code。
配置步骤
配置步骤
- 安装并配置 Qwen Code。
- 在终端输入
qwen进入 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。