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

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

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

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

Code Reviewの仕組み

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

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

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

重大度レベル

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

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

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

Code Reviewが確認する内容

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

Code Reviewをセットアップする

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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アプリを見つけ、すべてのリポジトリにアクセスできるか、選択したものだけかを確認します。
組織がEnterprise Managed Users(EMU)を備えたGitHub Enterprise Cloudを使用している場合、Claude GitHubOAuthアプリがエンタープライズレベルで認可されていることを確認します。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と標準github.comリポジトリのみがサポートされています。

よくある質問

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

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