首页 / 文档 / Cline 与 Roo Code

用 OpenAI Compatible 将 Cline / Roo Code 接入 MonkeyAI。

两个扩展的核心字段相同:OpenAI Compatible、Base URL、API Key 和 Model ID。先在客户端外验证 API,再填写账号真实可见的模型。

ProviderOpenAI Compatible
Base URL必须包含 /v1
Model ID从 /models 复制
Roo Code要求原生工具调用

官方文档确认的字段

字段ClineRoo CodeMonkeyAI 填写值
API ProviderOpenAI CompatibleOpenAI Compatible准确选择该 provider 类型
Base URL必填必填https://monkeytheme.com/v1
API Key必填必填你的 MonkeyAI Key
Model / Model ID选择或输入 ID选择模型从 /v1/models 返回值复制

来源:Cline OpenAI Compatible 官方文档、Roo Code OpenAI Compatible 官方文档。

先在扩展外验证

curl https://monkeytheme.com/v1/models \
  -H "Authorization: Bearer ***"

有效 Key 应返回该账号当前可见的模型。未带 Key 时,生产环境当前返回 JSON 401 API_KEY_REQUIRED;假 Key 返回 401 INVALID_API_KEY。这只能验证认证行为,不代表模型调用成功。

  1. 从真实响应复制 Model ID。
  2. 点击齿轮进入扩展设置。
  3. 选择 OpenAI Compatible。
  4. 填写 Base URL、API Key 和准确 Model ID。
  5. 先发一个小请求,再开启自动操作。

Cline 配置

API ProviderOpenAI Compatible
Base URLhttps://monkeytheme.com/v1
API Key你的 MonkeyAI API Key
Model账号真实可见的准确 ID

Cline 官方页面还提供高级模型配置。基础请求成功前先保留默认值;修改上下文、token 或能力标记无法修复错误 Key 和错误 URL。

Roo Code 配置与 tool calling 边界

API ProviderOpenAI Compatible
Base URLhttps://monkeytheme.com/v1
API Key你的 MonkeyAI API Key
Model支持原生工具调用的可见 Model ID
Roo Code 当前官方文档说明:只使用原生 tool calling,没有 XML fallback。/v1/models 请求成功本身不能证明所选模型支持原生工具调用。

按现象排查

现象可能层级下一步
401 JSON认证替换缓存 Key,并重新测试 /v1/models
404 HTMLBase URL使用 https://monkeytheme.com/v1
model not foundModel ID 或账号可见性从实时模型列表复制 ID
直接 API 成功,扩展失败扩展状态检查重复 /v1、旧 Key 和 provider
Roo 无法执行工具模型能力确认原生 OpenAI-compatible tool calling

常见问题

Cline 可以接入 MonkeyAI 吗?

可以。Cline 官方提供 OpenAI Compatible provider,并包含 Base URL、API Key 和 Model ID 字段。Base URL 使用 https://monkeytheme.com/v1。

Roo Code 可以接入 MonkeyAI 吗?

可以使用相同的 OpenAI Compatible 字段;但 Roo Code 官方还要求所选模型支持 OpenAI-compatible 原生 tool calling。

为什么 /v1/models 能用,扩展里却失败?

API 路由和 Key 可能正确,但扩展仍可能缓存旧 Key、重复追加 /v1、使用不可见 Model ID,或选择不满足工具调用要求的模型。

401 是否说明 provider 已配置成功?

/v1/models 返回 JSON 401 只说明 API 路由存在但认证失败,不能证明 Key、模型或 tool calling 已经可用。

相关教程

API Key 排错

先区分 401、404 和模型错误。

打开排错教程

Base URL /v1

理解漏写和重复 API 路径。

打开 /v1 教程

Agent 客户端

查看其他支持的客户端。

打开中心