Claude Code のコードレビューをセットアップする

Code Review は GitHub のプルリクエストを分析し、問題が見つかったコード行にインラインコメントとして結果を投稿します。特化したエージェントのチームが、完全なコードベースのコンテキスト内でコード変更を検査し、ロジックエラー、セキュリティ脆弱性、壊れたエッジケース、リグレッションを探します。

この記事では、Code Review を有効にする方法、レビュートリガーを設定する方法、フラグが立つ内容をカスタマイズする方法、一般的なセットアップの問題をトラブルシューティングする方法について説明します。

注:Code Review は Team および Enterprise プランで利用可能です。ゼロデータ保持が有効になっている組織では利用できません。Code Review の使用量は使用クレジットを通じて個別に請求され、プランに含まれる使用量にはカウントされません。

Code Review の仕組み

組織が Code Review を有効にすると、プルリクエストが開かれたとき、すべてのプッシュ時、または誰かが手動でレビューをリクエストしたときに自動的にトリガーできます。レビューが実行されると、複数のエージェントが並行して diff と周囲のコードを分析します。各エージェントは異なるクラスの問題を探し、その後、検証ステップが結果を実際のコード動作と照らし合わせて、誤検知を除外します。

検出結果は重複排除され、重大度でランク付けされ、問題が見つかった特定の行にインラインコメントとして投稿されます。問題が見つからない場合、Claude は PR に短い確認コメントを投稿します。レビューは PR を承認またはブロックしないため、既存のレビューワークフローはそのまま機能します。

レビューのコストは PR のサイズと複雑さに応じてスケーリングされ、平均 20 分で完了します。

重大度レベル

各検出結果には重大度レベルがタグ付けされます:

マーカー	重大度	意味
🔴	通常	マージ前に修正すべきバグ
🟡	軽微な問題	軽微な問題で、修正する価値はありますがブロッキングではありません
🟣	既存の問題	コードベースに存在するが、この PR で導入されなかったバグ

検出結果には、展開可能な拡張推論セクションが含まれており、Claude がその問題にフラグを立てた理由と問題を検証した方法を確認できます。

Code Review がチェックする内容

デフォルトでは、Code Review は正確性に焦点を当てています。本番環境を破壊するバグであり、フォーマット設定の好みやテストカバレッジの不足ではありません。リポジトリにガイダンスファイルを追加することで、チェック対象を拡張できます。

Code Review をセットアップする

以下の手順は github.com 上のリポジトリのセットアップについて説明しています。リポジトリが自己ホスト型 GitHub Enterprise Server (GHES) インスタンス上にある場合は、Claude Code と GitHub Enterprise Server を参照して、完全なセットアップガイドを確認してください。

Team および Enterprise プランのオーナーとプライマリオーナーは、組織に対して Code Review を 1 回有効にして、含めるリポジトリを選択できます。Claude 組織内のオーナーロールに加えて、GitHub 組織に GitHub Apps をインストールする権限が必要です。

組織設定 > Claude Code に移動して、Code Review セクションを見つけます。
「設定」をクリックして GitHub App インストールフローを開始します。
プロンプトに従って Claude GitHub App を GitHub 組織にインストールします。このアプリは、コンテンツ、問題、プルリクエストの読み取りおよび書き込み権限をリクエストします。
Code Review を有効にするリポジトリを選択します。リポジトリが表示されない場合は、インストール中に Claude GitHub App にアクセス権を付与したことを確認してください。
レビュー動作ドロップダウンを使用して、各リポジトリのレビュートリガーを設定します (各オプションの詳細については、次のセクションを参照してください)。

セットアップを確認するには、テスト PR を開きます。自動トリガーを選択した場合、Claude Code Review という名前のチェック実行が数分以内に表示されます。手動を選択した場合は、PR に「@claude review」とコメントして、最初のレビューを開始します。

レビュートリガーを選択する

セットアップ後、Code Review セクションにリポジトリがテーブルに表示されます。各リポジトリについて、レビューを実行するタイミングを選択します:

PR 作成後 1 回:PR が開かれるか、レビュー準備完了としてマークされたときに、レビューが 1 回実行されます。
すべてのプッシュ後:PR ブランチへのすべてのプッシュでレビューが実行され、PR が進化するにつれて新しい問題をキャッチします。Claude は、以前にフラグが立てられた問題を修正すると、スレッドを自動的に解決します。これは最も多くのレビューを実行し、最もコストがかかります。
手動:レビューは、誰かが PR に「@claude review」とコメントしたときにのみ開始されます。高トラフィックのリポジトリで、レビューする PR を選択したい場合に便利です。

リポジトリテーブルには、最近のアクティビティに基づいて、各リポジトリのレビューあたりの平均コストも表示されます。

レビューを手動でトリガーする

プルリクエストに「@claude review」とコメントしてレビューを開始し、その PR を今後のプッシュトリガーレビューにオプトインします。これはリポジトリの設定されたトリガーに関係なく機能します。

コメントがレビューをトリガーするには:

diff 行のインラインコメントではなく、トップレベルの PR コメントとして投稿します。
コメントの最初に「@claude review」を配置します。
リポジトリへのオーナー、メンバー、またはコラボレーターアクセス権が必要です。
PR は開いていて、ドラフトではない必要があります。

レビューが既に実行中の場合、リクエストは進行中のレビューが完了するまでキューに入ります。

レビューをカスタマイズする

Code Review はリポジトリから 2 つのファイルを読み取り、フラグが立つ内容をガイドします。どちらもデフォルトの正確性チェックの上に追加されます。

CLAUDE.md

