Claude CodeでGitHub PR自動レビューを設定・運用する
GitHub PR自動レビュー機能(Code Review)のセットアップ手順、@claude reviewでの手動トリガー、指摘の見え方、運用のつまずき、料金と利用状況の確認方法をまとめます。
Claude CodeのGitHub PR自動レビュー機能(Code Review)は、GitHub Appとして組織にインストールし、pull requestが開くたびに自動で指摘を返す仕組みです。ローカルの/code-reviewコマンドとは別のプロダクトで、セットアップの手順・トリガーの選び方・指摘の見え方・料金の確認方法がそれぞれ独立しています。本稿はセットアップから日常運用までの流れに絞ります。
セットアップに必要な前提条件
Code ReviewはTeam / Enterpriseプラン向けのリサーチプレビューです。Claude / Anthropicの一般プラン(Pro・Max)では使えません。Zero Data Retentionを有効化した組織も対象外です。GitHub Appのインストールには、Claude組織側でOwnerまたはPrimary Ownerロールを持つこと、かつGitHub組織側でGitHub Appをインストールする権限を持つことの両方が必要です。
対象はGitHub限定です。公式ドキュメントはGitHub Enterprise Serverへの対応可否を明記していません。セルフホスト環境で同等のことをしたい場合は、対応状況が不明な点を踏まえつつ自分のCIにClaudeを組み込む形が選択肢になります。GitLabのパイプラインで動かす選択肢もGitLab CI/CDとして別にあります。ローカルセッションで完結する/code-reviewコマンドとの違いや、認証済みクラウドで深く検証するultrareviewとの使い分けはClaude Codeコードレビュー — 4つの実行経路の使い分けが詳しい範囲です。本稿ではGitHub App経由の自動レビューだけを扱います。
セットアップの手順
claude.ai/admin-settings/claude-codeを開き、Code Reviewのセクションを探す- Setupをクリックし、GitHub Appのインストールフローを開始する
- 対象のGitHub組織を選び、レビュー対象にするリポジトリを選択して権限を承認する
- インストール完了後に表示されるリポジトリ一覧から、レビューを有効化するリポジトリを選ぶ(後から追加も可能)
- リポジトリごとにReview Behaviorを設定する
- テストPRを開いて、数分以内にClaude Code Reviewというチェック実行が現れるか確認する
インストール時に承認する権限は、GitHub Actions連携など他のClaude機能と共有される広めのセットです。読み取り権限でリポジトリの中身を読み、書き込み権限でPRへのコメントとチェック実行の更新を行います。
Review Behaviorには3つのモードがあり、リポジトリごとに独立して選べます。
| モード | いつ走るか | コスト特性 |
|---|---|---|
| PR作成時に1回 | いつ走るかopenedまたはready for review時のみ | コスト特性PR 1件につき1回で最も安い |
| pushのたびに | いつ走るかブランチへのpush全て | コスト特性push数に比例して増える。修正を検知すると該当スレッドを自動解消 |
| Manual | いつ走るか@claude reviewが投稿されたときだけ | コスト特性リクエストされるまで課金なし。高頻度リポジトリのコスト調整に向く |
pushのたびにモードは最も多くレビューを走らせる代わりに、指摘を直した後の再pushでスレッドが自動的に解消されます。高トラフィックなリポジトリでコストを抑えたい場合や、PRがready for reviewになってから初めてレビューしたい場合はManualが向きます。
@claude reviewコマンドの使い分け
トリガー設定に関わらず、PRのトップレベルコメントで手動レビューを起動できます。コメントはインライン(diff行への返信)ではなくPR本体への投稿である必要があり、コマンドは行の先頭に置きます。
| コマンド | 動作 |
|---|---|
@claude review | 動作1回だけレビューを実行する(以後のpushへの購読はしない) |
@claude review always | 動作レビューを実行し、以後のpushでも自動的にレビューが走るようPRを購読する |
@claude review once | 動作@claude reviewと同じ。1回だけ実行する |
実行にはリポジトリへのOwner・member・collaboratorいずれかのアクセス権限が必要で、対象PRがオープンしている必要があります。自動トリガーと違い、手動コマンドはdraft状態のPRでも動きます。明示的なリクエストは、draftであっても今すぐレビューしたいという意思表示だとみなされるためです。
2026年7月の仕様変更として、それ以前は@claude reviewを投稿するとpush購読も同時に行われていました。現在は素の@claude reviewは単発実行のみで、以後のpushでも走らせたいなら@claude review alwaysを明示する必要があります。以前の挙動を前提にした運用をしている場合は、コメントテンプレートを見直してください。
既にレビューが進行中のPRに追加でコマンドを投稿すると、新しいリクエストは実行中のレビューが終わるまでキューに入ります。進捗はPRのチェック実行から確認できます。
指摘はインラインコメント以外にも出る
レビューが完了すると、複数のエージェントが検証した指摘が重大度別に並びます。🔴 Importantはマージ前に直すべきバグ、🟡 Nitは軽微な指摘、🟣 Pre-existingはこのPRで持ち込まれていない既存の不具合です。チェック実行は指摘の有無にかかわらず常に中立的な結論で完了し、承認もブロックもしません。
指摘が見つかったのにインラインコメントが見当たらない場合、次の3か所を確認します。
- チェック実行のDetails: Checksタブの「Claude Code Review」の詳細を開くと、file・line・要約付きの重大度別テーブルが出ます。インラインコメントが何らかの理由で投稿できなかった指摘も、ここには必ず載ります
- Files changedタブの注釈: 差分の該当行に直接アノテーションとして表示されます。Importantは赤、Nitは黄色の警告、Pre-existingは灰色の通知と色分けされ、レビューコメントとは別経路で出ます
- レビュー本文の「Additional findings」: レビュー実行中に新しいpushをすると、対象の行が現在の差分から消えてしまうことがあります。その場合の指摘はインラインではなく、レビュー本文の「Additional findings」という見出しの下にまとめて出ます
各インラインコメントには👍と👎のリアクションがあらかじめ付いています。有用だった指摘に👍、誤りやノイズだった指摘に👎を押すと、AnthropicはPRマージ後にその集計をレビューの精度向上に使います。リアクション自体は再レビューを起動せず、PRの状態も変えません。指摘に返信しても、Claudeが応答したりPRを更新したりすることはありません。指摘に対応するには、コードを直してpushします。
デフォルトで何をチェックするか
既定のCode Reviewはロジックの誤り・セキュリティ上の欠陥・見落としがちな退行(regression)といった、正しく動くかどうかに絞った検査です。フォーマットの好みやテストカバレッジの不足は既定のチェック対象に入りません。チェック範囲を広げたい場合は、リポジトリにCLAUDE.mdとREVIEW.mdを追加します。CLAUDE.mdの記述はプロジェクトの前提知識として参照され、新規に見つかった違反はNit扱いの報告対象です。チームでのCLAUDE.md規約の設計自体はClaude Codeチーム導入ガイドを参照してください。REVIEW.mdはレビュー専用のファイルで、重大度の再定義やスキップ対象の指定など、より強い調整ができます。具体的な調整項目はREVIEW.mdカスタマイズでClaude Codeの自動レビュー基準を変えるにまとめました。
運用で見落としやすい2つの場面
もう1つはChecksタブの挙動です。GitHubの標準的なRe-runボタンは、Code Reviewを再起動しません。失敗やタイムアウトでレビューが終わっていない場合(チェック実行のタイトルが「Code review encountered an error」や「Code review timed out」になっているとき)は、PRに@claude reviewとコメントするか、購読済みのPRなら新しいpushをする必要があります。
料金と利用状況の確認
Code Reviewはトークン使用量に応じて課金され、1レビューあたり平均15〜25ドルです。PRの大きさ・コードベースの複雑さ・検証にかかる手間でスケールします。この費用はプランに含まれる使用量にはカウントされません。利用クレジット(usage credits)として個別に請求される仕組みです。トリガーモードの選択がそのままコストに直結する点は前述のとおりで、pushのたびにモードはpush数だけ費用が積み上がります。
組織全体の月次支出上限はclaude.ai/admin-settings/usageから「Claude Code Review」サービス向けに個別設定します。実際の利用状況はclaude.ai/analytics/code-reviewのダッシュボードで確認できます。
| セクション | 内容 |
|---|---|
| PRs reviewed | 内容選択した期間のレビュー実行数を日次で表示 |
| Cost weekly | 内容週次の支出推移 |
| Feedback | 内容開発者が指摘を修正して自動解消されたコメント数 |
| Repository breakdown | 内容リポジトリ別のレビュー数と解消済みコメント数 |
ダッシュボードの数値はあくまで監視用の推定値です。請求と一致する正確な金額はAnthropicの請求書を確認します。
まとめ
GitHub PR自動レビュー機能はTeam / Enterpriseプラン限定のGitHub App連携で、リポジトリごとにPR作成時・毎push・Manualのいずれかのトリガーを選んで運用します。@claude review系のコマンドは2026年7月の仕様変更で購読の挙動が変わりました。alwaysの要否を意識して使い分けます。指摘はインラインコメントだけでなくチェック実行の詳細やFiles changedタブにも出るため、見つからないときはそちらも確認します。支出上限のスキップとRe-runボタンの無効化は、運用を始めてから気づきやすい2点です。
よくある質問
draft状態のPRでも自動レビューは走りますか
PR作成時に1回・pushのたびにの2モードは、draftのままだと自動トリガーの対象外です。@claude reviewなどの手動コマンドは、draftのPRに対しても実行できます。
👍👎の評価はレビューのやり直しにつながりますか
つながりません。リアクションはAnthropicがマージ後に集計してレビュー精度の改善に使うだけで、対象PRの状態やスレッドには何も影響しません。
フォークから送られたPRもレビューされますか
公式ドキュメントはこの点を明記していません。確認できているのは、Code ReviewがGitHub Appの読み取り・書き込み権限を通じて動くということだけです。フォークPRでの挙動を前提にした運用をしたい場合は、個別に検証したうえで判断してください。
CLAUDE.mdだけでREVIEW.mdは省略できますか
省略できます。CLAUDE.mdだけでもプロジェクトコンテキストとして参照され、新規違反をNitとして報告します。重大度の基準を変えたい、投稿するNitの件数に上限をかけたいといった細かい調整が必要になった段階でREVIEW.mdを足す、という順序で問題ありません。
複数リポジトリでトリガー設定を変えられますか
変えられます。Review Behaviorはリポジトリごとに独立した設定です。トラフィックの多いリポジトリだけManualにしてコストを抑え、小規模なリポジトリはpushのたびにで手厚く見る、といった使い分けが可能です。