# Qwen Code 接入指南

Qwen Code 是阿里云开源的终端 AI 编程工具，支持代码理解、自动化任务与多 IDE 集成（VS Code、JetBrains、Zed）。本文介绍如何让它通过 UModelverse 平台调用模型。

## **1. 安装 Qwen Code**

### macOS（推荐使用 Homebrew）

```bash
brew install qwen-code
```

### npm（跨平台，需 Node.js 22+）

```bash
npm install -g @qwen-code/qwen-code@latest
```

### Linux/macOS 一键安装

```bash
curl -fsSL https://qwen-code-assets.oss-cn-hangzhou.aliyuncs.com/installation/install-qwen-standalone.sh | bash
```

安装后验证：

```bash
qwen --version
```

## **2. 配置 UModelverse API**

### 2.1 获取 API Key

访问 [UModelverse 控制台](https://console.ucloud.cn/modelverse/api) 获取您的 API 密钥。可用模型见 UModelverse 平台[支持的模型](https://api.modelverse.cn/v1/models)。

### 2.2 写入配置文件

编辑 `~/.qwen/settings.json`，写入以下内容（将 `YOUR_API_KEY` 替换为实际 Key，`MODEL_ID` 替换为 UModelverse 平台[支持的模型](https://api.modelverse.cn/v1/models)之一）：

```json
{
  "env": {
    "MODELVERSE_API_KEY": "YOUR_API_KEY"
  },
  "modelProviders": {
    "openai": [
      {
        "id": "MODEL_ID",
        "name": "MODEL_ID",
        "baseUrl": "https://api.modelverse.cn/v1",
        "envKey": "MODELVERSE_API_KEY"
      }
    ]
  },
  "security": {
    "auth": {
      "selectedType": "openai"
    }
  },
  "model": {
    "name": "MODEL_ID"
  }
}
```

## **3. 启动 Qwen Code**

配置完成后，进入项目目录启动：

```bash
cd your-project-folder
qwen
```

在交互界面中使用 `/model` 命令可随时切换模型。

## **常见问题**

### 提示认证失败或无法连接？

请逐项确认：

1.  `env.MODELVERSE_API_KEY` 来自 UModelverse 平台，复制完整且无空格。

2.  `baseUrl` 为 `https://api.modelverse.cn/v1`（带 `/v1` 后缀）。

3.  `id` 和 `model.name` 填写的是 UModelverse 平台[支持的模型](https://api.modelverse.cn/v1/models)之一，名称完全一致。