This plugin integrates OpenAI's Codex capabilities directly into the Claude Code IDE, enabling users to perform code reviews, delegate complex tasks, and pressure-test code implementations without leaving their existing workflow. It benefits Claude Code users by providing seamless access to powerful AI-driven code analysis and task automation, enhancing productivity and code quality.

How It Works

The plugin acts as a bridge, exposing Codex functionalities through familiar slash commands within Claude Code. It leverages the globally installed codex CLI binary and communicates with the local Codex app server, ensuring consistency with existing Codex configurations and authentication. This approach allows for direct delegation of tasks like code reviews (/codex:review, /codex:adversarial-review) and bug investigations (/codex:rescue) to the Codex backend, processing them locally.

Quick Start & Requirements

• Primary install / run command:
  1. Add marketplace: /plugin marketplace add openai/codex-plugin-cc
  2. Install plugin: /plugin install codex@openai-codex
  3. Reload plugins: /reload-plugins
  4. Run setup: /codex:setup (can offer to install Codex if missing and npm is available)
  5. Login if needed: !codex login
• Non-default prerequisites and dependencies:
  • Node.js 18.18 or later.
  • ChatGPT subscription or OpenAI API key (usage contributes to Codex limits).
  • Local Codex installation and authentication.
• Links:
  • Codex usage limits: Learn more (Note: Actual link not provided, inferred from context)
  • Codex documentation: Codex docs (Note: Link provided is for Copilot, assuming Codex docs are similar or related)

Highlighted Details

• Offers two distinct review modes: standard /codex:review for general feedback and /codex:adversarial-review for deep dives into design, tradeoffs, and risks, supporting branch comparisons (--base <ref>).
• Provides task delegation via /codex:rescue, allowing users to investigate bugs, attempt fixes, or continue previous Codex tasks with options for specific models (--model) and effort levels (--effort).
• Includes job management commands (/codex:status, /codex:result, /codex:cancel) for tracking and controlling background operations.
• Features an optional "review gate" (/codex:setup --enable-review-gate) that integrates Codex reviews into Claude Code's stop process, potentially blocking code commits until reviews pass.

Maintenance & Community

No specific details regarding maintainers, community channels (like Discord/Slack), or project roadmap were found in the provided README.

Licensing & Compatibility

• License type: The license is not explicitly stated in the README.
• Compatibility notes: Compatible with Claude Code and leverages existing local Codex installations, CLI configurations, and authentication methods.

Limitations & Caveats

Code reviews, particularly for multi-file changes, may require significant time, making background execution recommended. The optional review gate feature can lead to prolonged interaction loops and rapid consumption of usage limits, necessitating active user monitoring. The plugin's functionality is dependent on a correctly configured local Codex environment. The absence of a specified license may pose adoption risks for commercial or sensitive projects.