# Trae 接入指南

Trae 是字节跳动推出的 AI 编程 IDE，支持配置自定义模型。本文介绍如何让它通过 UModelverse 平台调用模型。

## **系统要求**

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

所有平台均需要网络连接。

## **1. 安装 Trae**

前往 [Trae 官网](https://www.trae.ai/) 下载并安装对应平台的客户端。

## **2. 获取 API Key**

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

## **3. 添加自定义模型**

UModelverse 走 OpenAI 兼容协议。

1.  打开 Trae 的对话窗口，点击模型选择器，选择 **添加模型** / **管理模型**。
    
2.  服务商选择 **OpenAI** 或 **自定义（OpenAI 兼容）**，按下表填写：
    

| 项目 | 填写值 |
| --- | --- |
| Base URL / 模型服务地址 | `https://api.modelverse.cn/v1` |
| API Key | 您的 UModelverse [API Key](https://console.ucloud.cn/modelverse/api) |
| 模型 ID / Model | UModelverse 平台[支持的模型](https://api.modelverse.cn/v1/models)之一，例如 `claude-sonnet-4-6` |

3.  保存后在模型选择器中选用该模型即可开始使用。
    

## **常见问题**

### 添加模型或请求失败？

请逐项确认：

1.  API Key 来自 UModelverse 平台，复制完整且无空格。
    
2.  Base URL 为 `https://api.modelverse.cn/v1`（带 `/v1` 后缀）。
    
3.  模型 ID 是 UModelverse 平台[支持的模型](https://api.modelverse.cn/v1/models)之一，名称完全一致。