Claude Codeでコードレビューする方法

Claude Code のコードレビューは2種類

Claude Code でのレビューには、手元で実行するコマンドと、GitHub で動くマネージドサービスの2つがあり、使える人も読むファイルも違います。

/code-review でローカルレビューする手順

1. 変更を用意する：いつもどおりブランチで作業します。対象を指定しなければ、上流ブランチより先にあるコミットと未コミットの変更がレビューされます。
2. /code-review を実行する：Claude Code で /code-review（または /review）と入力します。バックグラウンドのサブエージェントとして動き、CLAUDE.md に従います。
3. 対象と effort を調整する：low から max までの effort を選び、PR、ブランチ、パス、コミット範囲を対象に指定します。--max-findings で報告する指摘の数を変えられます。
4. 修正するか PR に投稿する：--fix で指摘を作業ツリーに反映し、--comment で GitHub の PR にインラインコメントとして投稿します。
5. 重要な変更はさらに深くレビューする：/code-review ultra でクラウドの ultrareview を実行し、スクリプトや CI からは claude ultrareview を使います。

ターミナルでは、レビューは自分のコンテキストウィンドウを持つバックグラウンドのサブエージェントとして動くので、会話を埋めることなく作業を続けられます。結果は終わり次第、会話に届きます。ブランチに上流がない場合はmain または直前のコミットと比較します。

コマンドを打たなくても、「この変更をレビューして」と普通の言葉で頼めば Claude がスキルを起動することがあります。デスクトップアプリでは、指摘がファイルの位置、1文の要約、correctness などのカテゴリ付きの一覧として表示されます。

/code-review が最も役立つのは、まだ手元で作業しているときです。プッシュ前に実行し、指摘を直してからPRを開けば、レビューの往復が減ります。レビューは自分のセッションで動くため、セッションのほかの作業と同じく、プランの使用量または API の利用料金にカウントされます。

レビュー対象と effort の選び方

effort と各種フラグのあとに書いたテキストが、レビュー対象になります。

• /code-review 1234：PR #1234 をレビュー
• /code-review main...my-feature：ブランチ同士を比較
• /code-review HEAD~15..HEAD：直近15コミットをレビュー
• /code-review abc1234^..abc1234：1つのコミットをレビュー
• /code-review src/auth：ファイルやディレクトリをレビュー

effort は網羅性と確信度のトレードオフです。low では最も確信の高い指摘だけを報告するので、誤検知が少なくなります。medium から max に上げるほど範囲が広がり、確信度のやや低い指摘も含めて多く報告します。小さな変更には low、認証やマイグレーションのようにリスクの高い変更をマージする前には高めの effort が向いています。effort を指定しないと、以前のセッションも含めて最後に入力した effort が再利用され、そのことが通知されます。

報告する指摘の数は --max-findings <n> で変えられ、--max-findings all ですべての指摘を、--max-findings default で通常の上限に戻せます。

PR にコメントする・そのまま修正させる

--comment を付けると、指摘を GitHub のPRにインラインコメントとして投稿します。GitLab のマージリクエストには glab CLI を通じて1つのノートとして投稿します。--fix を付けると、レビューのあとに指摘を作業ツリーへ反映します。

--fix を使う前に知っておきたいことが2つあります。1つ目は、編集が通常の権限モードを通ることです。2つ目は、バックグラウンドのレビューによる編集はセッションのチェックポイントの外で行われるため、/rewind では元に戻らないことです。取り消すときは git を使ってください。

さらに深く見たい変更には、/code-review ultra でクラウドの ultrareview を実行できます。スクリプトや CI からは claude ultrareview を使います。ultrareview には claude.ai アカウントでのログインが必要で、Amazon Bedrock、Google Cloud の Agent Platform、Microsoft Foundry、ゼロデータ保持や HIPAA 構成の組織では、代わりにローカルのレビューが実行されます。

セキュリティレビューと自作のレビュアー

