Qwen3-Code 免费使用指南：配置 ModelScope API 与 Qwen CLI

近期，新的代码生成模型 Qwen3-Code 在开发者社区中引起了广泛关注。然而，部分开发者在使用其 API 服务时，遇到了意想不到的成本问题。有开发者反馈，在编写少量代码后便遭遇了 API 使用额度超限的问题，并产生了意外的费用。甚至有案例显示，单次代码提交就导致了上百元的账单，这种“代码没写多少，账单先来报到”的情况，无疑给开发者带来了困扰。

幸运的是，魔塔社区（ModelScope）为这一问题提供了解决方案。ModelScope 是一个由阿里巴巴推出的开源模型社区，旨在促进 AI 模型的交流与应用。该平台为众多模型提供了免费的推理 API 调用额度，其中就包括 Qwen3-Code，每日的免费额度高达2000次，这对于大多数开发和测试场景而言已相当充足。

下面将介绍如何通过 ModelScope 免费使用 Qwen3-Code 并结合 Qwen CLI 工具进行开发。

获取免费API凭证

首先，在 ModelScope 社区网站上搜索并进入 Qwen3-Code 的模型页面，在页面中可以找到“查看代码示范”的选项。

点击后，示例代码中会提供三项核心信息：base_url、api_key 和 model。

from openai import OpenAI
client = OpenAI(
base_url='https://api-inference.modelscope.cn/v1/',
api_key='YOUR_MS_API_KEY', # 替换为你自己的ModelScope Token
# ModelScope Token, 示例: ms-4c51dab7-2022-4f56-a009-13adb22
)
response = client.chat.completions.create(
model='Qwen/Qwen3-Coder-480B-A35B-Instruct', # ModelScope Model-Id
messages=[
{
'role': 'system',
'content': 'You are a helpful assistant.'
},
{
'role': 'user',
'content': '你好'
}
],
stream=True
)
for chunk in response:
print(chunk.choices.delta.content, end='', flush=True)

API Key 需要用户登录 ModelScope 账户后才能生成和查看。此外，使用 ModelScope 的推理服务必须先在后台管理页面绑定有效的阿里云账号。

如果未完成绑定，调用 API 时会收到如下错误提示：

{"errors":{"message":"Please bind your Alibaba Cloud account before use."},"request_id":"774509ee-a256-406b-b00d-900"}

配置 Qwen CLI 工具

完成 API 凭证的准备工作后，即可开始配置 Qwen CLI。Qwen CLI 是一个命令行工具，它允许开发者在终端中与 Qwen 模型进行交互，实现快速的代码生成与补全。

首先，全局安装 Qwen CLI：

npm i -g @qwen-code/qwen-code

安装成功后，执行以下命令启动工具：

qwen

接下来，配置环境变量，将 ModelScope 提供的免费 API 信息提供给 Qwen CLI。

# API 密钥
export OPENAI_API_KEY="YOUR_MS_API_KEY"
# API 基础 URL
export OPENAI_BASE_URL="https://api-inference.modelscope.cn/v1/"
# 模型名称
export OPENAI_MODEL="Qwen/Qwen3-Coder-480B-A35B-Instruct"

如果配置过程中出现错误或需要重置，可以直接删除用户主目录下的 .qwen 配置文件，然后重新进行配置。

为开发者提供免费的 API 调用额度，是一种明智的生态策略。它不仅能显著降低开发者的入门门槛和使用成本，还能激发更广泛的社区参与和创新，最终促进模型生态的繁荣。