Code Review はリポジトリの CLAUDE.md ファイルを読み込み、新たに導入された違反を軽微な検出結果として扱います。PR がコードを変更して CLAUDE.md ステートメントが古くなった場合、Claude はドキュメントの更新も必要であることを示します。

Claude はディレクトリ階層のすべてのレベルで CLAUDE.md ファイルを読み込むため、サブディレクトリの CLAUDE.md のルールはそのパス下のファイルにのみ適用されます。

REVIEW.md

リポジトリルートに REVIEW.md ファイルを追加して、レビュー固有のルールを指定します。以下をエンコードするために使用します：

企業またはチームのスタイルガイドライン
リンターでカバーされていない言語またはフレームワーク固有の規約
Claude が常にフラグを立てるべきもの（例：「新しい API ルートには統合テストが必須」）
Claude がスキップすべきもの（例：「生成されたコードにはコメントしない」）

Claude はリポジトリルートの REVIEW.md を自動検出します。設定は不要です。

料金と使用量

Code Review はトークン使用量に基づいて課金されます。各レビューの平均コストは $15～25 で、PR サイズ、コードベースの複雑さ、検証が必要な問題の数に応じてスケーリングします。

Code Review の使用量は使用クレジットを通じて個別に課金され、プランに含まれる使用量にはカウントされません。選択するレビュートリガーは総コストに影響します：

PR 作成後 1 回は PR ごとに 1 回実行されます。
すべてのプッシュ後は各プッシュで実行され、プッシュ数によってコストが増加します。
手動は誰かが「@claude review」とコメントするまでコストが発生しません。そのコメント後、PR への追加プッシュは自動的にレビューをトリガーします。

コストは Anthropic の請求書に表示されます。組織が他の Claude Code 機能に AWS Bedrock または Google Vertex AI を使用しているかどうかに関わらず表示されます。

組織設定 > 使用量に移動して、Claude Code Review サービスの制限を設定し、月間支出上限を設定します。

分析ダッシュボードの週間コストチャートまたは管理設定のリポジトリごとの平均コスト列で支出を監視します。

使用量を表示

Code Review 分析ダッシュボードに移動して、組織全体のアクティビティを確認します。ダッシュボードには以下が表示されます：

レビュー済み PR：選択した期間にレビューされたプルリクエストの日次カウント。
週間コスト：Code Review の週間支出。
フィードバック：誰かが問題に対処したため自動解決されたレビューコメントのカウント。
リポジトリ分析：リポジトリごとのレビュー済み PR とコメント解決のカウント。

トラブルシューティング

GitHub App インストール後、リポジトリが表示されない

Claude GitHub App をインストールしたがリポジトリが管理パネルに表示されない場合：

Claude GitHub App が期待するリポジトリへのアクセス権を持っていることを確認します。GitHub 組織の設定に移動し、インストール済み GitHub Apps で Claude GitHub App を見つけ、すべてのリポジトリまたは選択したリポジトリのみへのアクセス権があるかどうかを確認します。
組織が Enterprise Managed Users（EMU）を備えた GitHub Enterprise Cloud を使用している場合、マネージドアカウントでサインインし、アクティブな SSO セッションを持っている状態で Claude を認可します。エンタープライズレベルの個別の承認ステップはありません。
Claude で GitHub アカウントを切断して再接続してみてください。カスタマイズ > コネクタに移動し、GitHub を切断してから再度接続します。App がアクセスできるリポジトリは GitHub 側で管理され、ステップ 1 で説明されています。
問題が解決しない場合は、サポートチームに連絡して、組織名と GitHub 組織名を提供してください。調査いたします。

Code Review が新しい PR で開始されない

PR を開いた後にチェック実行が表示されない場合：

リポジトリが管理設定に一覧表示され、有効になっていることを確認します。
レビュートリガー設定を確認します。「手動」に設定されている場合は、PR で「@claude review」とコメントしてレビューを開始する必要があります。
PR がドラフトでないことを確認します。Code Review はドラフト PR では実行されません。
Claude GitHub App が GitHub 組織の設定でリポジトリへのアクセス権を持っていることを確認します。

IP 制限を備えた GitHub Enterprise Cloud

GitHub Enterprise Cloud 組織が IP アドレスによるアクセスを制限している場合、Claude GitHub App はリポジトリにアクセスできない可能性があります。これを修正するには、GitHub エンタープライズ設定でインストール済み GitHub Apps の IP 許可リスト継承を有効にします。Claude GitHub App は IP 範囲を登録するため、この設定を有効にするとマニュアル設定なしでアクセスが可能になります。代わりに範囲を許可リストに手動で追加するか、他のファイアウォールを設定するには、Anthropic API IP アドレスを参照してください。

GitHub Enterprise Server（自己ホスト型）

自己ホスト型 GitHub Enterprise Server（GHES）は別のセットアップフローを通じてサポートされています。完全な手順については、Claude Code と GitHub Enterprise Server を参照してください。

一般的な GHES セットアップの問題：

セットアップ中の「Public cannot be private」エラー：GHES ホスト名は公開ルーティング可能な IP アドレスに解決される必要があります。Code Review はインターネット経由でサーバーに到達するため、内部またはプライベートネットワークアドレスは機能しません。ホスト名が公開 IP に解決されるように DNS またはネットワーク設定を更新してから、再試行してください。
GitHub Enterprise Cloud とデータレジデンシーは異なる製品です。データレジデンシーテナント（*.ghe.com に一致するホスト名）は Code Review でサポートされていません。自己ホスト型 GitHub Enterprise Server と標準 github.com リポジトリのみがサポートされています。

よくある質問

カスタムロールを作成する際に Code Review を利用できますか？

いいえ、現在のところ Code Review をカスタムロールに追加することはできません。