算力猫
← 返回教程列表

接入软件

Roo Code

VS Code 里的 Roo Code:API Provider 选 OpenAI Compatible。

约 5 分钟适合:用 Roo Code 做 Agent 编程的开发者

开始之前

  • VS Code 已安装 Roo Code 扩展
  • 一把 Key,以及从模型广场复制的、支持工具调用的模型名

步骤 1 · STEP 0x01

选 OpenAI Compatible 并填地址、Key

Roo Code → 设置(齿轮)→ Providers
1

API Provider

OpenAI Compatible
2

Base URL

https://api.suanlimao.shop/v1
3

API Key

<你的 Key>
示意图,以软件当前版本界面为准

打开 Roo Code 侧栏,点齿轮进入设置,API Provider 选 OpenAI Compatible,Base URL 填接入地址,API Key 填你的 Key。

接入地址写 https://api.suanlimao.shop/v1(带 /v1)。如果软件提示 404,先检查有没有多写或少写 /v1,再看下面的常见问题。

去创建 Key →

步骤 2 · STEP 0x02

填模型并按需配置参数

OpenAI Compatible → Model
1

Model

<模型名>
2

Context Window

按模型参数
3

Max Output Tokens

按模型参数
4

Image Support

按模型能力
示意图,以软件当前版本界面为准
  • Model 填从模型广场复制的名字。
  • Model Configuration 里的上下文长度、最大输出、图片支持、价格等按模型广场的参数填,Roo Code 用它们来估算成本和截断上下文。
官方说明:Roo Code 只用原生工具调用,没有 XML 回退,所以模型必须支持 OpenAI 格式的函数调用;否则会出现「Tool-calling errors」。在模型广场选带工具调用能力的模型。
模型名不要自己猜:到「模型广场」点模型卡片上的「复制模型名」,再粘贴到软件里。模型名写错是最常见的报错原因。

打开模型广场 →

步骤 3 · STEP 0x03

开一个任务试试

Roo Code 对话
1

任务输入框

解释一下这个文件
2
发送
示意图,以软件当前版本界面为准
  • 在对话框里发一个简单任务;模型能回复并开始调用工具(读文件等)就说明通了。

✓ 怎么确认成功了

  • 任务能得到回复,工具调用正常。
  • 控制台「用量」页出现这次请求。

常见问题

Invalid API Key?

Key 没复制全或已吊销。

Model Not Found?

Model 和模型广场不一致,重新复制;也检查 Base URL 有没有多写或少写 /v1。

Tool-calling errors?

模型不支持原生工具调用,或只部分实现了 tools 接口。换一个在模型广场标注支持工具调用的模型。

相关教程

还是不行?

先看排错教程;仍然解决不了,提交工单时附上 request_id、时间、模型和报错原文(不要贴 Key)。