> ## Documentation Index
> Fetch the complete documentation index at: https://docs.orq.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Roo Code

> Configure an OpenAI Compatible provider in the Roo Code VS Code extension to route requests through the Orq.ai AI Gateway and reach Claude models.

[**Roo Code**](https://marketplace.visualstudio.com/items?itemName=RooVeterinaryInc.roo-cline) is a VS Code extension for AI-assisted coding. Configure it with an OpenAI Compatible provider pointing to the **AI Gateway** to access every model in the catalog, including Anthropic Claude models.

## Prerequisites

* **Roo Code** extension installed in VS Code (`RooVeterinaryInc.roo-cline`)
* Active **Orq.ai** account
* [**Orq.ai** API key](/ai-studio/organization/api-keys)

## Setup

Open the **Roo Code** panel → <Icon icon="gear" /> **Settings** → **API Configuration**.

Fill the fields:

| Field            | Value                         |
| ---------------- | ----------------------------- |
| **API Provider** | `OpenAI Compatible`           |
| **Base URL**     | `https://my.orq.ai/v3/router` |
| **API Key**      | `<ORQ_API_KEY>`               |
| **Model ID**     | `anthropic/claude-sonnet-5`   |

Click **Save**.

<Warning>
  Always use the `provider/model_id` format for model IDs (e.g. `anthropic/claude-sonnet-5`, not `claude-sonnet-5`). Bare IDs return a `400 invalid model format` error.
</Warning>

## Skills

**Orq Skills** add pre-built agentic workflows to Roo Code for the full Build, Evaluate, Optimize lifecycle.

### Installation

```bash theme={"theme":{"light":"github-light","dark":"github-dark"}}
npx skills add orq-ai/assistant-plugins --agent roo
```

Set an [API key and connect the Orq MCP server](/ai-studio/integrations/code-assistants/orq-skills#prerequisites) first. Skills are then triggered by describing what is needed.

<Card title="Orq Skills" icon="wand-magic-sparkles" href="/ai-studio/integrations/code-assistants/orq-skills">
  The full catalogue of skills and slash commands.
</Card>

<Note>
  Slash commands (`/orq:quickstart`, `/orq:traces`, and others) are only available in Claude Code.
</Note>

## Troubleshooting

<AccordionGroup>
  <Accordion title="400 invalid model format">
    The model ID is missing the provider prefix. Change `claude-sonnet-5` to `anthropic/claude-sonnet-5`, `gpt-5.6-sol` to `openai/gpt-5.6-sol`, and so on.
  </Accordion>

  <Accordion title="Requests not appearing in Orq.ai Traces">
    Verify the **Base URL** is set to `https://my.orq.ai/v3/router`. Requests sent to a provider's own endpoint bypass the **AI Gateway** and produce no **Traces**.
  </Accordion>
</AccordionGroup>

## Verification

Send a message in the **Roo Code** panel. The response appears in the chat and the request appears in [**Orq.ai** Traces](/ai-studio/observability/traces) with the model identifier `anthropic/claude-sonnet-5` (or whichever model was selected).