Codex Plugin for Claude Code

Use Codex from inside Claude Code for code reviews or to delegate tasks to Codex.

26,850
Stars
1,623
Forks
80
Subscribers

What You Get

/codex:review

Normal read-only Codex review for your current work or branch comparison

/codex:adversarial-review

Steerable challenge review that questions implementation and design choices

/codex:rescue

Delegate tasks to Codex through the codex:codex-rescue subagent

/codex:transfer

Create persistent Codex thread from current Claude Code session

/codex:status

Shows running and recent Codex jobs for the current repository

/codex:cancel

Cancels an active background Codex job

Requirements

Before you begin, ensure you have:

  • ChatGPT subscription (incl. Free) or OpenAI API key. Usage will contribute to your Codex usage limits. Learn more
  • Node.js 18.18 or later

Install

Add the marketplace in Claude Code:

/plugin marketplace add openai/codex-plugin-cc

Install the plugin:

/plugin install codex@openai-codex

Reload plugins:

/reload-plugins

Then run:

/codex:setup

/codex:setup will tell you whether Codex is ready. If Codex is missing and npm is available, it can offer to install Codex for you.

If you prefer to install Codex yourself, use:

npm install -g @openai/codex

If Codex is installed but not logged in yet, run:

!codex login

Usage Examples

/codex:review

Runs a normal Codex review on your current work. Use it for reviews of uncommitted changes or branch comparisons.

/codex:review /codex:review --base main /codex:review --background

/codex:adversarial-review

Runs a steerable review that questions implementation and design choices.

/codex:adversarial-review /codex:adversarial-review --base main challenge whether this was the right caching design

/codex:rescue

Hands a task to Codex through the codex:codex-rescue subagent.

/codex:rescue investigate why the tests started failing /codex:rescue fix the failing test with the smallest safe patch

FAQ

Do I need a separate Codex account for this plugin?

If you are already signed into Codex on this machine, that account should work immediately. This plugin uses your local Codex CLI authentication. If you only use Claude Code today and have not used Codex yet, you will need to sign in to Codex with either a ChatGPT account or an API key.

Does the plugin use a separate Codex runtime?

No. This plugin delegates through your local Codex CLI and Codex app server on the same machine. It uses the same Codex install, authentication state, repository checkout, and machine-local environment.

Will it use the same Codex config I already have?

Yes. If you already use Codex, the plugin picks up the same configuration. You can define your default reasoning effort or model in your user-level or project-level config.toml.