The openai/codex-plugin-cc repository is a JavaScript-based plugin that integrates OpenAI's Codex directly into Claude Code, enabling users to perform code reviews and delegate development tasks without leaving their existing Claude Code workflow. The plugin bridges two separate tools by wrapping the Codex app server and using the global codex binary installed in the user's environment, allowing seamless interaction between Claude Code and Codex through slash commands.
The plugin provides six primary command categories for different use cases. The /codex:review command performs standard read-only code reviews on uncommitted changes or branches compared to a base reference, delivering the same quality as running reviews directly in Codex. The /codex:adversarial-review command offers a steerable alternative that pressure-tests design decisions, tradeoffs, failure modes, and alternative approaches rather than focusing solely on code details. For delegating work, the /codex:rescue command hands tasks to Codex through a subagent, supporting options to investigate bugs, attempt fixes, continue previous tasks, or use smaller models for faster or cheaper passes. The /codex:transfer command creates a persistent Codex thread from the current Claude Code session, allowing users to continue debugging or implementation conversations directly in Codex while preserving context. The /codex:status and /codex:result commands manage background work by showing running and recent jobs or displaying final output from completed tasks. The /codex:cancel command stops active background jobs, and /codex:setup checks installation status and authentication while optionally enabling a review gate that uses targeted Codex reviews to block Claude responses if issues are detected.
Installation requires a ChatGPT subscription or OpenAI API key, Node.js 18.18 or later, and involves adding the marketplace in Claude Code, installing the plugin, and running /codex:setup to verify readiness. The plugin automatically detects and uses existing Codex authentication and configuration from the user's local environment, including user-level settings in ~/.codex/config.toml and project-level overrides in .codex/config.toml. Users can customize default reasoning effort and model selection through these configuration files.
The plugin supports background execution for long-running tasks, allowing users to check progress asynchronously rather than blocking their Claude Code session. Code reviews, particularly for multi-file changes, are noted as potentially time-consuming operations best run in the background. The /codex:transfer functionality leverages Codex's external-agent session importer, following the same conversion rules as importing Claude history in the Codex App, and enables resuming work directly in Codex using session IDs obtained from /codex:result or /codex:status commands.
The plugin uses the same local Codex CLI and app server as direct Codex usage, meaning it respects existing authentication, configuration, and API key setups without requiring separate Codex accounts or runtimes. This design ensures that users already familiar with Codex can immediately apply their existing setup within Claude Code, while new users can authenticate through either ChatGPT accounts or API keys via the codex login command.
