Skip to main content
Roo Code is an AI-powered VS Code extension that supports OpenAI-compatible APIs. By connecting it to Vikat, you get access to any provider/model in your Vikat configuration, plus governance features like virtual keys and built-in observability.
If your Allowed Headers are already set to *, you can skip this note. If not and you face issues integrating Vikat with Roo Code, try switching to * or adding the specific headers required by your client. By default, Vikat whitelists: Content-Type, Authorization, X-Requested-With, X-Stainless-Timeout, and X-Api-Key.

​
Setup

​
1. Install Roo Code

Install the Roo Code extension from the VS Code marketplace.

​
2. Create an API Configuration Profile

  1. Open Settings (click the gear icon) → Providers
  2. Click the + button to create a new profile
  3. Select OpenAI Compatible as the provider
  4. Configure the following:
Roo Code Vikat configuration

​
3. Verify the Connection

Ask Roo which model it’s using - it should respond with the Vikat model ID you configured (e.g. anthropic/claude-sonnet-4-5). Roo Code model verification
Roo Code supports multiple API configuration profiles. Create separate profiles for different Vikat virtual keys or model combinations, then switch between them via the profile dropdown in Settings or during chat.

​
Virtual Keys

When Vikat has virtual key authentication enabled, set API Key in your Roo Code profile to your virtual key. This lets you enforce usage limits, budgets, and access control per user or team. For team deployments, create a separate configuration profile for each team - each can use a different virtual key with its own rate limits, budgets, and provider access rules configured in the Vikat dashboard.

​
Model Selection

Roo Code lets you assign models per mode (Code, Ask, Architect, Debug, Orchestrator). Use Vikat model IDs in provider/model format to access any configured provider:
  • Use powerful models like openai/gpt-5 or anthropic/claude-sonnet-4-5-20250929 for complex coding tasks
  • Use fast models like groq/llama-3.3-70b-versatile for quick completions
  • Link different profiles to different modes in the Prompts tab for optimal cost and performance

​
Using Multiple Providers

Vikat routes requests to the correct provider based on the model name. Use the provider/model-name format to access any configured provider through the single OpenAI-compatible endpoint:

​
Supported Providers

Vikat supports the following providers with the provider/model-name format: openai, azure, gemini, vertex, bedrock, mistral, groq, cerebras, deepseek, cohere, perplexity, xai, ollama, openrouter, huggingface, nebius, parasail, replicate, vllm, sgl
Roo Code requires native tool calling (OpenAI-compatible function calling). Models without tool use support cannot be used with Roo Code. Ensure the model you select supports tool calling.
Roo Code connects to Vikat via a single OpenAI-compatible endpoint. Vikat handles routing to the correct provider based on the model name - no per-provider configuration needed.

​
MCP Server Integration

Roo Code supports MCP (Model Context Protocol). You can connect it to Vikat’s MCP server to access all tools configured in Vikat. See MCP Gateway for setup instructions.

​
Observability

All Roo Code traffic through Vikat is logged. Monitor it at http://localhost:8080/logs - filter by provider, model, or search through conversation content to track usage.

​
Next Steps