接入软件
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,再看下面的常见问题。步骤 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)。