AI 助理
备案控制台
官方文档
输入文档关键字查找
首页 大模型服务平台百炼 用户指南（模型） 接入客户端/开发工具 Qwen Code

Qwen Code

更新时间：
产品详情
我的收藏

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

操作步骤

获取阿里云百炼API Key

如果您是首次访问阿里云百炼服务平台，请按照以下步骤进行开通。

  1. 登录阿里云百炼大模型服务平台。

  2. 如果页面顶部显示image，您需要开通阿里云百炼的模型服务，并获得免费额度。如果未显示该消息，则表示您已经开通。

    如果开通服务时提示“您尚未进行实名认证”，请先进行个人实名认证。

说明

首次开通百炼后，您可领取新人免费额度（有效期：30至180天），用于模型推理服务。超出额度或期限将产生费用，具体费用请以控制台的实际报价和最终账单为准。免费额度领取方法和详情，请查看新人免费额度页面。

  1. 通过阿里云百炼获取API Key。

选择模型

Qwen Code 专为 Qwen3-Coder 系列模型优化，且支持 OpenAI 兼容接口的模型，包括通义千问Max、通义千问Plus、通义千问Flash和DeepSeek等。其中 qwen3-coder-plus 模型于2025年7月23日20:00起开启限时优惠，推荐使用。

安装与配置 Qwen Code

  1. Node.js 版本检查

    Qwen Code 需要 Node.js 20 或更高版本，运行 node -v 检查版本，若低于 20，请重新安装。

  2. 安装 Qwen Code

    在终端中执行以下任一命令来安装 Qwen Code。

    npm 安装（推荐）

    # 配置镜像源加速
npm config set registry https://registry.npmmirror.com
npm install -g @qwen-code/qwen-code@latest

    源码安装

    git clone https://github.com/QwenLM/qwen-code.git
cd qwen-code
npm install
npm install -g .

  3. 启动并配置 Qwen Code

    1. 启动 Qwen Code

      在终端中输入qwen以启动 Qwen Code。

    2. 选择认证方式

      此处以 OpenAI 认证方式为例。选中 OpenAI，单击 Enter 后通过阿里云百炼提供的 OpenAI 兼容认证方式接入。

      image.png

      在页面填入以下信息：

      配置项

      说明

      image

      API Key

      阿里云百炼 API Key

      Base URL

      https://dashscope.aliyuncs.com/compatible-mode/v1

      Model

      模型名。建议选择代码能力较强的模型，如：

      • qwen3-coder-plus

      • qwen3-coder-480b-a35b-instruct

      • qwen3-coder-flash

      • qwen3-coder-30b-a3b-instruct

      若您不想每次启动后都输入以上信息，请参见下文配置环境变量。

      配置环境变量

      可配置全局环境变量，或通过.env文件配置。同时配置时，全局环境变量优先于.env文件配置生效。

      .env文件

      在项目根目录下创建.env文件，写入以下内容并保存。环境变量将仅在当前项目中生效。

      # 用您的百炼API KEY代替YOUR_DASHSCOPE_API_KEY
OPENAI_API_KEY="YOUR_DASHSCOPE_API_KEY"
OPENAI_BASE_URL="https://dashscope.aliyuncs.com/compatible-mode/v1"
# 此处以qwen3-coder-plus模型为例，您可按需更换其他模型 
OPENAI_MODEL="qwen3-coder-plus"

      全局环境变量

      将阿里云百炼提供的 API Key 、 Base URL 和 Model 设置为全局环境变量。环境变量将对所有项目和终端会话生效。

      macOS

      1. 在终端中执行以下命令，查看默认 Shell 类型。

        echo $SHELL

      2. 根据 Shell 类型设置环境变量，命令如下：

        Zsh

        # 用您的百炼API KEY代替YOUR_DASHSCOPE_API_KEY
# 这里以qwen3-coder-plus模型为例，您可以根据需要更换其他模型 
echo 'export OPENAI_API_KEY="YOUR_DASHSCOPE_API_KEY"' >> ~/.zshrc
echo 'export OPENAI_BASE_URL="https://dashscope.aliyuncs.com/compatible-mode/v1"' >> ~/.zshrc
echo 'export OPENAI_MODEL="qwen3-coder-plus"' >> ~/.zshrc

        Bash

        # 用您的百炼API KEY代替YOUR_DASHSCOPE_API_KEY 
