Claude Code PRレビュー完全ガイド:/ultrareview・公式Code Review・自作Subagentの3ルート比較(2026年更新)
AIによるvibe codingがコード産出速度を倍増させた一方で、PRレビュー量も急増し、人力レビューがボトルネックになっています。Anthropicは2026年3月に公式Code Reviewをリリースし、4月には/ultrareviewをクラウドベースのマルチAgentバグハンターとして追加しました。コミュニティ発の自作Subagentアプローチと合わせて、Claude Codeには現在3つのAIコードレビュー方法があり、個人開発者から大規模チームまで対応しています。
本ガイドでは3つのルートを比較し、最適な自動化PRレビュー戦略を見つけるお手伝いをします。
TL;DR
/ultrareview(2026年4月追加):Pro/Max対応、クラウドマルチAgent並列レビュー、$5-20/回、検証済みバグのみ報告、リサーチプレビュー- 公式Code Review:Team/Enterprise限定、5ステップGitHub統合、$15-25/回、偽陽性 < 1%、20分で結果
- 自作9-Subagent:任意の有料アカウント対応、
.claude/commands/にslashコマンドを置く、費用はAPIトークンのみ、ローカル実行、提案の約75%が有用 - REVIEW.md:リポジトリルートに置くだけで自動有効化、Always check / Style / Skipの3段構成、CLAUDE.mdよりレビューに特化
- コスト節約のポイント:Manualトリガーモードを選択し(「After every push」は避ける)、月額上限capを設定
3ルート総覧:まず自分に合うルートを確認
設定に入る前に、どのアプローチが自分の状況に合っているかを確認しましょう。
| 項目 | /ultrareview | 公式Code Review | 自作9-Subagent |
|---|---|---|---|
| アカウント要件 | Pro / Max(リサーチプレビュー) | Team / Enterprise限定 | 任意の有料アカウント |
| 実行環境 | クラウドサンドボックス | GitHub統合 | ローカル実行 |
| 課金方式 | $5-20/回(extra usage) | $15-25/回(extra usage) | APIトークン消費のみ |
| トリガー | CLI /ultrareview | 自動または手動@claude review | 手動 /code-review |
| レビュー場所 | CLI / Desktop | GitHub PR インラインコメント | ローカルターミナル |
| 検証メカニズム | マルチAgent独立再現後に報告 | マルチAgent並列分析 | 9 Agent並列分析 |
| プラットフォーム | 不問(ローカルCLI実行) | GitHubのみ | 不問 |
| バグ検出率 | 高(検証済みバグのみ報告) | 84%(公式大型PR内部テスト) | 約75%(コミュニティテスト) |
判断フレームワーク:
- マージ前の深いバグハンティング、Pro/Maxアカウント →
/ultrareview - Team/Enterpriseアカウント + GitHub、ワークフロー自動化希望 → 公式Code Review
- コスト重視の個人開発者、GitLab/Bitbucketユーザー → 自作9-Subagent
- 組み合わせ戦略:開発中は自作版で素早くスキャン → マージ前に
/ultrareviewで深層チェック → 公式版でCI自動トリガー
/ultrareview:クラウドマルチAgentバグハンティング(2026年4月追加)
/ultrareviewはAnthropicが2026年4月にOpus 4.7と同時にリリースしたリサーチプレビュー機能です。クラウドサンドボックスで複数のレビューAgentを起動し、それぞれ異なる角度からコードを攻撃し、独立して再現・検証されたバグのみを報告します。
核心メカニズム
公式Code Reviewや自作Subagentとの最大の違い:/ultrareviewは「可能性のある問題」ではなく「確認済みのバグ」を見つけます。各Agentが独立分析した後、発見は別のAgentによって再現されなければカウントされません。報告される結果は少なくなりますが、ほぼすべてが実際に修正すべき問題です。
多角度分析:
- ロジックの正確性
- セキュリティ脆弱性
- パフォーマンスボトルネック
- エラーハンドリングの漏れ
- エッジケース
- テストカバレッジの欠落
使い方
Claude Code CLIまたはDesktopで:
/ultrareview
PR番号を指定することも可能:
/ultrareview #123
Claude Code v2.1.86以上が必要で、Claudeアカウントでログインする必要があります(APIキーのみでは不可)。
費用と制限
- 1回$5-20(変更規模により変動)、extra usageとして課金
- Pro/Maxユーザーに3回の無料トライアルが提供されていた(2026年5月5日に期限切れ)
- リサーチプレビュー段階、機能と価格は変更の可能性あり
- 重要ブランチのマージ前に最適、毎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評価
3方式のコスト比較
| 方式 | 1回あたり | 10人チーム/月(60 PR) | 個人開発者/月(20 PR) |
|---|---|---|---|
| /ultrareview | $5-20/回 | $600-1,200 | $100-400 |
| 公式Code Review | $15-25/回 | $1,200-1,500 | 利用不可 |
| 自作9-Subagent | APIトークン消費 | 約$200-500(推定) | 約$50-150 |
公式Code Reviewと/ultrareviewはどちらもextra usageとして課金され、プランに含まれるusage枠にはカウントされません。claude.ai/admin-settings/usageで月額上限capを設定できます。
CodeRabbitとの比較
| /ultrareview | 公式Code Review | CodeRabbit | |
|---|---|---|---|
| 課金 | $5-20/回 | $15-25/回 | $12-24/人/月(年払い) |
| スピード | 数分 | 約20分 | 約2分 |
| アカウント要件 | Pro/Max | Team/Enterprise | 無料プランあり |
| プラットフォーム | 不問 | GitHubのみ | GitHub、GitLab、Bitbucket |
| 検証メカニズム | マルチAgent再現検証 | マルチAgent並列 | 非公開 |
| コードベースコンテキスト | リポジトリ全体 | リポジトリ全体 | 変更行のみ |
/ultrareviewが最も価値ある場面:
- マージ前の最終防線、検証済みの本物のバグだけを知りたい
- Pro/Maxユーザーで深いレビューが欲しいがTeam/Enterpriseではない
- 重要な機能ブランチに$5-20で安心を買いたい
公式Code Reviewのプレミアムが価値ある場面:
- 大型PR、複雑なコードベース、ファイル横断のセキュリティレビュー
- AI生成コードの比率が高く、偽陽性の許容度が低い(Claude < 1%)
- 既存のTeam/Enterpriseサブスクリプションで、GitHubワークフロー自動統合を希望
CodeRabbitの方がコスパが良い場面:
- 小〜中規模のエンジニアチーム(30人未満):固定月額の方が予算管理しやすい
- GitLabまたはBitbucketのサポートが必要
- より高速なレビューが必要(2分 vs 20分)
制限事項とトレードオフ
/ultrareviewの制限
- リサーチプレビュー段階、機能と価格は変更の可能性あり
- Claude Code v2.1.86+が必要、アカウントログイン必須(APIキーのみでは不可)
- 高頻度使用には不向き(毎pushで実行するとコストが嵩む)、マージ前の深層チェック向け
- 報告されるバグ数は少なめ(検証済みのみ)、網羅的なスタイル/コンベンション提案を求める場合には不向き
公式Code Reviewの制限
向いていないケース:
- 個人開発者とProアカウントユーザー(アクセス権なし、ただし/ultrareviewは利用可能)
- GitLabまたはBitbucketチーム(2026年5月時点で非対応)
- 高速マージフロー(20分では遅すぎてPRがすでにマージ済みになる)
- Zero Data Retention要件のある組織
向いているケース:
- AI生成コードの比率が高く、深いセキュリティとロジックレビューが必要な大規模チーム
- GitHub上でTeam/Enterpriseサブスクリプションを持ち、ゼロ設定の自動化を望むチーム
- 偽陽性率(< 1%)を重視する厳格なコード品質フロー
自作9-Subagentの制限
- ローカル実行のみで、CI/CDの自動トリガーなし(手動で
/code-reviewを実行する必要がある) - 9つのagentの並列実行には時間がかかり、Claude Codeセッションリソースをかなり消費
- promptテンプレートのセットアップとメンテナンスに追加の投資が必要
まとめ
2026年のClaude Code PRレビューは「2つのルート」から3層防御体制へと進化しました。/ultrareviewの登場により、Pro/MaxユーザーもクラウドベースのマルチAgent深層レビューが利用可能になり、Team/Enterpriseの壁がなくなりました。公式Code ReviewはGitHubワークフロー統合を求めるチームに最適で、自作Subagentは最もコストに優しい入門オプションです。
Shareuhackのagentシステムでは、開発中は自作subagentで素早くスキャンし、重要な機能ブランチのマージ前に/ultrareviewを最終防線として使う多層レビュー戦略を採用しています。並列分析は単一agentと比べて見落としが明らかに減り、特に/ultrareviewの検証メカニズムにより、報告される問題はほぼすべて実際に修正すべきものです。コードベースにAI生成コードが増えているなら、PRレビューの自動化は投資に値します。
次のステップ:
- Pro/Maxユーザー:CLIで
/ultrareviewと入力してクラウドマルチAgentレビューを体験、重要PRのマージ前に最適 - Team/Enterpriseユーザー:claude.ai/admin-settings/claude-codeで5ステップ設定を開始し、最初の1週間はManualモードでコストと効果を観察
- コスト重視の個人開発者:HAMYの自作9-Subagentチュートリアルから始めれば、30分で最初のレビューを実行可能
- ツール選びに迷っている方:Cursor vs Claude Code vs Windsurf比較を参照
FAQ
Team/Enterpriseアカウントなしで個人開発者はClaude Code PRレビューを使えますか?
2026年4月以降、状況は改善しました。ProとMaxユーザーは/ultrareviewが利用可能で、クラウドでマルチAgentが並列レビューを実行します($5-20/回)。さらに(1)自作9-Subagentアプローチ(.claude/commands/でローカル実行)、(2)GitHub Actions + claude-code-action(APIキーのみ必要)、(3)GitLab CI/CD beta統合があります。GitHubの自動トリガーとPRインラインコメントを提供する公式マネージドCode Reviewサービスのみ、Team/Enterprise限定です。
/ultrareviewと公式Code Reviewの違いは何ですか?
/ultrareviewはリサーチプレビュー機能で、クラウドサンドボックスで複数のレビューAgentを起動し、それぞれ異なる角度(ロジック、セキュリティ、パフォーマンス、エッジケース)からコードを分析します。独立して再現・検証された発見のみ報告されます。Pro/Maxアカウントで利用可能、$5-20/回。公式Code ReviewはTeam/Enterprise限定のGitHubマネージドサービスで、PRページにインラインコメントを自動生成、$15-25/回。簡潔に言えば:/ultrareviewは深いバグハンティング、公式版はワークフロー統合です。
トリガーモードを間違えると本当に請求が急増しますか?最もコスパの良い設定は?
はい。「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年5月時点)。/ultrareviewはローカルCLIから実行するため、プラットフォームを問いません。GitLabには公式CI/CD beta統合があり(ANTHROPIC_API_KEYを設定)。Bitbucketは公式サポートなし、コミュニティのDIYソリューションのみ。GitLabやBitbucketがメインなら、3プラットフォームをネイティブサポートするCodeRabbitがより成熟した選択肢です。
この記事は役に立ちましたか?



