Qwen Code 是一款终端 AI 编程工具,可以通过按量计费、Coding Plan 或 Token Plan 团队版接入阿里云百炼。
安装 Qwen Code
-
运行安装命令
-
macOS/Linux:
打开终端,运行以下命令安装 Qwen Code。
bash -c "$(curl -fsSL https://qwen-code-assets.oss-cn-hangzhou.aliyuncs.com/installation/install-qwen.sh)" -s --source bailian -
Windows:
在任务栏搜索框里输入
cmd,选择以管理员身份运行,打开cmd窗口后运行以下命令安装 Qwen Code。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
-
-
关闭并重新打开
cmd窗口Windows 系统在安装完成后,需关闭当前
cmd窗口,以使环境变量生效。重新打开cmd后,运行以下命令查看当前安装版本。qwen --version
配置接入凭证
启动 Qwen Code 后输入 /auth 命令进行可视化配置。阿里云百炼提供三种计费方案,根据需要选择:
-
Token Plan 团队版:按坐席订阅,按 token 消耗抵扣 Credits。
-
Coding Plan:固定月费订阅,按模型调用次数计量。
-
按量计费:按实际调用量后付费。
Token Plan 团队版
启动 Qwen Code 后输入 /auth,依次选择 订阅计划 > 阿里云百炼 Token Plan,输入 Token Plan 团队版专属 API Key 即可完成配置。可用模型请参考 Token Plan 团队版支持的模型。
Coding Plan
启动 Qwen Code 后输入 /auth,依次选择 订阅计划 > 阿里云百炼 Coding Plan,选择 Coding Plan 区域(global),输入 Coding Plan 专属 API Key 即可完成配置。可用模型请参考 Coding Plan 支持的模型。
按量计费
启动 Qwen Code 后输入 /auth,选择 使用自己的 API Key > Standard API Key,选择对应地域并输入阿里云百炼 API Key 即可完成配置。可用模型请参考OpenAI 兼容 - 支持的模型。
验证配置
配置完成后,在项目目录下运行以下命令启动 Qwen Code,即可开始对话。
qwen
Qwen Code IDE 插件
Qwen Code 支持在 VS Code 和 JetBrains IDE 中以插件方式使用,在 IDE 中提供 AI 编程能力。
VS Code
使用前请确保 VS Code 版本为 1.85.0 或更高版本。
-
打开 VS Code,在扩展市场中搜索
Qwen Code Companion并安装。 -
CLI 和 IDE 插件共用同一个
settings.json。如果已按上方步骤完成配置,请跳过此步。否则请按照上方配置接入凭证章节进行配置。 -
点击右上角图标启动 Qwen Code,通过输入或点击
/,选择Switch model切换模型。
JetBrains IDE
使用前请确保 JetBrains IDE 支持 Agent Client Protocol(ACP)。
-
Qwen Code IDE 依赖于 Qwen Code CLI,请先参考本文安装 Qwen Code章节进行安装并完成配置接入凭证。
-
打开 JetBrains IDE,进入AI Chat页面,点击 Install Plugin,IDEA 将安装 JetBrains Al Assistant 插件。
-
点击 AI Chat 窗口右上角三点菜单,选择 Add Custom Agent,按以下配置填写。请将
/path/to/qwen替换为 Qwen Code 安装路径,可运行以下命令查看该路径:-
macOS/Linux:
which qwen -
Windows:
where qwen(CMD)或Get-Command qwen(PowerShell)
{ "agent_servers": { "qwen": { "command": "/path/to/qwen", "args": ["--acp"], "env": {} } } } -
-
配置完成后,Qwen Code 将出现在 AI Chat 面板中,在右下角可以进行模型切换。
常见命令
以下命令适用于 Qwen Code CLI,IDE 插件仅支持部分命令,请以实际使用为准。
|
命令 |
说明 |
示例 |
|
|
切换当前会话中使用的模型。 |
|
|
|
更改认证方式。 |
|
|
|
分析当前目录并创建初始上下文文件(QWEN.md),用于定义项目级指令和上下文。 |
|
|
|
清除终端屏幕内容,开始全新对话。 |
|
|
|
用摘要替换聊天历史以节省 Token。 |
|
|
|
打开设置编辑器,可配置语言、主题等。 |
|
|
|
根据对话历史生成项目摘要。 |
|
|
|
恢复之前的对话会话。 |
|
|
|
显示当前会话的详细统计信息。 |
|
|
|
显示可用命令的帮助信息。 |
|
|
|
退出 Qwen Code。 |
|
更多 Qwen Code 的进阶功能,可以参考 Qwen Code 官方文档。
了解更多
-
Qwen Code 的子智能体、MCP、Skills 等高级功能,请参见Qwen Code 官方文档。
-
Qwen Code 的使用案例,请参见使用案例。
常见问题
错误码
配置过程中遇到报错,请参考对应计费方案的常见问题文档:
-
按量付费:错误码
-
Coding Plan:Coding Plan 常见问题
-
Token Plan 团队版:Token Plan 团队版常见问题
如何切换模型?
在 Qwen Code 中直接输入 /model 命令,即可从 settings.json 中已配置的模型列表中选择切换。如需添加新模型,请在 settings.json 的 modelProviders 中添加对应配置,然后重启 Qwen Code。