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

# Roo Code

> Configure Moxus AI as an OpenAI-compatible provider in Roo Code.

Roo Code is a VS Code agent extension that can read project files, run commands, and edit code. To connect it to Moxus AI, use an OpenAI Compatible or custom OpenAI provider.

## Values

| Field    | Value                                             |
| -------- | ------------------------------------------------- |
| Provider | OpenAI Compatible / OpenAI Compatible API         |
| Base URL | `https://moxus.cloud/v1`                          |
| API Key  | `sk-your-key`                                     |
| Model ID | Copy the exact model name from Models and pricing |

## Setup

<Steps>
  <Step title="Install Roo Code">
    Install Roo Code from the VS Code extension marketplace.

    <img src="https://mintcdn.com/moxus-cloud/DgOc9Y6ZmJ9TiNBD/images/roo-code-install.png?fit=max&auto=format&n=DgOc9Y6ZmJ9TiNBD&q=85&s=552f6d29d4caaa31cf6b1a6e8ba6c34e" alt="Search for and install Roo Code from the VS Code extension marketplace" width="3186" height="1556" data-path="images/roo-code-install.png" />
  </Step>

  <Step title="Open API configuration">
    Open Roo Code API Configuration or model settings.
  </Step>

  <Step title="Choose an OpenAI-compatible provider">
    Select OpenAI Compatible or custom OpenAI as the provider.
  </Step>

  <Step title="Enter endpoint settings">
    Set Base URL to `https://moxus.cloud/v1` and API Key to your Moxus AI `sk-` key.
  </Step>

  <Step title="Enter the model name">
    Use the exact model name from Models and pricing as Model ID.

    <img src="https://mintcdn.com/moxus-cloud/DgOc9Y6ZmJ9TiNBD/images/roo-code-model-selection.png?fit=max&auto=format&n=DgOc9Y6ZmJ9TiNBD&q=85&s=b1d9418d809b0c2be5cf1828036d4aa1" alt="OpenAI-compatible provider and model configuration in Roo Code" width="1660" height="1204" data-path="images/roo-code-model-selection.png" />
  </Step>

  <Step title="Start chat runs">
    Open the chat view, select the model you just configured, and send a request.

    <img src="https://mintcdn.com/moxus-cloud/DgOc9Y6ZmJ9TiNBD/images/roo-code-request-mode.png?fit=max&auto=format&n=DgOc9Y6ZmJ9TiNBD&q=85&s=b9da00ab2c89d331848ee0b779e99cca" alt="Roo Code asks for the next task in a chat" width="1658" height="842" data-path="images/roo-code-request-mode.png" />
  </Step>
</Steps>

## Recommendations

* Test with Ask or a read-only task first.
* Review commands before allowing the extension to run them.
* Create a separate API key for Roo Code and set a quota limit.
* Keep task scope narrow for multi-file edits.

<Warning>
  Roo Code can read files, run commands, and modify code. Use it only in trusted projects and be careful with auto-approval settings.
</Warning>

## Troubleshooting

<AccordionGroup>
  <Accordion title="Should I choose OpenAI or OpenAI Compatible?">
    Prefer OpenAI Compatible or custom OpenAI. Set Base URL to `https://moxus.cloud/v1`.
  </Accordion>

  <Accordion title="Does the model support tool use?">
    It depends on the selected model. For tool use and complex code editing, choose a model with stronger coding and tool-call behavior.
  </Accordion>

  <Accordion title="The extension sends too many requests">
    Reduce auto-approval, narrow file scope, and set a quota limit on the API key used by Roo Code.
  </Accordion>
</AccordionGroup>

## Next steps

* [API keys](/en/platform/account-and-keys)
* [Usage](/en/platform/dashboard-and-usage)