0.26.1. See the release notes for what changed in each version. For the CodeRabbit configuration that shapes a review, such as .coderabbit.yaml, see Which review configuration applies.
Open the settings
Select the gear icon on the Review view title bar, or run CodeRabbit: Settings from the Command Palette. Both open your editorâs Settings filtered to the CodeRabbit extension. You can set most settings for your user or for a single workspace. The Scope line of each entry in the settings reference says where a setting can go. To editsettings.json directly, add the keys like this:
settings.json
Settings by task
Each of these pages explains when to change a setting and what it does:coderabbit.autoReviewMode: Review automatically after each commitcoderabbit.agentTypeandcoderabbit.autoStartTask: Fix findings with your AI agentcoderabbit.accountRegion: Use an EU-hosted accountcoderabbit.respectGitIgnore: What gets reviewedcoderabbit.completionNotificationsandcoderabbit.reviewCompletionSound: Get notified when a review finishescoderabbit.selfHostedUrl: Use the IDE extension with self-hosted CodeRabbitcoderabbit.region: deprecated; the extension moves its value tocoderabbit.accountRegionat startup.
Restricted Mode
When you open a workspace you havenât trusted, the extension runs in Restricted Mode. In Restricted Mode, the extension uses CodeRabbit Cloud even if a self-hosted URL is set, runs no Git commands of its own, and doesnât offer CLI setup. Fix with AI ignores workspace values of the agent and auto-start settings and uses your user settings. Ignored workspace settings:coderabbit.agentType, coderabbit.autoStartTask.
Trust the workspace to lift these limits.
Settings reference
coderabbit.accountRegion
Choose the region where your CodeRabbit account is hosted. Match the website you use to sign in. Changing this setting connects the extension to that region; it does not move your account.
- Type:
string - Default:
us - Scope: User, remote, and workspace settings
- Allowed values:
us: For accounts using app.coderabbit.ai. Labeled US (default) in the Settings editor.eu: For accounts using app.eu.coderabbit.ai. Labeled EU in the Settings editor.
coderabbit.agentType
The AI agent to use for âFix with AIâ functionality.
- Type:
string - Default:
Native - Scope: User, remote, and workspace settings
- Untrusted workspaces: workspace values are ignored and only your user setting applies
- Allowed values:
Native: Use built-in AI agent (default). Falls back to Clipboard if not available.Claude Code: Use Claude Code in terminalClaude Code Extension: Use Claude Code VSCode Extension (requires the Claude Code extension)Codex CLI: Use Codex CLI in terminalClipboard: Copy instructions to clipboardCline: Use Cline (requires the Cline extension)Roo: Use Roo (requires the Roo Code extension)Kilo Code: Use Kilo Code (requires the Kilo Code extension)Augment Code: Use Augment Code (requires the Augment Code extension)opencode: Use opencode in terminal
coderabbit.autoReviewMode
Whether to review your committed changes after each commit.
- Type:
string - Default:
prompt - Scope: User, remote, and workspace settings
- Allowed values:
disabled: Donât offer a review after commitsprompt: Ask whether to review your committed changes after each commit (default)auto: Start reviewing your committed changes after each commit, with a 10-second countdown to cancel
coderabbit.autoStartTask
Send Fix with AI prompts right away in the built-in AI agent in VS Code, Cline, Roo, and Kilo Code. When disabled, the prompt is pasted into the agentâs chat input for you to review and send. Other agents arenât affected.
- Type:
boolean - Default:
true - Scope: User, remote, and workspace settings
- Untrusted workspaces: workspace values are ignored and only your user setting applies
coderabbit.completionNotifications
Request a macOS Notification Center status alert on local desktop sessions when a CodeRabbit review completes or fails. Successful reviews also show an IDE notification with Show Review. Other platforms and remote/web sessions use the IDE notification. macOS notification permissions and Focus settings control OS alert visibility.
- Type:
boolean - Default:
false - Scope: Local user settings only
coderabbit.respectGitIgnore
Exclude ignored untracked files supplied by Git from local reviews. Tracked and staged files remain eligible even if they match ignore rules. Disabling this does not discover ignored files omitted by Git. Built-in file exclusions still apply.
- Type:
boolean - Default:
true - Scope: User, remote, workspace, and folder settings
coderabbit.reviewCompletionSound
Play a short sound when a review completes. Requires the CodeRabbit panel to have been opened in this window. Playback depends on your editorâs audio permissions and system volume; blocked sounds are skipped.
- Type:
boolean - Default:
false - Scope: Local user settings only
coderabbit.selfHostedUrl
URL of your self-hosted CodeRabbit instance, for example https://coderabbit.yourcompany.com. When set, the extension connects to this instance instead of CodeRabbit Cloud. Self-hosted sign-in uses your Git email and, for GitHub, a personal access token instead of a CodeRabbit account. Ignored in Restricted Mode.
- Type:
string - Default: None
- Scope: Local user settings only
coderabbit.region
Deprecated. Use coderabbit.accountRegion instead. Your saved region still applies until you set Account region.
- Type:
string - Default:
us - Scope: User, remote, and workspace settings
- Allowed values:
useu
Commands
The actions on a CodeRabbit comment thread, such as Ignore, Fix with AI, and Provide feedback, arenât in the Command Palette. Use them from the threadâs title bar; see Act on a finding.
The extension has no default keyboard shortcuts. To add one, open Keyboard Shortcuts and bind a command ID from the table, for example
coderabbit-vscode.initiateReview for CodeRabbit: Start Review.