codex-plugin-claude-code
v1.0.6
Published
Use Claude Code from Codex to review code or delegate tasks.
Maintainers
Readme
Claude Code Plugin For Codex
Use Claude Code from inside Codex for code reviews, adversarial reviews, delegated implementation tasks, and background job control.
What You Get
claude-reviewfor a normal read-only Claude reviewclaude-adversarial-reviewfor a steerable challenge reviewclaude-rescue,claude-status,claude-result, andclaude-cancelto delegate work and manage background jobsclaude-setupfor readiness checks and review-gate settings
Requirements
- Claude Code installed and authenticated
- Node.js 18.18 or later
Install Claude Code if needed:
npm install -g @anthropic-ai/claude-codeThen authenticate:
claude auth loginInstall
Add this repository as a Codex plugin marketplace:
codex plugin marketplace add https://github.com/moabualruz/claude-plugin-codexFor local development, pass the repository path instead. Install or enable the claude plugin from that marketplace in Codex, then start a new Codex session so the skills load.
The npm package is codex-plugin-claude-code. Codex marketplace installation currently uses the GitHub repository or a local marketplace path, so the npm package is published for package distribution and metadata, not as the primary Codex install transport.
Run:
claude-setupUsage
claude-review
Runs a read-only Claude review on your current work.
Examples:
claude-review
claude-review --base main
claude-review --backgroundclaude-adversarial-review
Runs a review that challenges the implementation approach, design choices, tradeoffs, and assumptions.
Examples:
claude-adversarial-review
claude-adversarial-review --base main challenge the caching and retry design
claude-adversarial-review --background look for race conditionsclaude-rescue
Delegates investigation, implementation, or follow-up work to Claude Code.
Examples:
claude-rescue investigate why the tests started failing
claude-rescue --write fix the failing test with the smallest safe patch
claude-rescue --resume apply the top fix from the last run
claude-rescue --background investigate the regressionclaude-status
Shows active and recent Claude jobs for the current repository.
claude-status
claude-status task-abc123
claude-status task-abc123 --waitclaude-result
Shows stored output for a finished Claude job.
claude-result
claude-result task-abc123claude-cancel
Cancels an active background Claude job.
claude-cancel
claude-cancel task-abc123claude-setup
Checks whether Claude Code is installed and authenticated. It can also toggle the optional stop-time review gate:
claude-setup --enable-review-gate
claude-setup --disable-review-gateRuntime
The plugin launches your local claude binary with claude -p --output-format stream-json and sends the prompt over stdin. Reviews run with edit tools disabled. Delegated tasks run read-only by default; pass --write when Claude should be allowed to edit files.
Adversarial reviews ask Claude for structured JSON. The runtime accepts raw JSON, fenced JSON, and bare JSON after preamble text, then prefers the latest object-shaped response so corrected Claude output is handled cleanly.
Job state is stored per repository so background output can be retrieved in later Codex turns.
