Codex for Claude Code
Bring Codex into Claude Code to review changes or take on delegated development work.
- Source repo
- openai/codex-plugin-cc
- Stars
- ★ 34k
- Last updated
- 3mo ago
- License
- Apache-2.0
- Primary language
- JavaScript
- FA score
- 63/100 · Some gaps
At a glance
- How it runs
- Works with
- Platform-specificCodex · Claude Code
- Cost
- Free software; you pay for model usage
- Setup effort
- Low · running in minutes
- You'll need
- Typical use
- A Claude Code user wants a read-only Codex review of uncommitted changes or a branch compared with
main. - Not a fit if
- Developers who do not use Claude Code
- Teams that cannot send code to Codex for review or delegated work
- Source review
- 63/100 · Some gaps
What does this agent do, and when should you use it?
This Claude Code plugin invokes the local Codex CLI and Codex app server from the workflow you already use. It offers a standard read-only review, a steerable adversarial review, and commands for handing work to the Codex subagent. Long-running jobs can run in the background and be checked, retrieved, or cancelled. The plugin can also import the current Claude Code session into a persistent Codex thread for continuation in Codex. It requires Node.js 18.18 or later and an installed, authenticated Codex CLI; usage counts toward Codex limits.
After installation in Claude Code, /codex:setup checks whether Codex CLI is installed and authenticated; if Codex is missing and npm is available, it can offer to install it. /codex:review performs a read-only review of uncommitted changes or a branch against a chosen base; /codex:adversarial-review also accepts focus text. /codex:rescue delegates investigation, fixes, or follow-up work to the codex:codex-rescue subagent, with options to run in the background, resume a prior task, or start fresh. Use /codex:status, /codex:result, and /codex:cancel to manage background jobs. /codex:transfer imports the current Claude session and prints a codex resume <session-id> command.
- A Claude Code user wants a read-only Codex review of uncommitted changes or a branch compared with
main. - An engineer preparing a release wants a review that challenges a design choice, tradeoff, or risk area.
- A developer facing a build failure or regression wants Codex to investigate or attempt a fix through its subagent.
- A user with a long-running review or investigation wants to run it in the background and retrieve its status and final output.
- Someone who began debugging in Claude Code wants to move that session context into Codex and continue there.
How do you install or deploy this agent?
You need a ChatGPT subscription (including Free) or an OpenAI API key, plus Node.js 18.18 or later. Add the marketplace and install the plugin in Claude Code:
/plugin marketplace add openai/codex-plugin-cc
/plugin install codex@openai-codex
/reload-pluginsThen check whether Codex is ready:
/codex:setupTo install Codex yourself, run:
npm install -g @openai/codexIf Codex is installed but not logged in, run:
!codex loginHow do you use this agent?
Start a read-only review of the current work:
/codex:reviewReview against a base branch or run the review in the background:
/codex:review --base main
/codex:review --backgroundDelegate an investigation and check its background progress and output:
/codex:rescue --background investigate why the build is failing in CI
/codex:status
/codex:resultRun a steerable review focused on a design decision:
/codex:adversarial-review --base main challenge whether this was the right caching and retry designTo transfer the current Claude Code session, run /codex:transfer, then use the printed codex resume <session-id> command to continue in Codex.
What are this agent's strengths and limitations?
- Places read-only review and task-delegation commands directly in the Claude Code workflow.
- Adversarial reviews accept focus text to question design tradeoffs and specified risk areas.
- Long-running tasks support background execution with status, result, and cancellation commands.
- Uses the local Codex CLI, authentication, configuration, and repository environment; runs can be resumed in Codex.
- Requires Claude Code, Node.js 18.18 or later, and a locally installed, authenticated Codex CLI.
- Requires a ChatGPT subscription or OpenAI API key, and usage counts toward Codex limits.
- The plugin depends on Codex and Claude Code; the README does not document native support for other hosts or model providers.
- The optional review gate can create a long-running loop and quickly consume usage limits.
How does this agent compare with similar options?
Key facts side by side with the most closely related agents.
| Agent | Source review | Form / cost | Stars | Updated | Language | Full support on |
|---|---|---|---|---|---|---|
| Codex for Claude Code This agent | 63 · Some gaps | Agent plugin / skillFree + model costs | ★ 34k | 3mo ago | JavaScript | Codex · Claude Code |
| GStack Engineering Workflow | 80 · Good | Agent plugin / skillFree + model costs | ★ 137k | today | TypeScript | Claude Code |
| Claudexor | 76 · Good | CLIFree + model costs | ★ 515 | today | TypeScript | Codex · Claude Code |
| Pilot Shell | 53 · Major gaps | CLIPaid | ★ 2.1k | today | JavaScript | Claude Code |
How does FollowAgents rate this agent?
Why each dimension lost points
The README describes standard and adversarial reviews as read-only, and provides status, result, and cancellation commands for background jobs. Rescue delegates work that may attempt fixes, while setup offers Codex installation as an option, giving some boundaries around permissions and side effects. The README says the plugin uses the local Codex CLI, its authentication state and configuration, and the same repository environment; it also warns that usage counts toward Codex limits. It does not explain sensitive-data handling, retention, or transfer in detail, or give a specific recovery path for delegated edits, so those areas lose points. Repository identity and the supplied official organization provenance support attribution, but no individual maintainer is named.
The README is broadly consistent about command purposes, read-only review, background jobs, and the local CLI. package.json and the CI file also show test and build workflows. Availability depends partly on the user having the Codex CLI installed and authenticated, the required Node.js version, and access to external services; CI installs the CLI without pinning its version. Setup checks readiness, but the supplied evidence does not show what diagnostics users receive for different runtime failures, so failure-message coverage scores lower.
The intended audience and scenarios are clear: Claude Code users who want code review, design challenges, or delegated tasks. The command documentation distinguishes read-only review from rescue work that may attempt a fix, and explains background and wait modes. Invocation is primarily through explicit user commands, with an optional Stop review gate. Use is constrained by Claude Code, Node.js, and a local installed and authenticated Codex CLI; broader environment support is not shown.
The README is organized around installation, commands, typical workflows, configuration, and an FAQ. Prerequisites and installation steps are detailed, with many examples. Command names map clearly to functions, though the supplied files do not establish long-term naming stability. The docs mention limitations such as older Codex versions needing an upgrade, long-running tasks, and the review gate potentially looping and consuming usage. LICENSE and package.json identify Apache-2.0. package.json has a version and version-check script, but the supplied material contains no changelog. The supplied OpenAI organization provenance supports attribution, but no maintainer or update commitment is identified.
The plugin brings Codex review, task delegation, session transfer, and background-job management into Claude Code, with commands to retrieve stored output and resume sessions. Its additional value is primarily workflow integration; the source material provides no outcome or comparison evidence to establish the size of any improvement. The docs warn about Codex usage limits and potentially long-running review-gate loops, but give no concrete cost estimate, so cost-benefit coverage is limited.
Most usage claims can be traced to specific README sections and commands; package.json and CI provide limited corroboration for version, runtime, and automation details. The supplied material does not include implementation source, test contents, or change history, which limits cross-source corroboration. The README makes explicit claims about features and requirements, but this static review cannot independently confirm runtime behavior; those claims are not treated as execution evidence.
- Delegated tasks may attempt code changes; confirm the Codex task scope before using rescue and review its changes when appropriate.
FAQ
Do I need a separate Codex account for the plugin?
Does the plugin use a separate Codex runtime?
Do the review commands change files?
/codex:review and /codex:adversarial-review are read-only and do not fix code. /codex:rescue can be asked to investigate or try a fix.What happens when I enable the review gate?
What does session transfer require?
/codex:transfer uses Codex's external-agent session importer, and the source must be under ~/.claude/projects. Older Codex versions without session import must be upgraded first.