# Installing VibeSec

This guide explains how to install and connect VibeSec to AI-powered coding environments using hooks and OAuth authentication.

Once the connection is established, VibeSec activates automatically in your development environment and applies security controls during coding, without interrupting your workflow.

After the installation:

* You can continue coding immediately; no restart is required.
* Your admin can view developer usage and risk-prevention metrics within [VibeSec Usage Report](https://docs.ox.security/generate-reports/built-in-reports/vibesec-usage-reports) in the OX dashboard.

The following installation procedures are covered:

* [Vibesec on Cursor](#install-vibesec-on-cursor)
* [Vibesec on Claude](#install-vibesec-on-claude-code-and-claude-code-vs-code-ide-extension)

## Install VibeSec on Cursor

This procedure explains how to connect Cursor to VibeSec using hooks and OAuth authentication.

### Step 1: Install hooks \[Cursor]

1. From any terminal, run:

**Mac**

```
curl -fsSL https://ox-vibesec.s3.eu-west-1.amazonaws.com/vibesec-installation/cursor/install.sh | bash
```

**Linux**

```
wget -qO- https://ox-vibesec.s3.eu-west-1.amazonaws.com/vibesec-installation/cursor/install.sh | bash
```

<figure><img src="https://884876233-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FdK3XMLdV8zRg847RmGmZ%2Fuploads%2Fgit-blob-67fbce0e2815e24297b3195464de52f4fec17cfe%2F1_Install%20command.png?alt=media" alt="" width="563"><figcaption></figcaption></figure>

The authentication process starts.

<figure><img src="https://884876233-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FdK3XMLdV8zRg847RmGmZ%2Fuploads%2Fgit-blob-923c30b71cc0b68b22278fc51141cb490d9a88e8%2F2_Start_authentication.png?alt=media" alt="" width="563"><figcaption></figcaption></figure>

2. Log in to OX.

> **Note**\
> If your organization requires SSO, sign in using your enterprise email address.

<figure><img src="https://884876233-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FdK3XMLdV8zRg847RmGmZ%2Fuploads%2Fgit-blob-31628a97e0793bf879a738dc1bf85b2963b757ae%2F3_login_to_ox.png?alt=media" alt="" width="563"><figcaption></figcaption></figure>

3. Select your organization.

<figure><img src="https://884876233-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FdK3XMLdV8zRg847RmGmZ%2Fuploads%2Fgit-blob-32163a567b6ad9688ee75e6ad46c254b435a8db0%2F4_Select%20your%20org.png?alt=media" alt="" width="563"><figcaption></figcaption></figure>

Authorization completion message appears.

<figure><img src="https://884876233-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FdK3XMLdV8zRg847RmGmZ%2Fuploads%2Fgit-blob-7fde1b4b83711a8ba39b3f01e61eaf3ff82c706b%2F5_%20Authorization%20complete.png?alt=media" alt="" width="563"><figcaption></figcaption></figure>

Authentication completion message appears.

<figure><img src="https://884876233-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FdK3XMLdV8zRg847RmGmZ%2Fuploads%2Fgit-blob-b9b1b84b76ec21efb53776d14c87629038d8674f%2F6_Authentication%20complete%20appears.png?alt=media" alt="" width="563"><figcaption></figcaption></figure>

Final completion of the installation process appears.

<figure><img src="https://884876233-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FdK3XMLdV8zRg847RmGmZ%2Fuploads%2Fgit-blob-205a6033d9b5e83c2ff870f441214726200bb51e%2F7%20final%20verification_now%20restart%20cursor.png?alt=media" alt="" width="563"><figcaption></figcaption></figure>

4. Restart Cursor.

> **Note**\
> It is recommended to test VibeSec with a prompt such as:
>
> `Create a web form that accepts user input and stores it in the database`,
>
> or
>
> `Create a web form that allows the user to upload a file and store it in the database`.&#x20;

## Install VibeSec on Claude Code and Claude Code VS Code IDE Extension

1. From any terminal, run:

**Mac**

```
curl -fsSL https://ox-vibesec.s3.eu-west-1.amazonaws.com/vibesec-installation/claude/install.sh | bash
```

**Linux**

```
wget -qO- https://ox-vibesec.s3.eu-west-1.amazonaws.com/vibesec-installation/claude/install.sh | bash
```

**Windows (PowerShell)**

```
irm https://ox-vibesec.s3.eu-west-1.amazonaws.com/vibesec-installation/claude/install.ps1 | iex
```

If your antivirus blocks the provided command, use the following (requires NodeJS; in case you do not have NodeJS installed, OX prompts you to confirm the installation):

```
Invoke-WebRequest -Uri https://ox-vibesec.s3.eu-west-1.amazonaws.com/vibesec-installation/claude/install_ox_claude_hooks.js -OutFile $env:TEMP\ox-install.js; node $env:TEMP\ox-install.js
```

<figure><img src="https://884876233-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FdK3XMLdV8zRg847RmGmZ%2Fuploads%2Fgit-blob-7f086242af208039b2a4f45ad3473f562303b347%2Fclaude_1_install_command%20(1).png?alt=media" alt="" width="563"><figcaption></figcaption></figure>

The authentication process starts.

<figure><img src="https://884876233-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FdK3XMLdV8zRg847RmGmZ%2Fuploads%2Fgit-blob-e57711c75391f7fa7cba0f6e2ead9355067d6854%2Fclaude_2_start_auth.png?alt=media" alt="" width="563"><figcaption></figcaption></figure>

2. Log in to OX.

> **Note**\
> If your organization requires SSO, sign in using your enterprise email address.

<figure><img src="https://884876233-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FdK3XMLdV8zRg847RmGmZ%2Fuploads%2Fgit-blob-31628a97e0793bf879a738dc1bf85b2963b757ae%2F3_login_to_ox.png?alt=media" alt="" width="563"><figcaption></figcaption></figure>

3. Select your organization.

<figure><img src="https://884876233-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FdK3XMLdV8zRg847RmGmZ%2Fuploads%2Fgit-blob-32163a567b6ad9688ee75e6ad46c254b435a8db0%2F4_Select%20your%20org.png?alt=media" alt="" width="563"><figcaption></figcaption></figure>

Authorization completion message appears.

<figure><img src="https://884876233-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FdK3XMLdV8zRg847RmGmZ%2Fuploads%2Fgit-blob-7fde1b4b83711a8ba39b3f01e61eaf3ff82c706b%2F5_%20Authorization%20complete.png?alt=media" alt="" width="563"><figcaption></figcaption></figure>

Authentication completion message appears.

<figure><img src="https://884876233-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FdK3XMLdV8zRg847RmGmZ%2Fuploads%2Fgit-blob-b9b1b84b76ec21efb53776d14c87629038d8674f%2F6_Authentication%20complete%20appears.png?alt=media" alt="" width="563"><figcaption></figcaption></figure>

Final completion of the installation process appears.

<figure><img src="https://884876233-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FdK3XMLdV8zRg847RmGmZ%2Fuploads%2Fgit-blob-4fba02225add10d9a305b3ee1f2866e3b0714344%2Fclaude_7_install_complete.png?alt=media" alt="" width="563"><figcaption></figcaption></figure>

4. Restart Claude.

> **Note**\
> It is recommended to test VibeSec with a prompt such as:
>
> `Create a web form that accepts user input and stores it in the database`,
>
> or
>
> `Create a web form that allows the user to upload a file and store it in the database`.&#x20;