セキュリティに絞ったレビューには /security-review コマンドがあります。CI で動かしたい場合は、Anthropic が公開している claude-code-security-review という GitHub Action を Claude の API キーで使えます。ただし、その README にはプロンプトインジェクション攻撃への対策は施されていないと明記されているので、信頼できないPRに使うときは注意が必要です。

/code-review は同梱スキルなので、ディスク上に編集できる SKILL.md はありません。すべてのレビューに守らせたいルールは CLAUDE.md に書きます。レビューの進め方そのものを変えたいなら、次の方法があります。

• コマンドを置き換える：プロジェクトか個人のスキルに code-review という名前を付けると、同梱版の代わりに実行されます。/review の別名は同梱版を実行し続けます。
• レビュー用のサブエージェントやスキルを作る：チームのレビュー観点を書いたサブエージェントを用意し、PRのURLを渡してコメントさせる運用もできます。

Claude Code Review で GitHub の PR を自動レビューする

Code Review は Anthropic が提供する GitHub 向けのマネージドなレビュアーです。2026年10月15日にリサーチプレビューを終えて一般提供となり、Claude Team と Enterprise の組織で使えます。一般提供にあわせて、1回のレビューにかかる時間は約20分から約6〜10分に短くなりました。

複数のエージェントが差分と周辺のコードを並行して調べ、検証の工程で誤検知を取り除いたうえで、重複を除いて深刻度順に並べ、PRに投稿します。設定には、Claude 組織の Owner、Claude GitHub App をインストールする GitHub 組織のオーナー、追加する各リポジトリへの書き込み権限が必要です。リポジトリにワークフローファイルを追加する必要はありません。

1. 有効にする：claude.ai の Admin settings > Claude Code で Allow code review をクリックし、GitHub アカウントを接続します。
2. Claude GitHub App をインストールする：GitHub 組織にインストールし、アクセスできるリポジトリを選びます。
3. リポジトリとレビューレベルを選ぶ：Quick、Standard（既定）、Deep から組織の既定を選び、リポジトリごとに変えられます。
4. レビューのタイミングを決める：PR作成時に1回、プッシュのたび（新しいリポジトリの既定）、依頼されたときだけ、から選びます。
5. 試す：ドラフトではないPRを作ると、数分以内に Claude Code Review というチェックランが表示されます。

書き込み権限のある人は、@claude review で1回のレビューを、@claude review always でそのPRへの以降のプッシュすべてのレビューを依頼できます。自動レビューはドラフトとフォークからのPRを対象外にしますが、コメントでの依頼はどちらにも使えます。GitHub Enterprise Server にも対応しています。ゼロデータ保持、HIPAA 構成、顧客管理の暗号鍵（CMEK）を使う組織では利用できません。

指摘の読み方：Important・Nit・Pre-existing

• 🔴 Important：マージ前に直すべきバグ。
• 🟡 Nit：直したほうがよいが、マージを止めるほどではない軽微な問題。
• 🟣 Pre-existing：このPRが持ち込んだのではなく、もともとコードにあったバグ。

指摘の Why this was flagged を開くと、Claude がどう検証したかを確認できます。指摘を却下するにはスレッドを解決します（返信だけでは解決になりません）。修正をプッシュすると、次のレビューで直ったと判断されたスレッドが解決されます。以降の自動レビューは変更箇所に絞り、Nit も少なくなるので、PR全体を見直してほしいときは @claude review とコメントします。

チェックランは失敗（failure）にならないため、それだけではマージを止められません。マージの条件にしたい場合、Anthropic はチェックランの Details の最終行にある JSON の深刻度別件数を読む方法を案内しています。normal の件数が1以上なら、Important の指摘が少なくとも1件あるという意味です。

CLAUDE.md と REVIEW.md にレビュー観点を書く

2つのレビューは読むファイルが違います。/code-review が従うのは CLAUDE.md だけで、Code Review は CLAUDE.md をプロジェクトの文脈として、REVIEW.md をレビュー専用の指示として読みます。どちらにも効かせたいルールは CLAUDE.md に、何を指摘するか、どの深刻度にするか、何を対象外にするかは REVIEW.md に書きます。

# Review instructions

