Skip to main content
Claude Code can review pull requests and analyze code for bugs, security issues, and improvements — directly in the terminal.

Reviewing a pull request

The /review command reviews a GitHub pull request. It uses gh pr list and gh pr diff under the hood, so you need the GitHub CLI installed and authenticated. Run /review with no arguments to pick from open PRs interactively:
> /review
Or pass a PR number directly:
> /review 123
Claude will:
  1. Fetch the PR details and diff via gh pr view and gh pr diff
  2. Analyze the changes for code quality, correctness, and potential issues
  3. Present a structured review with an overview, specific suggestions, and risk notes

What Claude checks

Claude’s PR review covers:
  • Code correctness — Logic errors, edge cases, null handling
  • Security — Common vulnerability patterns, hardcoded secrets
  • Performance — Inefficient patterns, potential bottlenecks
  • Test coverage — Whether the changes are adequately tested
  • Project conventions — Consistency with the surrounding codebase style

Reviewing PR comments

The /pr_comments command fetches open GitHub PR review comments and displays them with context:
> /pr_comments
After reviewing comments, ask Claude to address them:
> Address the reviewer's comment about error handling in the login function
> Fix all the PR comments related to type safety

Ad-hoc code review

You can also ask Claude to review code directly in conversation without using /review:
> Review this file for security issues: src/utils/sql.ts
> Does this implementation handle all edge cases?
> Check the authentication module for potential vulnerabilities
This uses Claude’s reasoning directly rather than the gh CLI workflow.

Typical review workflow

1

Make your changes and push

Push your branch and open a PR on GitHub.
2

Run /review

Pass the PR number to get Claude’s assessment:
> /review 42
3

Address issues

Ask Claude to fix issues it found, or fix them yourself.
4

Commit and push

Run /commit and push the follow-up changes.
/review requires the GitHub CLI (gh) to be installed and authenticated. Run gh auth status to check. If you don’t have gh, use ad-hoc review by describing the code you want reviewed directly.

Build docs developers (and LLMs) love