在 Qwen Code 中使用千问AI平台模型
Qwen Code 是一款 AI 编程助手,本文介绍如何在 Qwen Code(CLI、桌面版及 IDE 插件)中配置与使用千问AI平台模型,支持 Token Plan 个人版、Token Plan 团队版和按量计费。
使用 qwen4-max-preview 时,默认输出上限 32768;长输出可在模型条目内设置
generationConfig.samplingParams.max_tokens。使用 qwen4-max 时,默认输出上限 32768;长输出可在模型条目内设置
generationConfig.samplingParams.max_tokens。qwen4-max 的上下文长度为 1M Token;非思考模式最大输出 131,072 Token,思考与最终回答合计最大 262,144 Token;默认 reasoning_effort=high,thinking_budget=131072。快速接入
选择你使用的客户端,完成配置。- CLI
- 桌面版
- IDE 插件
1
连接服务商
运行
qwen,首次使用时选择 Alibaba ModelStudio,然后按提示选择计费方案。2
输入 API Key
- Token Plan
- 按量计费
使用 Token Plan API Key:
- Token Plan 个人版:创建或查看 API Key
- Token Plan 团队版:分配坐席并获取 API Key
使用千问AI平台控制台获取的千问AI平台 API Key。
3
验证
复制
qwen -p "你好"
1
打开模型设置
点击左下角 更多 > 设置 > 模型,点击 + 增加模型。
2
选择供应商
类型选择 Alibaba ModelStudio,供应商选择 Token Plan 或 Standard API Key。
3
输入 API Key
- Token Plan 个人版:创建或查看 API Key
- Token Plan 团队版:分配坐席并获取 API Key
- Standard API Key:使用 千问AI平台 API Key
4
选择模型并保存
模型 ID 已预置,按需保留或添加。点击 保存,在模型列表中选择新添加的模型。
1
安装插件
在所用 IDE 的扩展市场安装 Qwen Code Companion。
2
配置模型
按通过配置文件接入写入所选计费方案的配置。
3
打开 Qwen Code
点击 Qwen 图标,或在命令面板运行
Qwen Code: Open。通过配置文件接入
除了上述方式,也可以通过配置文件接入。1
打开或新建配置文件
- macOS / Linux:
~/.qwen/settings.json - Windows:
C:\Users\<用户名>\.qwen\settings.json
2
写入配置
- Token Plan 个人版
- Token Plan 团队版
- 按量计费
在千问AI平台控制台获取 Token Plan API Key,替换
YOUR_API_KEY。复制
{
"$version": 4,
"env": {
"QIANWEN_TOKEN_PLAN_API_KEY": "YOUR_API_KEY"
},
"modelProviders": {
"openai": [
{
"id": "auto",
"name": "[Token Plan Personal] auto",
"baseUrl": "https://token-plan.maas.qianwenaiapi.com/compatible-mode/v1",
"envKey": "QIANWEN_TOKEN_PLAN_API_KEY"
},
{
"id": "qwen4-max",
"name": "[Token Plan Personal] qwen4-max",
"baseUrl": "https://token-plan.maas.qianwenaiapi.com/compatible-mode/v1",
"envKey": "QIANWEN_TOKEN_PLAN_API_KEY"
},
{
"id": "qwen4-max-preview",
"name": "[Token Plan Personal] qwen4-max-preview",
"baseUrl": "https://token-plan.maas.qianwenaiapi.com/compatible-mode/v1",
"envKey": "QIANWEN_TOKEN_PLAN_API_KEY"
},
{
"id": "qwen3.8-max",
"name": "[Token Plan Personal] qwen3.8-max",
"baseUrl": "https://token-plan.maas.qianwenaiapi.com/compatible-mode/v1",
"envKey": "QIANWEN_TOKEN_PLAN_API_KEY"
},
{
"id": "qwen3.8-flash",
"name": "[Token Plan Personal] qwen3.8-flash",
"baseUrl": "https://token-plan.maas.qianwenaiapi.com/compatible-mode/v1",
"envKey": "QIANWEN_TOKEN_PLAN_API_KEY"
},
{
"id": "qwen3.7-max",
"name": "[Token Plan Personal] qwen3.7-max",
"baseUrl": "https://token-plan.maas.qianwenaiapi.com/compatible-mode/v1",
"envKey": "QIANWEN_TOKEN_PLAN_API_KEY"
},
{
"id": "qwen3.7-plus",
"name": "[Token Plan Personal] qwen3.7-plus",
"baseUrl": "https://token-plan.maas.qianwenaiapi.com/compatible-mode/v1",
"envKey": "QIANWEN_TOKEN_PLAN_API_KEY"
},
{
"id": "qwen3.6-flash",
"name": "[Token Plan Personal] qwen3.6-flash",
"baseUrl": "https://token-plan.maas.qianwenaiapi.com/compatible-mode/v1",
"envKey": "QIANWEN_TOKEN_PLAN_API_KEY"
},
{
"id": "qwen-image-3.0-pro",
"name": "[Token Plan Personal] qwen-image-3.0-pro",
"baseUrl": "https://token-plan.maas.qianwenaiapi.com/compatible-mode/v1",
"envKey": "QIANWEN_TOKEN_PLAN_API_KEY"
},
{
"id": "qwen-audio-3.0-tts-plus",
"name": "[Token Plan Personal] qwen-audio-3.0-tts-plus",
"baseUrl": "https://token-plan.maas.qianwenaiapi.com/compatible-mode/v1",
"envKey": "QIANWEN_TOKEN_PLAN_API_KEY"
},
{
"id": "qwen-audio-3.0-realtime-plus",
"name": "[Token Plan Personal] qwen-audio-3.0-realtime-plus",
"baseUrl": "https://token-plan.maas.qianwenaiapi.com/compatible-mode/v1",
"envKey": "QIANWEN_TOKEN_PLAN_API_KEY"
},
{
"id": "qwen-audio-3.0-asr-flash",
"name": "[Token Plan Personal] qwen-audio-3.0-asr-flash",
"baseUrl": "https://token-plan.maas.qianwenaiapi.com/compatible-mode/v1",
"envKey": "QIANWEN_TOKEN_PLAN_API_KEY"
},
{
"id": "wan2.7-image",
"name": "[Token Plan Personal] wan2.7-image",
"baseUrl": "https://token-plan.maas.qianwenaiapi.com/compatible-mode/v1",
"envKey": "QIANWEN_TOKEN_PLAN_API_KEY"
},
{
"id": "wan2.7-image-pro",
"name": "[Token Plan Personal] wan2.7-image-pro",
"baseUrl": "https://token-plan.maas.qianwenaiapi.com/compatible-mode/v1",
"envKey": "QIANWEN_TOKEN_PLAN_API_KEY"
},
{
"id": "wan3.0-video",
"name": "[Token Plan Personal] wan3.0-video",
"baseUrl": "https://token-plan.maas.qianwenaiapi.com/compatible-mode/v1",
"envKey": "QIANWEN_TOKEN_PLAN_API_KEY"
},
{
"id": "deepseek-v4.1-flash",
"name": "[Token Plan Personal] deepseek-v4.1-flash",
"baseUrl": "https://token-plan.maas.qianwenaiapi.com/compatible-mode/v1",
"envKey": "QIANWEN_TOKEN_PLAN_API_KEY"
},
{
"id": "deepseek-v4.1-flash-1017",
"name": "[Token Plan Personal] deepseek-v4.1-flash-1017",
"baseUrl": "https://token-plan.maas.qianwenaiapi.com/compatible-mode/v1",
"envKey": "QIANWEN_TOKEN_PLAN_API_KEY"
},
{
"id": "deepseek-v4-pro",
"name": "[Token Plan Personal] deepseek-v4-pro",
"baseUrl": "https://token-plan.maas.qianwenaiapi.com/compatible-mode/v1",
"envKey": "QIANWEN_TOKEN_PLAN_API_KEY"
},
{
"id": "deepseek-v4-pro-0813",
"name": "[Token Plan Personal] deepseek-v4-pro-0813",
"baseUrl": "https://token-plan.maas.qianwenaiapi.com/compatible-mode/v1",
"envKey": "QIANWEN_TOKEN_PLAN_API_KEY"
},
{
"id": "deepseek-v4-flash-0731",
"name": "[Token Plan Personal] deepseek-v4-flash-0731",
"baseUrl": "https://token-plan.maas.qianwenaiapi.com/compatible-mode/v1",
"envKey": "QIANWEN_TOKEN_PLAN_API_KEY"
},
{
"id": "glm-5.3",
"name": "[Token Plan Personal] glm-5.3",
"baseUrl": "https://token-plan.maas.qianwenaiapi.com/compatible-mode/v1",
"envKey": "QIANWEN_TOKEN_PLAN_API_KEY"
},
{
"id": "glm-5.2",
"name": "[Token Plan Personal] glm-5.2",
"baseUrl": "https://token-plan.maas.qianwenaiapi.com/compatible-mode/v1",
"envKey": "QIANWEN_TOKEN_PLAN_API_KEY"
},
{
"id": "happyhorse-1.1-i2v",
"name": "[Token Plan Personal] happyhorse-1.1-i2v",
"baseUrl": "https://token-plan.maas.qianwenaiapi.com/compatible-mode/v1",
"envKey": "QIANWEN_TOKEN_PLAN_API_KEY"
},
{
"id": "happyhorse-1.1-t2v",
"name": "[Token Plan Personal] happyhorse-1.1-t2v",
"baseUrl": "https://token-plan.maas.qianwenaiapi.com/compatible-mode/v1",
"envKey": "QIANWEN_TOKEN_PLAN_API_KEY"
},
{
"id": "happyhorse-1.1-r2v",
"name": "[Token Plan Personal] happyhorse-1.1-r2v",
"baseUrl": "https://token-plan.maas.qianwenaiapi.com/compatible-mode/v1",
"envKey": "QIANWEN_TOKEN_PLAN_API_KEY"
},
{
"id": "decision-model-preview",
"name": "[Token Plan Personal] decision-model-preview",
"baseUrl": "https://token-plan.maas.qianwenaiapi.com/compatible-mode/v1",
"envKey": "QIANWEN_TOKEN_PLAN_API_KEY"
}
]
},
"security": {
"auth": {
"selectedType": "openai"
}
},
"model": {
"name": "auto"
}
}
在团队管理中为成员分配席位并生成 Token Plan API Key,替换
YOUR_API_KEY。复制
{
"$version": 4,
"env": {
"QIANWEN_TOKEN_PLAN_TEAM_API_KEY": "YOUR_API_KEY"
},
"modelProviders": {
"openai": [
{
"id": "auto",
"name": "[Token Plan Team] auto",
"baseUrl": "https://token-plan.maas.qianwenaiapi.com/compatible-mode/v1",
"envKey": "QIANWEN_TOKEN_PLAN_TEAM_API_KEY"
},
{
"id": "qwen4-max",
"name": "[Token Plan Team] qwen4-max",
"baseUrl": "https://token-plan.maas.qianwenaiapi.com/compatible-mode/v1",
"envKey": "QIANWEN_TOKEN_PLAN_TEAM_API_KEY"
},
{
"id": "qwen4-max-preview",
"name": "[Token Plan Team] qwen4-max-preview",
"baseUrl": "https://token-plan.maas.qianwenaiapi.com/compatible-mode/v1",
"envKey": "QIANWEN_TOKEN_PLAN_TEAM_API_KEY"
},
{
"id": "qwen3.8-max",
"name": "[Token Plan Team] qwen3.8-max",
"baseUrl": "https://token-plan.maas.qianwenaiapi.com/compatible-mode/v1",
"envKey": "QIANWEN_TOKEN_PLAN_TEAM_API_KEY"
},
{
"id": "qwen3.8-flash",
"name": "[Token Plan Team] qwen3.8-flash",
"baseUrl": "https://token-plan.maas.qianwenaiapi.com/compatible-mode/v1",
"envKey": "QIANWEN_TOKEN_PLAN_TEAM_API_KEY"
},
{
"id": "qwen3.7-max",
"name": "[Token Plan Team] qwen3.7-max",
"baseUrl": "https://token-plan.maas.qianwenaiapi.com/compatible-mode/v1",
"envKey": "QIANWEN_TOKEN_PLAN_TEAM_API_KEY"
},
{
"id": "qwen3.7-plus",
"name": "[Token Plan Team] qwen3.7-plus",
"baseUrl": "https://token-plan.maas.qianwenaiapi.com/compatible-mode/v1",
"envKey": "QIANWEN_TOKEN_PLAN_TEAM_API_KEY"
},
{
"id": "qwen3.6-plus",
"name": "[Token Plan Team] qwen3.6-plus",
"baseUrl": "https://token-plan.maas.qianwenaiapi.com/compatible-mode/v1",
"envKey": "QIANWEN_TOKEN_PLAN_TEAM_API_KEY"
},
{
"id": "qwen3.6-flash",
"name": "[Token Plan Team] qwen3.6-flash",
"baseUrl": "https://token-plan.maas.qianwenaiapi.com/compatible-mode/v1",
"envKey": "QIANWEN_TOKEN_PLAN_TEAM_API_KEY"
},
{
"id": "qwen-image-2.0",
"name": "[Token Plan Team] qwen-image-2.0",
"baseUrl": "https://token-plan.maas.qianwenaiapi.com/compatible-mode/v1",
"envKey": "QIANWEN_TOKEN_PLAN_TEAM_API_KEY"
},
{
"id": "qwen-image-2.0-pro",
"name": "[Token Plan Team] qwen-image-2.0-pro",
"baseUrl": "https://token-plan.maas.qianwenaiapi.com/compatible-mode/v1",
"envKey": "QIANWEN_TOKEN_PLAN_TEAM_API_KEY"
},
{
"id": "qwen-image-3.0-pro",
"name": "[Token Plan Team] qwen-image-3.0-pro",
"baseUrl": "https://token-plan.maas.qianwenaiapi.com/compatible-mode/v1",
"envKey": "QIANWEN_TOKEN_PLAN_TEAM_API_KEY"
},
{
"id": "qwen-audio-3.0-tts-plus",
"name": "[Token Plan Team] qwen-audio-3.0-tts-plus",
"baseUrl": "https://token-plan.maas.qianwenaiapi.com/compatible-mode/v1",
"envKey": "QIANWEN_TOKEN_PLAN_TEAM_API_KEY"
},
{
"id": "qwen-audio-3.0-realtime-plus",
"name": "[Token Plan Team] qwen-audio-3.0-realtime-plus",
"baseUrl": "https://token-plan.maas.qianwenaiapi.com/compatible-mode/v1",
"envKey": "QIANWEN_TOKEN_PLAN_TEAM_API_KEY"
},
{
"id": "qwen-audio-3.0-asr-flash",
"name": "[Token Plan Team] qwen-audio-3.0-asr-flash",
"baseUrl": "https://token-plan.maas.qianwenaiapi.com/compatible-mode/v1",
"envKey": "QIANWEN_TOKEN_PLAN_TEAM_API_KEY"
},
{
"id": "wan2.7-image",
"name": "[Token Plan Team] wan2.7-image",
"baseUrl": "https://token-plan.maas.qianwenaiapi.com/compatible-mode/v1",
"envKey": "QIANWEN_TOKEN_PLAN_TEAM_API_KEY"
},
{
"id": "wan2.7-image-pro",
"name": "[Token Plan Team] wan2.7-image-pro",
"baseUrl": "https://token-plan.maas.qianwenaiapi.com/compatible-mode/v1",
"envKey": "QIANWEN_TOKEN_PLAN_TEAM_API_KEY"
},
{
"id": "wan3.0-video",
"name": "[Token Plan Team] wan3.0-video",
"baseUrl": "https://token-plan.maas.qianwenaiapi.com/compatible-mode/v1",
"envKey": "QIANWEN_TOKEN_PLAN_TEAM_API_KEY"
},
{
"id": "deepseek-v4.1-flash",
"name": "[Token Plan Team] deepseek-v4.1-flash",
"baseUrl": "https://token-plan.maas.qianwenaiapi.com/compatible-mode/v1",
"envKey": "QIANWEN_TOKEN_PLAN_TEAM_API_KEY"
},
{
"id": "deepseek-v4.1-flash-1017",
"name": "[Token Plan Team] deepseek-v4.1-flash-1017",
"baseUrl": "https://token-plan.maas.qianwenaiapi.com/compatible-mode/v1",
"envKey": "QIANWEN_TOKEN_PLAN_TEAM_API_KEY"
},
{
"id": "deepseek-v4-pro",
"name": "[Token Plan Team] deepseek-v4-pro",
"baseUrl": "https://token-plan.maas.qianwenaiapi.com/compatible-mode/v1",
"envKey": "QIANWEN_TOKEN_PLAN_TEAM_API_KEY"
},
{
"id": "deepseek-v4-pro-0813",
"name": "[Token Plan Team] deepseek-v4-pro-0813",
"baseUrl": "https://token-plan.maas.qianwenaiapi.com/compatible-mode/v1",
"envKey": "QIANWEN_TOKEN_PLAN_TEAM_API_KEY"
},
{
"id": "deepseek-v4-flash-0731",
"name": "[Token Plan Team] deepseek-v4-flash-0731",
"baseUrl": "https://token-plan.maas.qianwenaiapi.com/compatible-mode/v1",
"envKey": "QIANWEN_TOKEN_PLAN_TEAM_API_KEY"
},
{
"id": "kimi-k2.7-code",
"name": "[Token Plan Team] kimi-k2.7-code",
"baseUrl": "https://token-plan.maas.qianwenaiapi.com/compatible-mode/v1",
"envKey": "QIANWEN_TOKEN_PLAN_TEAM_API_KEY"
},
{
"id": "kimi-k2.6",
"name": "[Token Plan Team] kimi-k2.6",
"baseUrl": "https://token-plan.maas.qianwenaiapi.com/compatible-mode/v1",
"envKey": "QIANWEN_TOKEN_PLAN_TEAM_API_KEY"
},
{
"id": "kimi-k2.5",
"name": "[Token Plan Team] kimi-k2.5",
"baseUrl": "https://token-plan.maas.qianwenaiapi.com/compatible-mode/v1",
"envKey": "QIANWEN_TOKEN_PLAN_TEAM_API_KEY"
},
{
"id": "glm-5.3",
"name": "[Token Plan Team] glm-5.3",
"baseUrl": "https://token-plan.maas.qianwenaiapi.com/compatible-mode/v1",
"envKey": "QIANWEN_TOKEN_PLAN_TEAM_API_KEY"
},
{
"id": "glm-5.2",
"name": "[Token Plan Team] glm-5.2",
"baseUrl": "https://token-plan.maas.qianwenaiapi.com/compatible-mode/v1",
"envKey": "QIANWEN_TOKEN_PLAN_TEAM_API_KEY"
},
{
"id": "glm-5.1",
"name": "[Token Plan Team] glm-5.1",
"baseUrl": "https://token-plan.maas.qianwenaiapi.com/compatible-mode/v1",
"envKey": "QIANWEN_TOKEN_PLAN_TEAM_API_KEY"
},
{
"id": "glm-5",
"name": "[Token Plan Team] glm-5",
"baseUrl": "https://token-plan.maas.qianwenaiapi.com/compatible-mode/v1",
"envKey": "QIANWEN_TOKEN_PLAN_TEAM_API_KEY"
},
{
"id": "MiniMax-M2.5",
"name": "[Token Plan Team] MiniMax-M2.5",
"baseUrl": "https://token-plan.maas.qianwenaiapi.com/compatible-mode/v1",
"envKey": "QIANWEN_TOKEN_PLAN_TEAM_API_KEY"
},
{
"id": "happyhorse-1.1-i2v",
"name": "[Token Plan Team] happyhorse-1.1-i2v",
"baseUrl": "https://token-plan.maas.qianwenaiapi.com/compatible-mode/v1",
"envKey": "QIANWEN_TOKEN_PLAN_TEAM_API_KEY"
},
{
"id": "happyhorse-1.1-t2v",
"name": "[Token Plan Team] happyhorse-1.1-t2v",
"baseUrl": "https://token-plan.maas.qianwenaiapi.com/compatible-mode/v1",
"envKey": "QIANWEN_TOKEN_PLAN_TEAM_API_KEY"
},
{
"id": "happyhorse-1.1-r2v",
"name": "[Token Plan Team] happyhorse-1.1-r2v",
"baseUrl": "https://token-plan.maas.qianwenaiapi.com/compatible-mode/v1",
"envKey": "QIANWEN_TOKEN_PLAN_TEAM_API_KEY"
}
]
},
"security": {
"auth": {
"selectedType": "openai"
}
},
"model": {
"name": "auto"
}
}
在千问AI平台控制台获取 API Key,替换
YOUR_API_KEY。示例为最新模型,其他模型见支持的模型。复制
{
"$version": 4,
"env": {
"QIANWEN_API_KEY": "YOUR_API_KEY"
},
"modelProviders": {
"openai": [
{
"id": "qwen3.8-max",
"name": "[Qianwen AI Platform] qwen3.8-max",
"baseUrl": "https://maas.qianwenaiapi.com/compatible-mode/v1",
"envKey": "QIANWEN_API_KEY"
},
{
"id": "qwen3.7-plus",
"name": "[Qianwen AI Platform] qwen3.7-plus",
"baseUrl": "https://maas.qianwenaiapi.com/compatible-mode/v1",
"envKey": "QIANWEN_API_KEY"
},
{
"id": "qwen3.8-flash",
"name": "[Qianwen AI Platform] qwen3.8-flash",
"baseUrl": "https://maas.qianwenaiapi.com/compatible-mode/v1",
"envKey": "QIANWEN_API_KEY"
},
{
"id": "deepseek-v4-pro-0813",
"name": "[Qianwen AI Platform] deepseek-v4-pro-0813",
"baseUrl": "https://maas.qianwenaiapi.com/compatible-mode/v1",
"envKey": "QIANWEN_API_KEY"
},
{
"id": "deepseek-v4.1-flash",
"name": "[Qianwen AI Platform] deepseek-v4.1-flash",
"baseUrl": "https://maas.qianwenaiapi.com/compatible-mode/v1",
"envKey": "QIANWEN_API_KEY"
}
]
},
"security": {
"auth": {
"selectedType": "openai"
}
},
"model": {
"name": "qwen3.8-max"
}
}
env 中的变量名必须与模型条目的 envKey 一致;security.auth.selectedType 保持 openai,$version 保持 4。接入 CLI 工具
千问AI平台 CLI 安装时会把 Skill 注册到~/.qwen/skills/,Qwen Code 可在对话中调用平台能力。使用前请安装 Node.js 18+。
1
安装 CLI
复制
请帮我全局安装千问AI平台 CLI 命令行工具:npm install -g @qianwenai/qianwen-cli
2
配置 API Key
前往千问AI平台控制台获取 API Key,然后告诉 Qwen Code:
复制
配置我的 API Key 是:sk-xxxxxxxxxxxxx
API Key 为敏感凭证,请勿泄露。对话中粘贴明文 API Key 可能被会话记录留存,建议通过
settings.json 或环境变量配置。3
开始使用
复制
帮我生成 6 张亚马逊电商主图,产品是白色无线蓝牙耳机。
了解更多
更多命令、子智能体、MCP、Skills 和示例,见 Qwen Code 官方文档和官方示例。错误码
配置过程中遇到报错,参考对应计费方案的常见问题文档:- Token Plan:Token Plan 常见问题
- 按量计费:错误码
常见问题
配置完成后找不到想要的模型怎么办?
配置完成后找不到想要的模型怎么办?
按以下顺序处理:
- 升级 Qwen Code 到最新版本。
- 仍找不到时,在
~/.qwen/settings.json的modelProviders.openai中手动新增模型配置,然后重启 Qwen Code。配置方法见通过配置文件接入。
Windows 安装后无法识别 qwen 命令怎么办?
Windows 安装后无法识别 qwen 命令怎么办?
关闭并重新打开
cmd 使环境变量生效,再运行 qwen --version 确认安装。