# 这里以qwen3-coder-plus模型为例，您可以根据需要更换其他模型 
echo 'export OPENAI_API_KEY="YOUR_DASHSCOPE_API_KEY"' >> ~/.bash_profile
echo 'export OPENAI_BASE_URL="https://dashscope.aliyuncs.com/compatible-mode/v1"' >> ~/.bash_profile
echo 'export OPENAI_MODEL="qwen3-coder-plus"' >> ~/.bash_profile

      3. 在终端中执行下列命令，使环境变量生效。

        Zsh

        source ~/.zshrc

        Bash

        source ~/.bash_profile

      Windows

      CMD

      1. 在CMD中运行以下命令，设置环境变量。

        # 用您的百炼API Key代替YOUR_DASHSCOPE_API_KEY
# 这里以qwen3-coder-plus模型为例，您可以根据需要更换其他模型 
setx OPENAI_API_KEY "YOUR_API_KEY"
setx OPENAI_BASE_URL "https://dashscope.aliyuncs.com/compatible-mode/v1"
setx OPENAI_MODEL "qwen3-coder-plus"

      2. 打开一个新的CMD窗口，运行以下命令，检查环境变量是否生效。

        echo %ANTHROPIC_AUTH_TOKEN%
echo %ANTHROPIC_BASE_URL%

      PowerShell

      1. 在PowerShell中运行以下命令，设置环境变量。

        # 用您的百炼API Key代替YOUR_DASHSCOPE_API_KEY
[Environment]::SetEnvironmentVariable("OPENAI_API_KEY", "YOUR_DASHSCOPE_API_KEY", [EnvironmentVariableTarget]::User)
[Environment]::SetEnvironmentVariable("OPENAI_BASE_URL", "https://dashscope.aliyuncs.com/compatible-mode/v1", [EnvironmentVariableTarget]::User)
[Environment]::SetEnvironmentVariable("OPENAI_MODEL", "qwen3-coder-plus", [EnvironmentVariableTarget]::User)

      2. 打开一个新的PowerShell窗口，运行以下命令，检查环境变量是否生效。

        echo $env:OPENAI_API_KEY
echo $env:OPENAI_BASE_URL
echo $env:OPENAI_MODEL

向 Qwen Code 提问

在对话框中输入“如何用python实现一个二叉搜索树？”Qwen Code 会申请创建文件、写入文件和执行文件等操作。

image

效果如下图所示：

image

查看 Token 消耗

输入/stats model查看本次启动 Qwen Code 后的 Token 消耗与 API 调用次数。

image.png

免费额度

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

image.png

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

进阶操作

更多 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：根据是否配置环境变量选择操作：

  • 未配置环境变量

    1. 输入/quit退出 Qwen Code；

    2. 输入 qwen启动，选择 OpenAI 认证方式，输入API Key、Base URL 与目标模型名称。

  • 已配置环境变量

    1. 参见配置环境变量，修改OPENAI_MODEL环境变量为目标模型并使其生效；

    2. 输入/quit退出 Qwen Code，输入qwen启动即可。

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

A：启动 Qwen Code 后输入/auth，选中 Qwen Oauth，单击 Enter 后通过 Qwen Chat 认证方式接入。在跳转界面登录 Qwen Chat 账号，或扫描二维码进行验证，完成后即可每天免费调用 2000 次 qwen3-coder-plus 模型 API。

超过 2000 次 API 调用后如需继续使用，请通过/auth 切换为 OpenAI 认证方式。
若首次使用 Qwen Chat，请注册账号。
该认证方式无法切换模型。

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

A：可能是 API 配置错误，请对比错误信息中的API Key与设置是否一致。全局环境变量配置优先于环境文件配置。如果需要启用环境文件配置，请确保未设置相关环境变量，或临时清除它们。

更多问题请参见 Qwen Code 故障排查文档。

上一篇：Claude Code下一篇：Cline