Skip to content
Ruvicode logo
Ruvicode
USD
All integrations

Local AI router (free, open source)

How to Use Ruvicode with 9router

9router is a free, open source router that runs on your machine and gives your coding tools one local endpoint in both the OpenAI and Anthropic formats. Adding Ruvicode to it as a custom provider is how Claude Code reaches Ruvicode, and it puts every Ruvicode model next to any other provider you already route through 9router.

Tested on November 3, 2026. 9router 0.5.112 on Windows served Ruvicode models on its OpenAI endpoint (/v1/chat/completions) and its Anthropic endpoint (/v1/messages), and Claude Code ran a coding task through it.

Set up 9router

Base URL

https://api.ruvicode.com/v1

API key

rvcd_...

  1. 1Install and start 9router: npm install -g 9router, then 9router --host 127.0.0.1. The dashboard opens at http://localhost:20128.
  2. 2Go to Providers and click Add OpenAI Compatible. Set Name to Ruvicode, Prefix to ruvicode, API Type to Chat Completions and Base URL to https://api.ruvicode.com/v1, then click Create.
  3. 3Open the new Ruvicode provider, click Add API Key and paste your rvcd_ key. 9router then lists every Ruvicode model as ruvicode/<model id>.
  4. 4Under Endpoint & Key, click Create Key. Your tools use this 9router key and the local endpoint, never your Ruvicode key directly.
npm install -g 9router
9router --host 127.0.0.1
Name:      Ruvicode
Prefix:    ruvicode
API Type:  Chat Completions
Base URL:  https://api.ruvicode.com/v1
API Key:   rvcd_...
curl http://127.0.0.1:20128/v1/chat/completions \
  -H "Authorization: Bearer your-9router-key" \
  -H "Content-Type: application/json" \
  -d '{"model": "ruvicode/glm-5.3-flash", "messages": [{"role": "user", "content": "Say OK"}]}'

Good to know

  • Model names in 9router are the prefix you chose plus the Ruvicode id: ruvicode/claude-sonnet-5.5, ruvicode/glm-5.3-flash and so on.
  • 9router's endpoint is http://127.0.0.1:20128/v1 for OpenAI-format tools and the same address without /v1 for Claude Code.
  • Requests to 9router need a 9router key from Endpoint & Key; Require API key is on by default.
  • 9router binds to every network interface by default and its dashboard starts with the password 123456. Start it with --host 127.0.0.1 so only your machine can reach it, and change the dashboard password in Settings.

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.

9router with Ruvicode: FAQ

Do I need 9router if my tool already supports OpenAI-compatible providers?
No. OpenCode, Cline, Roo Code, Kilo Code, Continue and Aider connect to Ruvicode directly; their guides are on the integrations page. 9router is for Claude Code and other Anthropic-protocol clients, or for routing several providers through one endpoint.
Is 9router made by Ruvicode?
No. 9router is an independent open source project under the MIT license. Ruvicode is one of the providers you can add to it.
Does my Ruvicode key leave my machine through 9router?
9router keeps provider keys in a local database on your machine and uses the Ruvicode key to call api.ruvicode.com. Its cloud sync is off by default; leave it off if you do not want provider settings synced to 9router's cloud.
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.