Suanlimao
← Back to all tutorials

Connect your tools

Roo Code

Roo Code in VS Code: set the API Provider to OpenAI Compatible.

About 5 minFor:Developers who use Roo Code for agentic coding

Before you start

  • VS Code with the Roo Code extension
  • A key and a model name from the plaza that supports tool calling

Step 1 · STEP 0x01

Choose OpenAI Compatible and enter the address and key

Roo Code → Settings (gear) → Providers
1

API Provider

OpenAI Compatible
2

Base URL

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

API Key

<YOUR_API_KEY>
Diagram only — the real screen in your version may differ

Open the Roo Code sidebar, click the gear, set API Provider to OpenAI Compatible, enter the Base URL and your API Key.

Use https://api.suanlimao.shop/v1 as the API address (with /v1). If the tool says 404, check whether /v1 is missing or doubled, then read the FAQ below.

Create a key →

Step 2 · STEP 0x02

Enter the model and tune its configuration

OpenAI Compatible → Model
1

Model

<MODEL_NAME>
2

Context Window

Per the model's details
3

Max Output Tokens

Per the model's details
4

Image Support

Per the model's capability
Diagram only — the real screen in your version may differ
  • Model is the name copied from the plaza.
  • Context window, max output, image support and prices under Model Configuration come from the plaza; Roo Code uses them for cost estimates and context trimming.
Per the docs Roo Code uses native tool calling only — no XML fallback — so the model must support OpenAI-style function calling, or you will see “Tool-calling errors”. Pick a tool-calling model on the plaza.
Don't guess the model name: open the model plaza, click “Copy model id” on a model card and paste it. A wrong model name is the most common error.

Open the model plaza →

Step 3 · STEP 0x03

Run a task

Roo Code chat
1

Task box

Explain this file
2
Send
Diagram only — the real screen in your version may differ
  • Send a simple task; if the model replies and starts calling tools (reading files, etc.) it works.

✓ How to tell it worked

  • Tasks get replies and tool calls work.
  • The Usage page shows the request.

FAQ

Invalid API Key?

The key is truncated or revoked.

Model Not Found?

Model does not match the plaza — copy it again; also check whether /v1 is missing or doubled in the Base URL.

Tool-calling errors?

The model lacks native tool calling or implements the tools API only partially. Switch to a model marked as tool-calling on the plaza.

Related tutorials

Still stuck?

Read the troubleshooting tutorials first. If that does not help, open a ticket with the request_id, time, model and the exact error (never paste your key).