Claude Code PRレビュー実践ガイド:公式Code ReviewとSubagents自作の2ルート完全解説
AIによるvibe codingがコード産出速度を倍増させた一方で、PRレビュー量も急増し、人力レビューがボトルネックになっています。Anthropicは2026年3月にClaude Code Reviewを正式リリースし、複数のsubagentが並列でPRをレビューする公式統合を提供しました。しかし公式版は誰でも使えるわけではなく、全員が必要なわけでもありません。本ガイドでは2つのルートを解説します。公式Code Review(Team/Enterprise限定)と自作9-Subagentアプローチ(任意のClaude Codeアカウント対応)を比較し、自動化PRレビューの最適戦略を見つけるお手伝いをします。
TL;DR
- 公式Code Review:Team/Enterprise限定、5ステップGitHub統合、$15-25/回、マルチagent並列分析、偽陽性 < 1%、20分で結果
- 自作9-Subagent:任意の有料アカウント対応、
.claude/commands/にslashコマンドを置く、費用はAPIトークンのみ、ローカル実行、提案の約75%が有用 - REVIEW.md:リポジトリルートに置くだけで自動有効化、Always check / Style / Skipの3段構成、レビューシーンに特化
- コスト節約のポイント:Manualトリガーモードを選択し(「After every push」は避ける)、月額上限capを設定
公式版 vs 自作版:まず自分のルートを決める
設定に入る前に、どちらのアプローチが自分の状況に合っているかを確認しましょう。
| 項目 | 公式Code Review | 自作9-Subagent |
|---|---|---|
| アカウント要件 | Team / Enterprise限定 | 任意の有料Claude Codeアカウント |
| プラットフォーム | GitHubのみ | ローカル実行、プラットフォーム不問 |
| 課金方式 | $15-25/回(extra usage) | APIトークン消費のみ |
| トリガー | 自動(PR作成時または毎push)または手動@claude | 手動/code-review slashコマンド |
| レビュー場所 | GitHub PR インラインコメント | ローカルターミナル |
| 設定難易度 | 管理パネル5ステップ、コード不要 | .claude/commands/ promptの作成が必要 |
| コードベース全体のコンテキスト | あり(リポジトリ全体) | あり(Claude Codeがローカルでリポジトリ保持) |
| バグ検出率 | 84%(公式大型PR内部テスト) | 約75%(コミュニティテスト) |
判断フレームワーク:
- Team/Enterpriseアカウントあり + GitHubメイン → 公式版(ゼロ設定、自動トリガー、結果はPRページに直接表示)
- 個人開発者、Proアカウント、GitLab/Bitbucketユーザー → 自作9-Subagent
- 組み合わせ戦略:まず/code-reviewをローカルで実行して問題を洗い出し、pushした後に公式版で残りを検出
公式Code Reviewの設定:5ステップでGitHub統合完了
設定はすべてclaude.aia管理パネルで完了します。CLIは不要です。2つの権限が必要:Claude org adminとGitHub org admin。
ステップ1:claude.ai/admin-settings/claude-codeにアクセスし、Code Reviewセクションを見つけてSetupをクリック。
ステップ2:ガイドに従い、Claude GitHub AppをGitHub orgにインストール。AppはContentsとPull RequestsへのRead/Writeアクセスを要求します(PR分析に必要)。
注意:Zero Data Retention設定のある組織はCode Reviewを使用できません(分析プロセスでコードの一時保存が必要なため)。
ステップ3:Code Reviewを有効にするリポジトリを選択。設定後はリポジトリ横断で有効になるため、個別インストールは不要。
ステップ4:各リポジトリのReview Behavior(トリガーモード)を設定:
- Once after PR creation:各PRを1回のみレビュー、最も予測しやすいコスト、大半のケースに最適
- After every push:pushのたびにトリガー、最高コスト、必要な場合以外は選ばない
- Manual:
@claude reviewとコメントした時のみトリガー、高トラフィックリポジトリやテスト期に最適
ステップ5:テスト用のPRを作成して確認。数分以内に「Claude Code Review」チェックランが表示されるはずです。初回の完全レビューには約20分かかります。
手動トリガー
どのモードでも、PRコメントの先頭に@claude reviewと書けば手動でレビューをトリガーできます。owner / member / collaboratorの権限が必要。Draft PRでは使用不可。
落とし穴:Manualモードで一度
@claude reviewとコメントすると、そのPRはその後のすべてのpushで自動トリガーされます。実質的に「After every push」モードと同じになります。高トラフィックリポジトリでは特に注意が必要です。
REVIEW.mdテンプレートとベストプラクティス
REVIEW.mdをリポジトリルートに置くだけで、Claude Code Reviewが自動的に読み込みます。追加設定は一切不要。これは加算的(additive)に機能します。Claudeのデフォルトの正確性チェックを拡張するものであり、置き換えるものではありません。
REVIEW.md vs. CLAUDE.mdの違い
- CLAUDE.md:グローバル指示、すべてのClaude Code作業(インタラクティブ編集、agentタスク)で読み込まれる
- REVIEW.md:Code Review実行時のみ読み込み、レビュー専用ルールの記述に最適
両ファイルは共存できます。PRの変更によってCLAUDE.mdが古くなった場合、Claudeが更新が必要であることを指摘します。
コピーしてすぐ使えるREVIEW.mdテンプレート
# Code Review Guidelines
## Always check
- New API endpoints have corresponding integration tests
- Database migrations are backward-compatible
- Error messages don't leak internal details to users
- Sensitive data (tokens, keys, PII) is not logged or hardcoded
## Style
- Prefer `match` statements over chained `isinstance` checks
- Use structured logging, not f-string interpolation in log calls
- Function names should be descriptive verbs, not nouns
## Skip
- Generated files under `src/gen/`
- Formatting-only changes in `*.lock` files
- Auto-generated migration files
記述のコツ:
- Always checkは具体的に:「新しいAPIにはテストが必要」は「良いコードを書く」より有用
- Skipを活用してコスト削減:生成ファイルやlockファイルをスキップするとトークン消費量が大幅に削減
- Styleは最小限に:Claudeには元々スタイルの好みがあります。REVIEW.mdには自分のコードベース固有の規則だけを書く
レビューで見つかった問題には深刻度レベルがあります:
- 🔴 Normal:マージ前に修正すべきバグ
- 🟡 Nit:軽微な問題、マージをブロックしない
- 🟣 Pre-existing:コードベースに存在するが今回のPRで導入されていないバグ
自作9-Subagentアプローチ:個人開発者のための代替ルート
このアプローチはエンジニアのHAMYが設計しオープンソースで共有しています。.claude/commands/にslashコマンドを置き、実行すると9つのsubagentが並列で分析を開始します。HAMYの実測によると、提案の約75%が実際に役立ちます(単一agentでは50%未満)。
9つのSubagentの役割
| Subagent | 分析対象 |
|---|---|
| Test Runner | テスト実行、pass/fail報告 |
| Linter & Static Analysis | linter・型チェック実行 |
| Code Reviewer | 最大5つの具体的改善提案(impact/effortでランク付け) |
| Security Reviewer | インジェクションリスク、Auth問題、シークレット漏洩 |
| Quality & Style Reviewer | 複雑度、重複、プロジェクト慣例 |
| Test Quality Reviewer | テストカバレッジROI、動作 vs 実装テスト |
| Performance Reviewer | N+1クエリ、ブロッキング処理、メモリリーク |
| Dependency & Deployment Safety | 依存関係、破壊的変更、マイグレーション |
| Simplification & Maintainability | 簡潔さ、変更の原子性 |
設定手順
ステップ1:プロジェクトルートに.claude/commands/ディレクトリを作成
ステップ2:.claude/commands/code-review.mdを作成し、9つのsubagentのロールと並列実行ロジックを定義(HAMYのオープンソーステンプレートを参照)
ステップ3:Claude Codeのターミナルで/code-reviewを実行
Claudeがレビュースコープを自動判断(優先順位):
- 指定したスコープ(例:
/code-review auth/) - Feature branchとmainのdiff
- Staged changes
- 最新コミット
ステップ4(オプション):CLAUDE.mdまたはプロジェクトスタイルガイドにコーディング規約を定義すると、9つのsubagentがすべて自動的に読み込みます
最終出力のverdict:Ready to Merge / Needs Attention / Needs Work、各agentの分析サマリー付き。
費用計算とROI評価
公式Code Reviewのコスト
1回のレビューは$15-25(PRのサイズとコードベースの複雑さで変動)、extra usageとして課金され、プランに含まれるusage枠にはカウントされません。claude.ai/admin-settings/usageで月額上限capを設定できます。
| 規模 | 計算 | 月額見積もり |
|---|---|---|
| 10人チーム、3 PR/日、20営業日 | $20 × 60回 | $1,200-1,500/月 |
| 50人チーム、10 PR/日 | $20 × 200回 | $4,000/月 |
| 100人チーム、1 PR/人/日 | $20 × 2,000回 | $40,000/月 |
CodeRabbitとの比較
| Claude Code Review | CodeRabbit | |
|---|---|---|
| 課金 | $15-25/回(従量制) | $12-24/人/月(年払いプラン) |
| スピード | 約20分 | 約2分 |
| 検出率 | 84%(大型PR内部テスト) | 非公開 |
| プラットフォーム | GitHubのみ | GitHub、GitLab、Bitbucket |
| コードベース全体のコンテキスト | あり(リポジトリ全体) | なし(変更行のみ) |
| 個人/Proプラン | 利用不可 | 利用可(無料プランあり) |
Claude Code Reviewのプレミアムが価値ある場面:
- 大型PR、複雑なコードベース、ファイル横断のコンテキストが必要なセキュリティレビュー
- AI生成コードの比率が高く、偽陽性の許容度が低い(Claude < 1%)
- 既存のTeam/Enterpriseサブスクリプションがあり、Code Reviewを追加機能として位置づけられる
CodeRabbitの方がコスパが良い場面:
- 小〜中規模のエンジニアチーム(30人未満):固定月額の方が予算管理しやすい
- GitLabまたはBitbucketのサポートが必要
- より高速なレビューが必要(2分 vs 20分)
制限事項とトレードオフ
公式Code Reviewの制限
向いていないケース:
- 個人開発者とProアカウントユーザー(アクセス権なし)
- GitLabまたはBitbucketチーム(2026年3月時点で非対応)
- 高速マージフロー(20分では遅すぎてPRがすでにマージ済みになる)
- Zero Data Retention要件のある組織
向いているケース:
- AI生成コードの比率が高く、深いセキュリティとロジックレビューが必要な大規模チーム
- GitHub上でTeam/Enterpriseサブスクリプションを持ち、ゼロ設定の自動化を望むチーム
- 偽陽性率(< 1%)を重視する厳格なコード品質フロー
自作9-Subagentの制限
- ローカル実行のみで、CI/CDの自動トリガーなし(手動で
/code-reviewを実行する必要がある) - 9つのagentの並列実行には時間がかかり、Claude Codeセッションリソースをかなり消費
- promptテンプレートのセットアップとメンテナンスに追加の投資が必要
まとめ
Claude Code PRレビューは2026年の重要なマイルストーンです。「AIがAIの書いたコードをレビューできるか」という問いを、コンセプトから直接デプロイ可能なツールへと転換しました。公式版はAnthropicのマルチエージェント機能をGitHubネイティブ体験としてパッケージ化し、Team/Enterpriseのエンジニアチーム向け。自作版は個人開発者と小チームに高額サブスクリプション不要のルートを提供します。
ShareuhackのagentシステムでClaude Codeのsubagent機能を使っている実感として:並列分析は単一agentと比べて見落としが明らかに減ります。特にセキュリティとテストカバレッジの交差点における問題発見が向上します。コードベースにAI生成コードが増えているなら、PRレビューの自動化は投資に値します。
次のステップ:
- Team/Enterpriseユーザー:claude.ai/admin-settings/claude-codeで5ステップ設定を開始し、最初の1週間はManualモードでコストと効果を観察
- 個人/Proユーザー:HAMYの自作9-Subagentチュートリアルから始めれば、30分で最初のレビューを実行できます
FAQ
Team/Enterpriseアカウントなしで個人開発者はClaude Code PRレビューを使えますか?
公式マネージドCode ReviewサービスはTeam/Enterpriseプランのみです。ただし個人開発者には3つの代替ルートがあります。(1)自作9-Subagentアプローチ:.claude/commands/にslashコマンドを置き、/code-reviewをローカル実行、費用はAPIトークン消費のみ。(2)GitHub Actions + anthropics/claude-code-action:Anthropic APIキーのみ必要。(3)GitLabユーザーは公式CI/CD beta統合が利用可能。ほとんどの個人開発者にとって、自作9-Subagentが最も直接的なルートです。
トリガーモードを間違えると本当に請求が急増しますか?最もコスパの良い設定は?
はい。「After every push」を選択すると、1つのPRに20回pushすれば$300-500になります。最もコスパの良い戦略:最初はManualモードを選択(@claude reviewとコメントした時のみトリガー)。注意点として、Manualモードで一度トリガーされると、そのPRはその後のすべてのpushで自動的にトリガーされる仕様があり、見落としやすいです。admin settingsで月額上限capを設定することも推奨します。
Claude Code PRレビューはGitLabやBitbucketをサポートしていますか?
公式マネージドCode ReviewサービスはGitHubのみ対応です(2026年3月時点)。GitLabには公式CI/CD beta統合があり(.gitlab-ci.ymlにANTHROPIC_API_KEYを設定)、Team/Enterprise不要で基本的なレビューが可能ですが、自分でpromptを設定する必要があります。Bitbucketは公式サポートなし、コミュニティのDIYソリューションのみ。GitLabやBitbucketがメインなら、3プラットフォームをネイティブサポートするCodeRabbitがより成熟した選択肢です。

