Roo Code

Roo Code is an AI-powered VS Code extension that supports OpenAI-compatible APIs. By connecting it to DeepIntShield, you get access to any provider/model in your DeepIntShield configuration, plus governance features like virtual keys and built-in observability.

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:

Field	Value
Base URL	http://localhost:8080/openai (or your DeepIntShield host, e.g. https://deepintshield.yourcompany.com/openai)
API Key	Your DeepIntShield virtual key if authentication is enabled; otherwise use dummy or leave empty
Model	DeepIntShield model ID in provider/model format (e.g. anthropic/claude-sonnet-4-5-20250929, openai/gpt-5)

3. Verify the Connection

Ask Roo which model it’s using — it should respond with the DeepIntShield model ID you configured (e.g. anthropic/claude-sonnet-4-5).

Tip

Roo Code supports multiple API configuration profiles. Create separate profiles for different DeepIntShield virtual keys or model combinations, then switch between them via the profile dropdown in Settings or during chat.

Virtual Keys

When DeepIntShield 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 DeepIntShield dashboard.

Model Selection

Roo Code lets you assign models per mode (Code, Ask, Architect, Debug, Orchestrator). Use DeepIntShield 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

DeepIntShield 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:

anthropic/claude-sonnet-4-5-20250929
openai/gpt-5
gemini/gemini-2.5-pro
mistral/mistral-large-latest

Supported Providers

DeepIntShield supports the following providers with the provider/model-name format:

openai, azure, gemini, vertex, bedrock, mistral, groq, cerebras, cohere, perplexity, xai, ollama, openrouter, huggingface, nebius, parasail, replicate, vllm, sgl

Caution

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.

Note

Roo Code connects to DeepIntShield via a single OpenAI-compatible endpoint. DeepIntShield 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 DeepIntShield’s MCP server to access all tools configured in DeepIntShield. See MCP Gateway URL for setup instructions.

Observability

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

Next Steps

• Provider Configuration — Configure AI providers in DeepIntShield
• Virtual Keys — Set up usage limits and access control