## このリポジトリでの Important の定義
Important は、動作が壊れる、データが漏れる、後方互換性のない
マイグレーションに限る。命名やスタイルは Nit まで。

## Nit の上限
Nit は1回のレビューで5件まで。

## 指摘しないこと
- lint、フォーマット、型エラー（CI で検出している）
- src/gen/ 以下の生成ファイル

## 必ず確認すること
- データベースのクエリが呼び出し元のテナントに絞り込まれているか

Code Review は REVIEW.md をPRからではなく、ベースブランチかデフォルトブランチから読みます。変更はマージしてから反映されます。深刻度の引き下げ、パスの除外、Nit の上限は、保護されたデフォルトブランチのファイルにだけ適用されるので、ブランチ保護も設定してください。サブディレクトリに REVIEW.md を置くとそのパスの変更向けのチェックを追加でき、ルートの REVIEW.md には @ファイル名 の行でほかのファイルを取り込めます。

Claude Code Review の料金

1回あたりの定額はなく、トークン使用量に応じて使用クレジットから課金されます。プランに含まれる使用量とは別枠で、開発者ではなく組織に請求されます。費用はレビューレベル、変更の大きさ、周辺コードの複雑さ、検証が必要な候補の数で増えます。リサーチプレビュー中、Anthropic はレビュー1回の平均を15〜25ドルと公表していました。一般提供時には、対象の Enterprise 組織に少なくとも1万ドル分の Code Review クレジットを提供しています（2027年1月15日までに申請）。

レビューのタイミングも費用に効きます。プッシュのたびにレビューすると、費用はプッシュの回数だけ増えます。Anthropic は、数個のリポジトリで「PRごとに1回」か「依頼時のみ」で試し、管理画面の Average cost 列に月間のPR数を掛けて見積もる方法を勧めています。月の支出上限を設定でき、上限や組織の上限、クレジット残高に達するとレビューはスキップされ、その理由がPRにコメントされます。

別モデルのレビュアーを組み合わせる

Claude Code がコードの大半を書いているなら、別のモデルで作られたレビュアーが、書き手のモデルの見落としに気づける可能性があります。モデルの多様性は盲点をあぶり出す手段で、見落としがなくなる保証ではありません。次のような場合は、独立したレビュアーを加える価値があります。

• 複数のエージェントと人が、同じリポジトリでコードを書いている。
• 誰が作ったPRでも、同じ基準でレビューしたい。
• Claude Team や Enterprise を使っていない、またはトークン課金ではなく毎月の費用を見通したい。
• コメントだけでなく、PRがマージできる状態になるまで修正を進めたい。

HeyDeer はすべてのPRをレビューし、各指摘を別のモデルでコードと照合して検証します。REVIEW.md と AGENTS.md を読み、見つけた問題を修正することもできます。Claude Code 用の REVIEW.md はそのまま使え、Important は HeyDeer の中以上、Nit は低に相当します。リポジトリのレビューの言語を日本語にすれば、指摘もすべて日本語で投稿されます。

HeyDeer は REVIEW.md をベースブランチではなくPRから読み、@file の取り込みには対応していないので、その内容は REVIEW.md に移してください。詳しくは REVIEW.md のドキュメント に、料金の比較は HeyDeer vs Claude Code Review にまとめています。エージェントが書いたPRのレビューについては コーディングエージェントのPRレビュー を、Codex での同様の使い方は Codex でコードレビューする方法 を、AIレビューの全体像は AIコードレビューとは と AIコードレビューツールの比較 をご覧ください。

参考資料

1. Claude Code Docs: Review code locally (/code-review)
2. Claude Code Docs: Code Review
3. Claude Code Docs: Set up Code Review
4. Claude Code Docs: Customize Code Review (REVIEW.md and CLAUDE.md)
5. Claude Code Docs: Read and request reviews on a pull request
6. Claude Code Docs: Code Review costs
7. Anthropic: Code Review is now generally available (October 15, 2026)
8. Anthropic: Code Review launch (March 9, 2026)
9. GitHub: anthropics/claude-code-security-review