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への追加プッシュは自動的にレビューをトリガーします。

組織がその他の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のGitHub OAuthアプリがエンタープライズレベルで認可されていることを確認します。EMUエンタープライズは承認されたOAuthアプリを制限でき、Claudeアプリは明示的に許可される必要があります。
Claudeで自分のGitHubアカウントを切断して再接続してみてください。カスタマイズ > コネクタに移動し、GitHubを切断して再度接続します。アプリがアクセスできるリポジトリはGitHub側で管理され、ステップ1でカバーされています。
問題が解決しない場合は、サポートチームに連絡して、組織名とGitHub組織名を提供してください。調査いたします。

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

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）は別のセットアップフローを通じてサポートされています。詳細な手順については、GitHub Enterprise ServerのClaudeコードを参照してください。

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

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

よくある質問

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

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