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

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

Summary

The `codex-plugin-cc` repository offers a powerful integration for Claude Code users, enabling them to leverage OpenAI's Codex directly within their existing workflow. This plugin facilitates AI-powered code reviews, task delegation, and background job management, streamlining development processes. It provides a suite of commands for various review types and task handling, significantly enhancing developer productivity.

Repository Info

Updated on May 25, 2026
View on GitHub

Tags

JavaScriptAICode ReviewDevelopment ToolsPluginsOpenAICodexClaude Code

Click on any tag to explore related repositories

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:

  1. Add the marketplace in Claude Code:

    /plugin marketplace add openai/codex-plugin-cc

  2. Install the plugin:

    /plugin install codex@openai-codex

  3. Reload plugins:

    /reload-plugins

  4. Run setup:

    /codex:setup

    This command checks if Codex is ready and can offer to install it if missing and npm is available.

  5. Optional: Manual Codex CLI installation:
    If you prefer to install Codex yourself, use:

    npm install -g @openai/codex

  6. 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.

Links