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

# Configure the VS Code extension

> Customize the CodeRabbit VS Code extension settings, including AI agent integration, automatic review behavior, regional infrastructure, task startup, and self-hosted configurations.

Configure the CodeRabbit VS Code extension to match your workflow preferences. For more information about using the extension, see [Review local changes](/ide).

<Note>
  These instructions are specific to VS Code. If you're using a VS Code-compatible
  editor like Cursor or Windsurf, the steps are similar but may require some
  adaptation.
</Note>

## Find the settings screen

<Steps>
  <Step title="Open CodeRabbit sidebar">
    Open the CodeRabbit activity bar/sidebar.
  </Step>

  <Step title="Click the settings icon">
    In the sidebar, click the gear-shaped icon on the top right (beside the
    logout icon).
  </Step>
</Steps>

<Tip>
  You can also search for **CodeRabbit: Settings** in the command palette to
  open the settings directly.
</Tip>

The settings screen contains the following configuration controls.

| Setting              | Values                                                                                                                                       | Default  | Use when                                                                                                                    |
| -------------------- | -------------------------------------------------------------------------------------------------------------------------------------------- | -------- | --------------------------------------------------------------------------------------------------------------------------- |
| **Agent Type**       | `Native`, `Claude Code`, `Claude Code Extension`, `Codex CLI`, `Clipboard`, `Cline`, `Devin`, `Roo`, `Kilo Code`, `Augment Code`, `OpenCode` | `Native` | You want to choose how **Fix with AI** sends review comments to an AI coding agent.                                         |
| **Auto Review Mode** | `Disabled`, `Prompt`, `Auto`                                                                                                                 | `Prompt` | You want to control whether local commits trigger CodeRabbit reviews.                                                       |
| **Region**           | `us`, `eu`                                                                                                                                   | `us`     | You use CodeRabbit Cloud and need the extension to connect to US or EU infrastructure.                                      |
| **Auto Start Task**  | `true`, `false`                                                                                                                              | `true`   | You want supported AI agents to start tasks automatically instead of opening with the prompt ready for manual confirmation. |
| **Self Hosted URL**  | URL                                                                                                                                          | unset    | You use a self-hosted CodeRabbit instance instead of CodeRabbit Cloud.                                                      |

## Configure AI agent integration

The **Agent Type** setting lets you choose how the extension responds when using the **Fix with AI** feature during code reviews.

<Tabs>
  <Tab title="Native integrations">
    <CardGroup cols={2}>
      <Card title="Native">
        Prompts the AI agent associated with your IDE to apply the suggested
        fix.

        <Note>
          Works with VS Code (using Copilot), Cursor, Devin, and Windsurf. For other
          IDEs, copies to clipboard.
        </Note>
      </Card>

      <Card title="Clipboard">
        Copies prompt text describing the suggested fix to your clipboard for
        manual use with your preferred AI agent.
      </Card>
    </CardGroup>
  </Tab>

  <Tab title="Command-line tools">
    <CardGroup cols={2}>
      <Card title="Claude Code">
        Opens Terminal and uses the `claude` command-line program to apply
        fixes.
      </Card>

      <Card title="Codex CLI">
        Opens Terminal and uses the `codex` command-line program to apply fixes.
      </Card>

      <Card title="OpenCode">
        Opens Terminal and uses the `opencode` command-line program to apply
        fixes.
      </Card>
    </CardGroup>
  </Tab>

  <Tab title="VS Code extensions">
    <CardGroup cols={2}>
      <Card title="Claude Code Extension">
        Opens the Claude Code VS Code extension with the suggested fix prompt.
      </Card>

      <Card title="Cline">
        Opens the Cline sidebar and runs a task to apply the suggested fix.
      </Card>

      <Card title="Roo">
        Opens the Roo sidebar and runs a task to apply the suggested fix.
      </Card>

      <Card title="Kilo Code">
        Opens the Kilo Code sidebar and runs a task to apply the suggested fix.
      </Card>

      <Card title="Augment Code">
        Opens the Augment Code sidebar with the prompt, allowing you to start
        the task manually.
      </Card>
    </CardGroup>
  </Tab>
</Tabs>

For more information about the **Fix with AI** feature, see [Request help from your AI coding agent](/ide/vscode-use#use-ai-coding-agents).

## Configure automatic review behavior

The **Auto Review Mode** setting controls how the extension handles automatic code reviews after you make commits to your local Git repository.

<CardGroup cols={3}>
  <Card title="Disabled">
    The extension doesn't perform automatic code reviews.
  </Card>

  <Card title="Prompt">
    After every commit, displays a dialog asking if you'd like to perform a code
    review.
  </Card>

  <Card title="Auto">
    Always performs a review after every commit automatically.
  </Card>
</CardGroup>

For more information about this feature, see [Automatically review local commits](/ide/vscode-use#automatic-reviews).

## Choose the CodeRabbit region

The **Region** setting controls which CodeRabbit Cloud infrastructure the extension connects to.

| Value | Behavior                                        |
| ----- | ----------------------------------------------- |
| `us`  | Connects to the US region. This is the default. |
| `eu`  | Connects to the EU region.                      |

If you configure **Self Hosted URL**, the extension connects to that URL instead of the selected CodeRabbit Cloud region.

## Configure task startup

The **Auto Start Task** setting controls whether supported AI agents start working on the suggested fix automatically.

| Value   | Behavior                                                                             |
| ------- | ------------------------------------------------------------------------------------ |
| `true`  | Starts tasks automatically for supported agents. This is the default.                |
| `false` | Opens the selected agent with the prompt ready so you can review and start manually. |

This setting applies to supported agents such as **Native** in VS Code, **Cline**, **Roo**, and **Kilo Code**.

## Use with self-hosted CodeRabbit

The **Self Hosted URL** setting is only used when you're using a self-hosted instance of CodeRabbit. If you're using the CodeRabbit Cloud service, you don't need to configure this setting.

Set this to the base URL of your CodeRabbit instance, such as `https://coderabbit.yourcompany.com`. When this value is configured, the extension connects directly to your server instead of the selected CodeRabbit Cloud region.

<Warning>
  You will need to log in and log out of the extension after adding this value
  for the changes to take effect.
</Warning>

## What's next

<CardGroup cols={2}>
  <Card title="Use the VS Code extension" href="/ide/vscode-use">
    Learn how to review code changes and use AI features
  </Card>

  <Card title="Uninstall the VS Code extension" href="/ide/vscode-uninstall">
    Remove the CodeRabbit extension from your editor
  </Card>
</CardGroup>