Source: https://wiki.niceai.dev/guide/clients/roo-code

# Roo Code 接入自定义 API

在 Roo Code 设置中把 **API Provider** 选为 **OpenAI Compatible**，Base URL 填 `https://api.niceai.dev/v1`，并选择一个支持原生工具调用的模型。

## 准备工作

1. 在 VS Code 中安装 Roo Code 扩展。
2. 在 NiceAI 控制台「[API 密钥](https://niceai.dev/keys)」页面创建密钥，分组按所用模型选择，并确认支持 Chat Completions。

## 配置步骤

1. 打开 Roo Code 面板，点击设置图标。
2. **API Provider** 选择 **OpenAI Compatible**。
3. 填写：

| 设置项 | 填写内容 |
| --- | --- |
| Base URL | `https://api.niceai.dev/v1` |
| API Key | 你的 NiceAI 密钥 |
| Model | [模型广场](https://niceai.dev/model-plaza) 中的模型名 |

4. 在 **Model Configuration** 中设置上下文窗口、最大输出 token、是否支持图片。
5. 保存并发起一个简单任务验证。

**需要支持工具调用的模型**
根据 Roo Code 官方文档，它只使用原生工具调用（OpenAI tools 格式），没有 XML 回退。不支持工具调用的模型无法在 Roo Code 中使用。


## 常见问题

### 报 Invalid API Key 或 Model Not Found？

核对密钥、分组和模型名，模型名以模型广场为准。

### 连接失败或 404？

Base URL 要带 `/v1`。详见 [接口地址要不要加 /v1](https://wiki.niceai.dev/guide/v1-404)。

### 工具调用失败？

换用支持 function calling 的模型；仍有问题时，可以先在 [Cline](https://wiki.niceai.dev/guide/clients/cline) 或 curl 中测试同一个模型。

## 下一步

- [Continue 接入](https://wiki.niceai.dev/guide/clients/continue)
- [常见错误码对照](https://wiki.niceai.dev/guide/error-codes)
