All integrations
Terminal pair programmer
How to Use Ruvicode with Aider
Aider reaches any OpenAI-compatible API through two environment variables and the openai/ model prefix. This guide sets that up for Ruvicode and adds the model metadata Aider needs to know each model's context window.
Tested on November 3, 2026. Aider 0.86.2 (Python 3.12) applied a bug fix to a file in a git repo through api.ruvicode.com with the settings below.
Set up Aider
Base URL
https://api.ruvicode.com/v1
API key
rvcd_...
- 1Install Aider: python -m pip install aider-install && aider-install, or run it with uv tool run --from aider-chat aider.
- 2Set OPENAI_API_BASE and OPENAI_API_KEY in your shell or in a .env file in the repo.
- 3Run aider with the model id prefixed by openai/, for example aider --model openai/glm-5.3-flash.
- 4Optional: add .aider.model.metadata.json (below) so Aider knows the model's context window and stops warning about an unknown model.
export OPENAI_API_BASE=https://api.ruvicode.com/v1
export OPENAI_API_KEY=rvcd_...
aider --model openai/glm-5.3-flash{
"openai/glm-5.3-flash": {
"max_input_tokens": 1000000,
"max_output_tokens": 128000,
"litellm_provider": "openai",
"mode": "chat"
}
}Good to know
- The openai/ prefix tells Aider to send the request to OPENAI_API_BASE instead of api.openai.com. Without it Aider looks the model up in its own provider list.
- Without metadata Aider prints "Unknown context window size and costs, using sane defaults" and still works. With the file in the repo root (or your home directory) the warning goes away and Aider sizes its repo map to the real window.
- Aider picks the whole file edit format for models it does not know. For large files, --edit-format diff sends smaller edits.
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.
Aider with Ruvicode: FAQ
- Aider says the model is unknown. Is something wrong?
- No. Aider only knows context windows and prices for models in its built-in list. Requests still go through. Add the model to .aider.model.metadata.json with max_input_tokens and max_output_tokens to silence the warning.
- Which model id do I pass to Aider?
- The Ruvicode model id with openai/ in front, for example openai/claude-sonnet-5.5 or openai/kimi-k2.7-code. The ids are listed in the models catalog and at GET /v1/models.
- 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: