Choosing a connection method
Roo Code stores connection settings in configuration profiles. It’s convenient to create two — for example,
RuAPI Claude and RuAPI DeepSeek — and switch between them right from the chat.
Before you start
1
RuAPI API key
Sign up at www.ruapi.ai and top up your balance (how to top up). Then go to Console → API Keys and click Create API key. Keys start with
sk-.2
Latest version of Roo Code
Install Roo Code from the VS Code Marketplace (search for “Roo Code”) or update it to the latest version.
If your Roo Code interface is in another language, the field names will be translated, but their order and purpose are the same.
A profile for Claude (Anthropic provider)
1
Create a profile
Open Roo Code in the sidebar → ⚙️ → Providers. Click + next to the profile list and give the profile a name, for example,
RuAPI Claude.2
Fill in the fields
3
Save the profile
Click Save.
If the model you need isn’t in the Model list, update Roo Code: the list of Anthropic models is bundled with the extension and updated with each release.
A profile for DeepSeek, GPT and other models (OpenAI Compatible)
1
Create another profile
⚙️ → Providers → +, and name it, for example,
RuAPI DeepSeek.2
Fill in the fields
3
Check the model settings
In the model settings:
- Image Support — enable it for GPT, Gemini and
deepseek-flash.deepseek-v4-prodoesn’t accept images. - Context Window — the model’s context window. Don’t set it higher than the model actually supports, or long tasks will fail with a context-length error.
- Input Price / Output Price — optional. Enter the per-1M-token prices from the pricing page and Roo Code will show an estimated cost for each task.
4
Save the profile
Click Save.
kimi/kimi-k3).
Roo Code only works with models that support tool calling. RuAPI’s main text models — Claude, GPT, Gemini, DeepSeek, GLM, Qwen, Kimi — all do; image and video generation models won’t work in Roo Code.
A model for each mode
Roo Code has several modes: Architect (design and planning), Code (writing and editing code), Ask (questions about the codebase), Debug (tracking down bugs) and Orchestrator (breaks a large task into subtasks). Each mode can use its own profile. Roo Code remembers which profile you last used in each mode, and you can pin a profile to a mode on the Prompts tab in the settings. Combinations that work well:Your first task
Open a project folder, switch to Code mode and give it a task, for example:Keeping costs down
- New topic, new task. The context grows with every step and is sent in full each time.
- Save the strongest model for where it matters. Use Opus for planning, and cheaper models for routine edits and questions.
- Use a separate key with a spending limit. Create a dedicated key for Roo Code and set a limit on it in Console → API Keys.
Troubleshooting
401 / Invalid API Key
401 / Invalid API Key
- Make sure you pasted the full RuAPI key (
sk-...) with no extra spaces. - For the Anthropic provider, the URL is
https://www.ruapi.aiwithout/v1; for OpenAI Compatible, it’shttps://www.ruapi.ai/v1with/v1.
Model Not Found / 404 / 503
Model Not Found / 404 / 503
The model name must match the one on RuAPI exactly — copy it from the pricing page.
400: “enabled” is not supported for this model
400: “enabled” is not supported for this model
The newest Claude models (Opus 4.7 and later, plus all fifth-generation models) only support adaptive thinking. If an older version of Roo Code enables reasoning with a token budget for such a model, the request is rejected. Update Roo Code or turn off reasoning in the model settings.
Tool-calling errors
Tool-calling errors
Make sure you’ve selected a text model, not an image or video generation model. If the error keeps happening with one model, try another — for example,
claude-sonnet-5-5 or deepseek-flash.400: The reasoning_content in the thinking mode must be passed back
400: The reasoning_content in the thinking mode must be passed back
This can happen with DeepSeek in reasoning mode if you switch models or profiles mid-task. In most cases RuAPI automatically fixes and retries the request. If the error persists, start a new task.
What’s next
- Cline and Kilo Code — similar VS Code agents.
- Claude Code — Anthropic’s official terminal agent.
- Models and prices — the full list of available models.