> ## Documentation Index
> Fetch the complete documentation index at: https://mintlify.com/openai/codex-plugin-cc/llms.txt
> Use this file to discover all available pages before exploring further.

# Quick Start

> Install the Codex plugin and run your first code review in minutes.

<Steps>
  <Step title="Add the marketplace">
    In Claude Code, add the OpenAI plugin marketplace:

    ```bash theme={null}
    /plugin marketplace add openai/codex-plugin-cc
    ```
  </Step>

  <Step title="Install the plugin">
    Install the Codex plugin from the marketplace:

    ```bash theme={null}
    /plugin install codex@openai-codex
    ```
  </Step>

  <Step title="Reload plugins">
    Apply the installation by reloading plugins:

    ```bash theme={null}
    /reload-plugins
    ```
  </Step>

  <Step title="Run setup">
    Check whether Codex is ready:

    ```bash theme={null}
    /codex:setup
    ```

    `/codex:setup` tells you whether Codex is installed and authenticated. If Codex is missing and npm is available, it can offer to install Codex for you automatically.

    If you prefer to install Codex yourself, run:

    ```bash theme={null}
    npm install -g @openai/codex
    ```
  </Step>

  <Step title="Log in to Codex">
    If Codex is installed but not yet authenticated, run:

    ```bash theme={null}
    !codex login
    ```

    `codex login` supports sign-in with a ChatGPT account (including the Free tier) or an OpenAI API key. Alternatives:

    ```bash theme={null}
    !codex login --device-auth
    !codex login --with-api-key
    ```
  </Step>
</Steps>

## Verify your setup

After installation, you should see:

* The slash commands (`/codex:review`, `/codex:adversarial-review`, `/codex:rescue`, `/codex:status`, `/codex:result`, `/codex:cancel`, `/codex:setup`) available in Claude Code
* The `codex:codex-rescue` subagent listed under `/agents`

If either is missing, run `/reload-plugins` and then `/codex:setup` again.

## First run

<Note>
  Code review for multi-file changes can take a while. Running in the background is generally recommended.
</Note>

The simplest way to try the plugin is a background review followed by a status check and result fetch:

```bash theme={null}
/codex:review --background
/codex:status
/codex:result
```

`/codex:review --background` starts a Codex code review without blocking your session. Use `/codex:status` to check progress and `/codex:result` to read the output once it finishes.

<CardGroup cols={2}>
  <Card title="Review your code" icon="magnifying-glass" href="/commands/review">
    Run a standard or adversarial Codex review against your current changes.
  </Card>

  <Card title="Delegate a task to Codex" icon="arrow-right-arrow-left" href="/commands/rescue">
    Hand off a bug investigation or fix to Codex and monitor it in the background.
  </Card>

  <Card title="Running jobs in the background" icon="clock" href="/guides/background-jobs">
    Learn how background mode works and how to manage long-running Codex tasks.
  </Card>

  <Card title="Common workflows" icon="list-check" href="/guides/typical-flows">
    See end-to-end examples for review, delegation, and iterative workflows.
  </Card>
</CardGroup>