Skip to content
Ruvicode logo
Ruvicode
USD
All integrations

VS Code extension

How to Use Ruvicode with Roo Code

Roo Code uses its OpenAI Compatible provider for custom endpoints. Roo Code relies on native tool calling, so the model you pick matters; this guide sets up the provider and lists models that pass that requirement.

Checked on November 3, 2026. Settings checked against Roo Code's OpenAI Compatible provider documentation. Native tool calls, which Roo Code requires, streamed through api.ruvicode.com with GLM 5.3 Flash, Claude Sonnet 5.5 and Kimi K2.7 Code.

Set up Roo Code

Base URL

https://api.ruvicode.com/v1

API key

rvcd_...

  1. 1Open Roo Code and click the settings icon.
  2. 2Set API Provider to OpenAI Compatible.
  3. 3Enter the Base URL and paste your rvcd_ key in API Key.
  4. 4Enter or select the Model, for example kimi-k2.7-code.
  5. 5Under Model Configuration, set Context Window and Max Output Tokens from the model's page, and Image Support for vision models.
API Provider:  OpenAI Compatible
Base URL:      https://api.ruvicode.com/v1
API Key:       rvcd_...
Model:         kimi-k2.7-code

Good to know

  • Roo Code only works with models that support OpenAI-style native tool calling. The models suggested on this page all return tool_calls through Ruvicode.
  • Use a separate API key for Roo Code and give it a daily spend limit in the dashboard. Long autonomous runs then stop at a cost you chose.

Models for coding agents

These models completed streamed tool calls through Ruvicode on November 3, 2026. Every model in the catalog works with the same base URL and key; each model page shows its live rate, context window and max output.

Common errors

401 Invalid API key
The key is mistyped, revoked or not a Ruvicode key. Copy it again from the dashboard; it starts with rvcd_.
404 Model not found
The model id is not in the catalog. Use an id exactly as listed on the models page or by GET /v1/models. A plain 404 page instead of a JSON error means the base URL is missing /v1.
402 insufficient_balance
The wallet cannot cover the request. Top up in the dashboard; the balance never expires.
429 rate limit
Too many requests per minute, on the key or across the account. Agents that fire many calls in parallel can hit it; most tools retry on their own after a short wait.

Roo Code with Ruvicode: FAQ

Roo Code says the model does not support tools. What now?
Switch to a chat model with native tool calling, such as GLM 5.3 Flash, Claude Sonnet 5.5 or Kimi K2.7 Code. The ruvicode-image models generate images only and cannot run an agent.
Does this work with Claude Code?
Yes, through 9router. Claude Code speaks the Anthropic Messages protocol (/v1/messages) and Ruvicode serves OpenAI chat completions, so 9router runs on your machine and translates between them. The Claude Code guide has the full setup.
Where do I get a Ruvicode API key?
Create an account, top up your wallet with QRIS or USDC, then open API Keys in the dashboard and create a key. Keys start with rvcd_. You can set a daily or monthly spend limit per key and restrict a key to a list of models.