# Roo Code 接入指南

Roo Code 是 VS Code 上的开源 AI 编程助手插件（由 Cline 衍生）。本文介绍如何让它通过 UModelverse 平台调用模型。

## **系统要求**

| 平台 | 要求 |
| --- | --- |
| Windows | Windows 10 或 Windows 11 |
| macOS | macOS 10.15 (Catalina) 或更高版本 |
| Linux | 主流发行版（Ubuntu、Debian 等） |

所有平台均需要：已安装 [VS Code](https://code.visualstudio.com/) 与网络连接。

## **1. 安装 Roo Code**

1.  打开 VS Code，进入左侧扩展市场（`Ctrl+Shift+X` / `Cmd+Shift+X`）。
    
2.  搜索 `Roo Code` 并安装。
    
3.  安装后在左侧活动栏点击 Roo Code 图标打开面板。
    

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

### 2.1 获取 API Key

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

### 2.2 在 Roo Code 中填写配置

打开 Roo Code 面板，进入设置，按下表填写：

![Roo Code 选择 OpenAI Compatible](https://cdnv2-cache.udelivrs.com/2026/06/228ef1d86224f459a89f574c47b85978_1781261163308.png)

![Roo Code 填写 Base URL、API Key 和模型](https://cdnv2-cache.udelivrs.com/2026/06/f0a7638802d8ff7f1931f3065d026aae_1781261163311.png)

| 项目 | 填写值 |
| --- | --- |
| API Provider | 选择 **OpenAI Compatible** |
| Base URL | `https://api.modelverse.cn/v1` |
| API Key | 您的 UModelverse [API Key](https://console.ucloud.cn/modelverse/api) |
| Model | UModelverse 平台[支持的模型](https://api.modelverse.cn/v1/models)之一，例如 `qwen3.7-max` |

保存后即可开始使用。

## **常见问题**

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

请逐项确认：

1.  API Key 来自 UModelverse 平台，复制完整且无空格。
    
2.  API Provider 选择的是 **OpenAI Compatible**，Base URL 为 `https://api.modelverse.cn/v1`。
    
3.  填写的模型是 UModelverse 平台[支持的模型](https://api.modelverse.cn/v1/models)之一，没有写错。