Qwen Code
Qwen Code 是阿里推出的命令行 AI 编程助手，通过配置可接入云知声Maas平台上的 AI 模型，支持按量付费/模型资源包、Token Plan 两种接入方式。
一、通用准备
在接入 AI 工具前，请先完成以下准备工作。
1.获取 API Key
平台支持按量付费/模型资源包、Token Plan 两种计费方式，对应的凭证获取方式不同：
- Base URL OpenAI 兼容协议：https://maas-api.unisound.com/v1 Anthropic 兼容协议：https://maas-api.unisound.com/anthropic
- API Key
- 格式：sk-xxxxx
前往 API Key 管理 创建 API Key
- Base URL OpenAI 兼容协议：https://maas-api.unisound.com/v1 Anthropic 兼容协议：https://maas-api.unisound.com/anthropic
- API Key
- 格式：tp-xxxxx
成功订阅Token Plan 后，前往 订阅管理 获取专属 API Key
按量付费支持使用所有模态模型，包括文本、语音、视觉等。
Token Plan Key 用于 Token Plan 额度。它可以在付费资源可用之前就存在；当您拥有 Token Plan Credits 时才可实际使用资源。详情见 Token Plan 订阅概要。
二、安装 Qwen Code
- 安装或更新 Node.js（v22.19 或更高版本）。
- 在终端中执行下列命令，安装 Qwen Code。
npm.cmd install -g @qwen-code/qwen-code@latest运行以下命令验证安装。若有版本号输出，则表示安装成功。
qwen --version三、配置目标模型
方式一：编辑配置文件（推荐）
编辑或新建 ~/.qwen/settings.json（Windows 路径：C:\Users\<用户名>\.qwen\settings.json），写入以下配置，保存后无需登录即可直接使用。
将 UNISOUND_API_KEY 替换为你的 API Key，将 '<'MODEL_ID'>' 替换为目标模型的 Model ID。
{
"modelProviders": {
"openai": [
{
"id": "<MODEL_ID>",
"name": "<MODEL_ID>",
"baseUrl": "https://maas-api.unisound.com/v1"
}
]
},
"env": {
"OPENAI_API_KEY": "UNISOUND_API_KEY"
},
"security": {
"auth": {
"selectedType": "openai"
}
},
"model": {
"name": "<MODEL_ID>"
}
}其中 model.name 必须与 modelProviders 中的 id 一致，作为启动时的默认模型；API Key 由 env 中的 OPENAI_API_KEY 提供，也可通过同名环境变量设置。
然后输入：
setx UNISOUND_API_KEY "UNISOUND_API_KEY"比如：
setx UNISOUND_API_KEY "sk-xxxxxxxx"执行完之后，启动 Qwen Code：
qwen方式二：环境变量配置
在终端中设置以下环境变量：
macOS/Linux：
export OPENAI_API_KEY="UNISOUND_API_KEY"
export OPENAI_BASE_URL="https://maas-api.unisound.com/v1"
export OPENAI_MODEL="u2-flash"Windows：
$env:OPENAI_API_KEY = "UNISOUND_API_KEY"
$env:OPENAI_BASE_URL = "https://maas-api.unisound.com/v1"
$env:OPENAI_MODEL = "u2-flash"可将上述命令写入 ~/.bashrc 或 ~/.zshrc（Windows 可设置为系统环境变量），使配置持久生效。
API Key 的获取方式与 Key 格式参见通用准备。
配置完成后，进入项目目录执行 qwen 启动。启动以后，输入 /model 可查看和切换使用的模型。
四、快速接入能力模型
我们预置 U2-ASR、U2-TTS、U2-TTS-Clone、U1-OCR 模型能力，只需在 Qwen Code 中添加对应模型 Skill，即可快速调用相关模型服务，无需单独对接各类模型 API 接口。
点击下方链接跳转至对应skill页面，可通过对话或命令行安装skill，安装完成后，skill将会引导您进行相关模型的配置。