跳转到主要内容
接入AI工具

Qwen Code

在 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:
3

验证

qwen -p "你好"

通过配置文件接入

除了上述方式,也可以通过配置文件接入。
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"
  }
}
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 官方文档和官方示例。

错误码

配置过程中遇到报错,参考对应计费方案的常见问题文档:

常见问题

按以下顺序处理:
  1. 升级 Qwen Code 到最新版本。
  2. 仍找不到时,在 ~/.qwen/settings.json 的 modelProviders.openai 中手动新增模型配置,然后重启 Qwen Code。配置方法见通过配置文件接入。
关闭并重新打开 cmd 使环境变量生效,再运行 qwen --version 确认安装。