# Roo Code Integration Guide

Roo Code is an open-source AI coding assistant plugin for VS Code (derived from Cline). This guide explains how to configure it to call models through the UModelverse platform.

## **System Requirements**

| Platform | Requirements |
| --- | --- |
| Windows | Windows 10 or Windows 11 |
| macOS | macOS 10.15 (Catalina) or later |
| Linux | Major distributions (Ubuntu, Debian, etc.) |

All platforms require: [VS Code](https://code.visualstudio.com/) installed and a network connection.

## **1. Install Roo Code**

1.  Open VS Code and go to the Extensions marketplace on the left sidebar (`Ctrl+Shift+X` / `Cmd+Shift+X`).
    
2.  Search for `Roo Code` and install it.
    
3.  After installation, click the Roo Code icon in the left Activity Bar to open the panel.
    

## **2. Configure the UModelverse API**

### 2.1 Obtain an API Key

Visit the [UModelverse Console](https://console.ucloud.cn/modelverse/api) to retrieve your API key. For available models, see the [supported models](https://api-us-ca.umodelverse.ai/v1/models) on the UModelverse platform.

### 2.2 Fill in the Configuration in Roo Code

Open the Roo Code panel, go to Settings, and fill in the fields as shown in the table below:

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

![Roo Code: fill in Base URL, API Key and Model](https://cdnv2-cache.udelivrs.com/2026/06/f0a7638802d8ff7f1931f3065d026aae_1781261163311.png)

| Field | Value |
| --- | --- |
| API Provider | Select **OpenAI Compatible** |
| Base URL | `https://api-us-ca.umodelverse.ai/v1` |
| API Key | Your UModelverse [API Key](https://console.ucloud.cn/modelverse/api) |
| Model | One of the [supported models](https://api-us-ca.umodelverse.ai/v1/models) on the UModelverse platform, e.g. `qwen3.7-max` |

After saving, you can start using it.

## **Frequently Asked Questions**

### Authentication failure or unable to connect?

Please verify each of the following:

1.  The API Key is from the UModelverse platform, copied in full with no extra spaces.
    
2.  The API Provider is set to **OpenAI Compatible** and the Base URL is `https://api-us-ca.umodelverse.ai/v1`.
    
3.  The model name entered is one of the [supported models](https://api-us-ca.umodelverse.ai/v1/models) on the UModelverse platform, with no typos.