Run a multi-round code review loop where Claude Code reviews code non-interactively. Designed for use inside Codex — Codex writes code, Claude reviews it, Codex incorporates feedback, repeat.
Prerequisites
claudeCLI installed and authenticated (Claude Code)- Current directory must be a code project
Trigger
Activate when the user mentions "claude review", "let claude review", "claude take a look", or wants Claude to review code.
Usage
/claude-review [scope] [focus]
- scope (optional): what to review
uncommitted(default) — review working tree changescommit— review the last commitbranch— review current branch vs main
- focus (optional): custom review instructions
Examples:
/claude-review
/claude-review branch focus on error handling
/claude-review commit check for security issues
Workflow
Step 1: Initial Review
Build the review command based on scope:
# For uncommitted changes (default)
git diff --no-color HEAD | claude -p "Review this diff. Focus on: bugs, security, error handling, edge cases. Be specific about file and line. Output findings as a numbered list. ${FOCUS}"
# For last commit
git show --no-color HEAD | claude -p "Review this commit. ${FOCUS}"
# For branch vs main
git diff --no-color main...HEAD | claude -p "Review these branch changes. ${FOCUS}"
If there's no diff, check for untracked files:
git diff --no-color && git diff --no-color --cached && git ls-files --others --exclude-standard
Parse Claude's output — it returns a markdown review with findings.
Step 2: Evaluate Findings
Read Claude's review output. Categorize:
- Critical — bugs, security, data loss → must fix
- Important — performance, error handling → should fix
- Suggestions — style, naming → nice to have
If no significant issues found, report "Claude approved" and stop.
Step 3: Fix Issues
Apply fixes for Critical and Important findings. Skip style-only suggestions unless the user asked.
Step 4: Re-review
Run the review again with context from previous round:
git diff --no-color HEAD | claude -p "Previous review found these issues: [summary]. Verify they are fixed and check for new issues. ${FOCUS}"
Step 5: Loop Control
- Max rounds: 3 (default)
- Exit conditions:
- Claude reports no significant issues
- Max rounds reached
- User interrupts
Step 6: Summary
Present:
- Total rounds
- Issues found/fixed per round
- Remaining suggestions
- Final verdict
Notes
claude -pruns non-interactively (print mode) — outputs review and exits- Each call is stateless; pass previous context via the prompt
- The review sees the current working tree, so all Codex edits are visible
- If
claudeis not installed, tell the user to install Claude Code - Works in both Codex and any other agent that can run shell commands