codex-plugin-cc

---
name: codex-plugin-cc
description: Use when you want Claude Code to hand code review, adversarial review, or delegated implementation work to Codex without leaving your Claude workflow.
source: https://github.com/openai/codex-plugin-cc
generated: 2026-05-17T04:18:16.973Z
category: tool
audience: engineers
---

## When to use

- Running a Codex code review on current uncommitted changes or a branch compared with a base ref
- Pressure-testing an implementation with an adversarial review focused on tradeoffs, assumptions, race conditions, reliability, or security
- Delegating a bug investigation, small fix, or long-running background task from Claude Code to Codex
- Checking, retrieving, canceling, or resuming Codex background jobs from inside Claude Code

## Key concepts

### Claude Code plugin

The plugin installs into Claude Code through the plugin marketplace and adds `/codex:*` slash commands plus a `codex:codex-rescue` subagent.

### Review commands

`/codex:review` runs a normal read-only Codex review, while `/codex:adversarial-review` challenges implementation direction, assumptions, and risk areas.

### Rescue delegation

`/codex:rescue` hands a task to Codex, with support for background runs, waiting, resuming a prior thread, starting fresh, and selecting model or reasoning effort.

### Job control

`/codex:status`, `/codex:result`, and `/codex:cancel` let Claude Code manage running and recent Codex jobs for the current repository.

### Local Codex runtime

The plugin wraps the local Codex CLI and app server, so it uses the same Codex install, authentication, repository checkout, and config you use directly.

## API reference

```
Install marketplace and plugin
```

Add OpenAI's Codex plugin marketplace to Claude Code, install the `codex` plugin, and reload plugins.

```
/plugin marketplace add openai/codex-plugin-cc
/plugin install codex@openai-codex
/reload-plugins
```

```
/codex:setup
```

Check whether Codex is installed and authenticated. If Codex is missing and npm is available, setup can offer to install it.

```
/codex:setup
npm install -g @openai/codex
!codex login
```

```
/codex:review [--base <ref>] [--background | --wait]
```

Run a read-only Codex review of current changes or a branch comparison.

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

```
/codex:adversarial-review [--base <ref>] [--background | --wait] [focus]
```

Run a steerable review that challenges the design, assumptions, and risk profile of the work.

```
/codex:adversarial-review --base main challenge whether this caching and retry design is safe
/codex:adversarial-review --background look for race conditions
```

```
/codex:rescue [--background | --wait] [--resume | --fresh] [--model <model>] [--effort <effort>] <task>
```

Delegate an investigation, fix, or continuation task to Codex.

```
/codex:rescue investigate why the build is failing in CI
/codex:rescue --model gpt-5.4-mini --effort medium investigate the flaky integration test
/codex:rescue --resume apply the top fix from the last run
```

```
/codex:status | /codex:result | /codex:cancel
```

Inspect running jobs, retrieve completed Codex output, or cancel an active background job.

```
/codex:status
/codex:result
/codex:cancel task-abc123
```

## Gotchas

- You need a ChatGPT subscription, including Free, or an OpenAI API key; usage contributes to your Codex usage limits.
- Node.js 18.18 or later is required for the plugin.
- The plugin uses your local Codex CLI authentication and configuration, so run `codex login` if Codex is not already ready on the machine.
- Review and rescue jobs can take a while, especially for multi-file changes, so background mode is usually the better workflow.
- The optional review gate can create long-running Claude/Codex loops and drain usage limits; enable it only when actively monitoring.

---
Generated by SkillMake from https://github.com/openai/codex-plugin-cc on 2026-05-17T04:18:16.973Z.
Verify against source before relying on details.

File: ~/.claude/skills/codex-plugin-cc/SKILL.md