Claude Codeの Code Review をセットアップする

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 with GitHub Enterprise Server を参照して、完全なセットアップガイドを確認してください。

Team および Enterprise プランのオーナーとプライマリオーナーは、組織に対して Code Review を一度有効にし、含めるリポジトリを選択できます。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への追加プッシュは自動的にレビューをトリガーします。

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

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

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

使用状況を表示

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

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

トラブルシューティング

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

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

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

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

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

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

IP制限を備えたGitHub Enterprise Cloud

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

GitHub Enterprise Server(自己ホスト)

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

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

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

よくある質問

カスタムロールを作成する際にCode Reviewは利用可能ですか?

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