codex-plugin-cc: Integrate OpenAI Codex for Code Reviews in Claude Code

Introduction

The codex-plugin-cc is a plugin designed for Claude Code users who want to seamlessly integrate OpenAI's powerful Codex into their development workflow. It allows developers to perform AI-powered code reviews, delegate tasks, and manage background jobs directly from Claude Code, enhancing efficiency and code quality. This plugin provides a set of slash commands to interact with Codex for various operations, from standard code reviews to more complex task delegation and issue investigation.

Key features include:

/codex:review for standard code reviews.
/codex:adversarial-review for challenging design decisions and risk areas.
/codex:rescue to delegate tasks like bug investigation or fixes to Codex.
Commands to manage background jobs: /codex:status, /codex:result, /codex:cancel.

To use this plugin, you will need a ChatGPT subscription (including Free) or an OpenAI API key, and Node.js 18.18 or later.

Installation

Getting started with codex-plugin-cc in Claude Code is straightforward. Follow these steps:

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
```
Run setup:
```
/codex:setup
```
This command checks if Codex is ready and can offer to install it if missing and npm is available.
Optional: Manual Codex CLI installation:
If you prefer to install Codex yourself, use:
```
npm install -g @openai/codex
```
Login to Codex (if not already logged in):
```
!codex login
```
This will authenticate your Codex CLI with your ChatGPT subscription or OpenAI API key.

Examples

The codex-plugin-cc offers a variety of commands to interact with Codex. Here are some common use cases:

Standard Code Review

Perform a quick review of your current uncommitted changes:

/codex:review

Review your branch compared to a base branch like main:

/codex:review --base main

Adversarial Review

Challenge design choices, tradeoffs, or specific risk areas:

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

Look for race conditions and question the chosen approach:

/codex:adversarial-review --background look for race conditions and question the chosen approach

Delegate Tasks to Codex

Ask Codex to investigate a bug:

/codex:rescue investigate why the tests started failing

Request a fix for a failing test:

/codex:rescue fix the failing test with the smallest safe patch

Continue a previous Codex task:

/codex:rescue --resume apply the top fix from the last run

Managing Background Jobs

For long-running tasks, it is recommended to run them in the background:

/codex:review --background
/codex:rescue --background investigate the flaky test

Check the status of running jobs:

/codex:status

View the final output of a completed job:

/codex:result

Cancel an active background job:

/codex:cancel

Why Use It

Integrating codex-plugin-cc into your Claude Code workflow brings several significant advantages:

Enhanced Code Quality: Leverage OpenAI's Codex for thorough and intelligent code reviews, catching potential issues early in the development cycle.
Streamlined Development: Delegate complex or time-consuming tasks, such as bug investigations or refactoring, directly to Codex, freeing up developer time.
Deep Design Analysis: Utilize adversarial reviews to pressure-test architectural decisions, identify hidden assumptions, and explore alternative approaches, leading to more robust solutions.
Efficient Workflow: Manage AI-powered tasks seamlessly within your existing Claude Code environment, including running jobs in the background and monitoring their progress.
Leverage Existing Setup: The plugin uses your local Codex CLI, respecting your existing authentication and configuration, ensuring a consistent experience.
Flexibility: Choose between different review types and task delegation options, adapting Codex's capabilities to your specific needs.