Codex for Claude Code

Bring Codex into Claude Code to review changes or take on delegated development work.

Stars
★ 34k
Last updated
3mo ago
License
Apache-2.0
Primary language
JavaScript

At a glance

How it runs
Agent plugin / skill
Works with
Platform-specificCodex · Claude Code
Cost
Free software; you pay for model usage
Setup effort
Low · running in minutes
You'll need
Node.js 18.18 or laterCodex CLIShell / CLINetwork accessLocal filesystem
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.

  1. A Claude Code user wants a read-only Codex review of uncommitted changes or a branch compared with main.
  2. An engineer preparing a release wants a review that challenges a design choice, tradeoff, or risk area.
  3. A developer facing a build failure or regression wants Codex to investigate or attempt a fix through its subagent.
  4. A user with a long-running review or investigation wants to run it in the background and retrieve its status and final output.
  5. 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-plugins

Then check whether Codex is ready:

/codex:setup

To install Codex yourself, run:

npm install -g @openai/codex

If Codex is installed but not logged in, run:

!codex login

How do you use this agent?

Start a read-only review of the current work:

/codex:review

Review against a base branch or run the review in the background:

/codex:review --base main
/codex:review --background

Delegate an investigation and check its background progress and output:

/codex:rescue --background investigate why the build is failing in CI
/codex:status
/codex:result

Run a steerable review focused on a design decision:

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

To 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?

Pros
  • 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.
Limitations
  • 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?

FollowAgents source review · FARS-2.1
Some gaps
63/ 100 5-point scale 3.2 / 5
Trust 18/29
Reliability 8/14
Adaptability 12/18
Convention 14/18
Effectiveness 7/13
Verifiability 4/8
Why each dimension lost points
Trust18 / 29 · 3.1/5

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.

Reliability8 / 14 · 2.9/5

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.

Adaptability12 / 18 · 3.3/5

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.

Convention14 / 18 · 3.9/5

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.

Effectiveness7 / 13 · 2.7/5

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.

Verifiability4 / 8 · 2.5/5

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.

Risks and how to mitigate them
  • Delegated tasks may attempt code changes; confirm the Codex task scope before using rescue and review its changes when appropriate.
Evidence confidence: Low Reviewed Oct 21, 2026 Reviewed revision db52e28f4d9d
See the full review method →

FAQ

Do I need a separate Codex account for the plugin?
No separate account is needed. If Codex is already signed in on the machine, that authentication works; otherwise, sign in with a ChatGPT account or API key.
Does the plugin use a separate Codex runtime?
No. It uses the local Codex CLI and Codex app server on the same machine, reusing local authentication, configuration, repository checkout, and environment.
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?
A Stop hook runs a targeted Codex review based on Claude's response. If it finds issues, it blocks the stop so Claude can address them. The gate can create a long-running loop and quickly use up limits.
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.
View on GitHub ↗ Install ↓

Compare agents like this one

The same FARS review applied across the shortlist this agent qualifies for.

Related agents