Skip to main content

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.

1

Add the marketplace

In Claude Code, add the OpenAI plugin marketplace:
/plugin marketplace add openai/codex-plugin-cc
2

Install the plugin

Install the Codex plugin from the marketplace:
/plugin install codex@openai-codex
3

Reload plugins

Apply the installation by reloading plugins:
/reload-plugins
4

Run setup

Check whether Codex is ready:
/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:
npm install -g @openai/codex
5

Log in to Codex

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

​
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
/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.

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.

Build docs developers (and LLMs) love

Get started for freeTalk to us