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_...
- 1Open Roo Code and click the settings icon.
- 2Set API Provider to OpenAI Compatible.
- 3Enter the Base URL and paste your rvcd_ key in API Key.
- 4Enter or select the Model, for example kimi-k2.7-code.
- 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-codeGood 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.
- GLM 5.3 Flash
glm-5.3-flash - Claude Sonnet 5.5
claude-sonnet-5.5 - Kimi K2.7 Code
kimi-k2.7-code
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.
Guides for other tools
The same base URL and key work everywhere. Setup for each tool: