Qwen Code - Alibaba Cloud Model Studio

应用场景

Qwen Code 支持以下使用场景：

AI 编程辅助：在终端通过自然语言完成代码生成、代码补全与代码审查，提升日常开发效率。
Web 开发：提供目标网站截图，Qwen Code 自动解析页面结构并生成高还原度的前端代码。
视频制作：给定开源项目仓库地址，一键生成专属宣传视频。

安装 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。
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\<Windows用户名>\.qwen\settings.json

关键字段说明：env 用于定义存放 API Key 的环境变量，模型条目中的 envKey 需与该环境变量名保持一致；generationConfig.extra_body.enable_thinking 用于开启或关闭模型思考模式；部分示例中的 $version 为配置文件格式版本号，请保留默认值。完整字段以 Qwen Code 产品文档为准。

{
  "env": {
    "BAILIAN_TOKEN_PLAN_API_KEY": "YOUR_API_KEY"
  },
  "modelProviders": {
    "openai": [
      {
        "id": "qwen3.8-max",
        "name": "[Token Plan 个人版] qwen3.8-max",
        "baseUrl": "https://token-plan.ap-southeast-1.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.ap-southeast-1.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.ap-southeast-1.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.ap-southeast-1.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.ap-southeast-1.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.ap-southeast-1.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.ap-southeast-1.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.ap-southeast-1.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.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1",
        "envKey": "BAILIAN_TOKEN_PLAN_API_KEY"
      }
    ]
  }
}

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\<Windows用户名>\.qwen\settings.json

{
  "env": {
    "BAILIAN_TOKEN_PLAN_API_KEY": "YOUR_API_KEY"
  },
  "modelProviders": {
    "openai": [
      {
        "id": "qwen3.8-max",
        "name": "[Token Plan 团队版] qwen3.8-max",
        "baseUrl": "https://token-plan.ap-southeast-1.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.ap-southeast-1.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.ap-southeast-1.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.ap-southeast-1.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.ap-southeast-1.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.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1",
        "envKey": "BAILIAN_TOKEN_PLAN_API_KEY",
        "generationConfig": {
          "extra_body": {
            "enable_thinking": true
          }
        }
      },
      {
        "id": "deepseek-v4-pro",
        "name": "[Token Plan 团队版] deepseek-v4-pro",
        "baseUrl": "https://token-plan.ap-southeast-1.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.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1",
        "envKey": "BAILIAN_TOKEN_PLAN_API_KEY"
      },
      {
        "id": "deepseek-v4-flash",
        "name": "[Token Plan 团队版] deepseek-v4-flash",
        "baseUrl": "https://token-plan.ap-southeast-1.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.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1",
        "envKey": "BAILIAN_TOKEN_PLAN_API_KEY"
      },
      {
        "id": "deepseek-v3.2",
        "name": "[Token Plan 团队版] deepseek-v3.2",
        "baseUrl": "https://token-plan.ap-southeast-1.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.ap-southeast-1.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.ap-southeast-1.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.ap-southeast-1.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.ap-southeast-1.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.ap-southeast-1.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.ap-southeast-1.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.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1",
        "envKey": "BAILIAN_TOKEN_PLAN_API_KEY"
      }
    ]
  },
  "security": {
    "auth": {
      "selectedType": "openai"
    }
  },
  "tokenPlan": {
    "region": "global"
  },
  "model": {
    "name": "qwen3.8-max"
  },
  "$version": 3
}

Coding Plan

启动 Qwen Code 后输入 /auth，依次选择 订阅计划 > 阿里云百炼 Coding Plan，选择 Coding Plan 区域（global），输入 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\<Windows用户名>\.qwen\settings.json

{
  "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-intl.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-intl.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-intl.dashscope.aliyuncs.com/v1",
        "envKey": "BAILIAN_CODING_PLAN_API_KEY",
        "generationConfig": {
          "extra_body": {
            "enable_thinking": true
          }
        }
      },
      {
        "id": "qwen3-max-2026-01-23",
        "name": "[Bailian Coding Plan] qwen3-max-2026-01-23",
        "baseUrl": "https://coding-intl.dashscope.aliyuncs.com/v1",
        "envKey": "BAILIAN_CODING_PLAN_API_KEY"
      },
      {
        "id": "qwen3-coder-next",
        "name": "[Bailian Coding Plan] qwen3-coder-next",
        "baseUrl": "https://coding-intl.dashscope.aliyuncs.com/v1",
        "envKey": "BAILIAN_CODING_PLAN_API_KEY"
      },
      {
        "id": "qwen3-coder-plus",
        "name": "[Bailian Coding Plan] qwen3-coder-plus",
        "baseUrl": "https://coding-intl.dashscope.aliyuncs.com/v1",
        "envKey": "BAILIAN_CODING_PLAN_API_KEY"
      },
      {
        "id": "MiniMax-M2.5",
        "name": "[Bailian Coding Plan] MiniMax-M2.5",
        "baseUrl": "https://coding-intl.dashscope.aliyuncs.com/v1",
        "envKey": "BAILIAN_CODING_PLAN_API_KEY"
      },
      {
        "id": "glm-5",
        "name": "[Bailian Coding Plan] glm-5",
        "baseUrl": "https://coding-intl.dashscope.aliyuncs.com/v1",
        "envKey": "BAILIAN_CODING_PLAN_API_KEY",
        "generationConfig": {
          "extra_body": {
            "enable_thinking": true
          }
        }
      },
      {
        "id": "glm-4.7",
        "name": "[Bailian Coding Plan] glm-4.7",
        "baseUrl": "https://coding-intl.dashscope.aliyuncs.com/v1",
        "envKey": "BAILIAN_CODING_PLAN_API_KEY"
      },
      {
        "id": "kimi-k2.5",
        "name": "[Bailian Coding Plan] kimi-k2.5",
        "baseUrl": "https://coding-intl.dashscope.aliyuncs.com/v1",
        "envKey": "BAILIAN_CODING_PLAN_API_KEY",
        "generationConfig": {
          "extra_body": {
            "enable_thinking": true
          }
        }
      }
    ]
  },
  "security": {
    "auth": {
      "selectedType": "openai"
    }
  },
  "codingPlan": {
    "region": "global"
  },
  "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\<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

{
  "env": {
    "BAILIAN_API_KEY": "YOUR_API_KEY"
  },
  "modelProviders": {
    "openai": [
      {
        "id": "qwen3.6-plus",
        "name": "[Bailian] qwen3.6-plus",
        "baseUrl": "https://{WorkspaceId}.ap-southeast-1.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，即可开始对话。

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 桌面版

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 官方文档。

了解更多

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。

​应用场景

​安装 Qwen Code

​配置接入凭证

​Token Plan 个人版

​Token Plan 团队版

​Coding Plan

​按量计费

​验证配置

​Qwen Code IDE 插件

​VS Code

​JetBrains IDE

​Qwen Code 桌面版

​常见命令

​了解更多

​常见问题

​错误码

​如何切换模型？

应用场景

安装 Qwen Code

配置接入凭证

Token Plan 个人版

Token Plan 团队版

Coding Plan

按量计费

验证配置

Qwen Code IDE 插件

VS Code

JetBrains IDE

Qwen Code 桌面版

常见命令

了解更多

常见问题

错误码

如何切换模型？