Skip to main content
1

Add the marketplace

In Claude Code, add the OpenAI plugin marketplace:
2

Install the plugin

Install the Codex plugin from the marketplace:
3

Reload plugins

Apply the installation by reloading plugins:
4

Run setup

Check whether Codex is ready:
/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:
5

Log in to Codex

If Codex is installed but not yet authenticated, run:
codex login supports sign-in with a ChatGPT account (including the Free tier) or an OpenAI API key. Alternatives:

​
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

Code review for multi-file changes can take a while. Running in the background is generally recommended.
The simplest way to try the plugin is a background review followed by a status check and result fetch:
/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.

Review your code

Run a standard or adversarial Codex review against your current changes.

Delegate a task to Codex

Hand off a bug investigation or fix to Codex and monitor it in the background.

Running jobs in the background

Learn how background mode works and how to manage long-running Codex tasks.

Common workflows

See end-to-end examples for review, delegation, and iterative workflows.