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

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

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

注:コードレビューはリサーチプレビュー段階にあり、TeamおよびEnterpriseプランで利用可能です。ゼロデータ保持が有効な組織では利用できません。コードレビューの使用は追加使用量を通じて別途請求され、プランに含まれる使用量にはカウントされません。

コードレビューの仕組み

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

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

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

重大度レベル

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

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

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

コードレビューが確認する内容

デフォルトでは、コードレビューは正確性に焦点を当てています。本番環境を破壊するバグであり、フォーマット設定の好みやテストカバレッジの欠落ではありません。リポジトリにガイダンスファイルを追加することで、確認内容を拡張できます。

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

TeamおよびEnterpriseプランのオーナーおよびプライマリオーナーは、組織に対して一度コードレビューを有効にし、含めるリポジトリを選択できます。Claude組織内のオーナーロールに加えて、GitHub組織にGitHub Appをインストールする権限が必要です。

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

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

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

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

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

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

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

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

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

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

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

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

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

CLAUDE.md

コードレビューはリポジトリのCLAUDE.mdファイルを読み取り、新たに導入された違反をニットレベルの検出結果として扱います。プルリクエストがCLAUDE.mdステートメントを古くする方法でコードを変更する場合、Claudeはドキュメントも更新する必要があることをフラグします。

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

REVIEW.md

レビュー固有のルールについては、リポジトリルートにREVIEW.mdファイルを追加します。これを使用してエンコードします:

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

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

価格と使用量

コードレビューはトークン使用量に基づいて請求されます。各レビューの平均コストは$15~25で、プルリクエストのサイズ、コードベースの複雑さ、および検証が必要な問題の数に応じてスケーリングされます。

コードレビューの使用は追加使用量を通じて別途請求され、プランに含まれる使用量にはカウントされません。選択するレビュートリガーは総コストに影響します:

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

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

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

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

使用量を表示する

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

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

トラブルシューティング

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

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

Claude GitHub Appが期待するリポジトリにアクセスできることを確認します。GitHub組織の設定に移動し、インストール済みGitHub Appsの下でClaude GitHub Appを見つけ、すべてのリポジトリにアクセスできるか、選択したリポジトリのみにアクセスできるかを確認します。
組織がGitHub Enterprise CloudとEnterprise Managed Users(EMU)を使用している場合は、Claude GitHub OAuth Appがエンタープライズレベルで認可されていることを確認してください。EMUエンタープライズはどのOAuthアプリが承認されるかを制限でき、Claudeアプリは明示的に許可される必要があります。
GitHub統合を切断して再接続してみてください。組織設定 > Claude Codeに移動し、リポジトリ設定を削除して、セットアップを再度実行します。
問題が解決しない場合は、サポートチームに連絡して、組織名とGitHub組織名を提供してください。調査させていただきます。

コードレビューが新しいプルリクエストで開始されない

プルリクエストを開いた後、チェック実行が表示されない場合:

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

IP制限を備えたGitHub Enterprise Cloud

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

GitHub Enterprise Server(自己ホスト)

コードレビューは現在、github.comでホストされているリポジトリが必要なため、自己ホストGitHub Enterprise Serverはまだサポートされていません。

よくある質問

カスタムロールを作成するときに、コードレビューは機能として利用可能ですか?

いいえ、コードレビューは現在、カスタムロールに追加することはできません。