Qwen Code - 大模型服务平台百炼

Qwen Code 是一款专为 Qwen3-Coder 模型优化的命令行 AI 工作流工具，通过先进的代码理解能力、自动化任务和智能辅助功能，显著提升开发效率。

安装 Qwen Code

macOS/Linux

在终端执行以下命令安装Qwen Code（版本 ≥ 0.11.1 ）。

bash -c "$(curl -fsSL https://qwen-code-assets.oss-cn-hangzhou.aliyuncs.com/installation/install-qwen.sh)" -s --source bailian

查看当前安装版本：

qwen --version

Windows

以管理员身份打开 CMD
在任务栏搜索框里输入CMD，选择以管理员身份运行。

运行安装命令

在CMD中运行以下命令安装 Qwen Code（版本 ≥ 0.11.1 ）。

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

查看Qwen Code的版本
安装完成后，关闭当前CMD窗口，以使环境变量生效。重新打开一个新的CMD窗口，并运行以下命令，查看当前安装版本。
```
qwen --version
```

配置 Qwen Code

编辑或新建 settings.json 文件，写入下面的内容并保存，请将 YOUR_API_KEY 替换为阿里云百炼API Key，具体路径如下：

macOS / Linux: ~/.qwen/settings.json
Windows: C:\Users\您的用户名\.qwen\settings.json

重要

本文档仅适用于按量付费模式，Coding Plan 用户请使用专属 Base URL 和 API Key 接入，详情请参考Qwen Code Coding Plan说明文档进行配置。

{
  "env": {
    "BAILIAN_API_KEY": "YOUR_API_KEY"
  },
  "modelProviders": {
    "openai": [
      {
        "id": "qwen3.5-plus",
        "name": "[Bailian] qwen3.5-plus",
        "baseUrl": "https://dashscope-intl.aliyuncs.com/compatible-mode/v1",
        "envKey": "BAILIAN_API_KEY",
        "generationConfig": {
          "extra_body": {
            "enable_thinking": true
          }
        }
      },
      {
        "id": "qwen3-coder-plus",
        "name": "[Bailian] qwen3-coder-plus",
        "baseUrl": "https://dashscope-intl.aliyuncs.com/compatible-mode/v1",
        "envKey": "BAILIAN_API_KEY"
      },
      {
        "id": "qwen3-coder-next",
        "name": "[Bailian] qwen3-coder-next",
        "baseUrl": "https://dashscope-intl.aliyuncs.com/compatible-mode/v1",
        "envKey": "BAILIAN_API_KEY"
      }
    ]
  },
  "security": {
    "auth": {
      "selectedType": "openai"
    }
  },
  "model": {
    "name": "qwen3.5-plus"
  },
  "$version": 3
}

配置项	说明
modelProviders	（必选）设置为`openai`。Qwen Code 专为 Qwen3-Coder 系列模型优化，并支持提供 OpenAI 兼容、Anthropic 或 Google GenAI 协议的模型，包括千问Max、千问Plus、千问Flash、DeepSeek、Kimi和GLM等，此处以 OpenAI 兼容协议接入。
id	（必选）模型的ID。建议选择代码能力较强的模型，如：qwen3.5-plus、glm-5、kimi-k2.5 各模式支持的模型请参见模型列表，部分模型（如glm-5）仅支持中国内地部署模式（北京地域）。
name	（可选）模型的显示名称，默认与id一致。
envKey	（必选）API Key 读取的环境变量，设置为 `BAILIAN_API_KEY`。
baseUrl	（必选）服务地址，需要与API Key 所属地域一致：新加坡地域：`https://dashscope-intl.aliyuncs.com/compatible-mode/v1` 弗吉尼亚地域：`https://dashscope-us.aliyuncs.com/compatible-mode/v1` 北京地域：`https://dashscope.aliyuncs.com/compatible-mode/v1`
generationConfig.extra_body.enable_thinking	（可选）是否开启深度思考。

更多 modelProviders 配置选项请参见 Qwen Code 配置文档。

使用 Qwen Code

在终端中输入qwen以启动 Qwen Code。在对话框中输入“如何用python实现一个二叉搜索树？”Qwen Code 会进行规划，并申请创建文件、写入文件和执行文件等操作。

效果如下图所示：

20251126192625

常见命令

命令	说明	示例
`/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 官方文档。

免费额度

阿里云百炼对 Qwen3-Coder 等模型各提供 100 万 Token 的免费额度（仅新加坡地域）。系统会优先消耗模型的免费额度，查询剩余额度请前往模型广场并单击模型卡片。为避免额外消费，可开启免费额度用完即停按钮。

用完即停

除了阿里云百炼的免费额度，Qwen Code 还提供了每天 1000 次的免费额度。

了解更多

Qwen Code 的子智能体、MCP、Skills等高级功能，请参见 Qwen Code 官方文档。
Qwen Code 的使用案例，请参见使用案例。

常见问题

Q：Qwen Code 为什么 Token 消耗快？

A：Qwen Code 可能多次调用 API，从而消耗大量 Token。请参考以下方法控制 Token 消耗：

精简工作目录
建议在具体的项目目录下启动，启动目录（如根目录）中过多的文件会增加 Token 消耗。
设置 Token 限额
在项目的根目录中创建 .qwen/settings.json 文件并重启 Qwen Code，通过sessionTokenLimit控制单次 API 调用的 Token 使用量：
```
{
  "sessionTokenLimit": 32000
}
```
Qwen Code 可能多次调用 API，使得单个问题的 Token 消耗量大于sessionTokenLimit值。
使用压缩/清理指令
输入以下命令可减少 Token 消耗：
- /compress
  压缩对话历史，以便在 Token 限制内继续对话。
- /clear
  清除所有对话历史并重新开始。

Q：如何切换模型？

A：在 Qwen Code 中直接输入 /model 命令，即可从 settings.json 中已配置的模型列表中选择切换。如需添加新模型，请在 settings.json 的 modelProviders 中添加对应配置，然后重启 Qwen Code。

Q：如何使用每天 1000 次的免费额度？

A：启动 Qwen Code 后输入/auth，选择 Qwen Oauth 认证方式，单击 Enter 后通过 Qwen Chat认证方式接入。在跳转界面登录 Qwen Chat 账号，或扫描二维码进行验证，完成后即可每天免费调用 1000 次模型 API，该免费额度与阿里云百炼免费额度独立。

超过 1000 次 API 调用后如需继续使用，请通过/auth 切换为 OpenAI 认证方式。

若首次使用 Qwen Chat，请注册账号。

Q：为什么报 401 Incorrect API key provided 错误？

A：可能是 API 配置错误，请对比错误信息中的API Key与设置是否一致，配置文件存在优先级顺序，如项目配置文件会覆盖用户配置文件。更多问题请参见 Qwen Code 故障排查文档。