Code Review
マルチエージェント分析を使用してコードベース全体を検査し、ロジックエラー、セキュリティ脆弱性、リグレッションを検出する自動化された PR レビューを設定します
Code Review はリサーチプレビュー段階であり、Team および Enterprise サブスクリプションで利用可能です。Zero Data Retention が有効になっている組織では利用できません。その他のプランでは、/code-review コマンドを使用してローカルで差分をレビューすることができます。
Code Review は GitHub プルリクエストを分析し、コードの問題が見つかった行にインラインコメントとして結果を投稿します。特化したエージェントのフリートがコード変更をコードベース全体のコンテキストで検査し、ロジックエラー、セキュリティ脆弱性、壊れたエッジケース、微妙なリグレッションを探します。
結果は重大度でタグ付けされ、PR を承認またはブロックしないため、既存のレビューワークフローはそのまま機能します。リポジトリに CLAUDE.md または REVIEW.md ファイルを追加することで、Claude がフラグを立てる内容をカスタマイズできます。
Claude を管理サービスではなく独自の CI インフラストラクチャで実行する場合は、GitHub Actions または GitLab CI/CD を参照してください。自己ホスト型 GitHub インスタンス上のリポジトリについては、GitHub Enterprise Server を参照してください。
このページでは以下をカバーしています:
- レビューの仕組み
- セットアップ
@claude reviewと@claude review alwaysを使用したレビューの手動トリガーCLAUDE.mdとREVIEW.mdを使用したレビューのカスタマイズ- 料金
- トラブルシューティング失敗した実行と欠落したコメント
- ローカルで差分をレビューする
/code-reviewコマンドを使用
レビューの仕組み
管理者が組織の Code Review を有効にすると、リポジトリの設定された動作に応じて、PR が開かれたとき、すべてのプッシュ時、または手動でリクエストされたときにレビューがトリガーされます。PR で @claude review とコメントすると、任意のモードでレビューが開始されます。
レビューが実行されると、複数のエージェントが Anthropic インフラストラクチャ上で並行して diff と周囲のコードを分析します。各エージェントは異なるクラスの問題を探し、その後、検証ステップが候補を実際のコード動作に対してチェックして、偽陽性を除外します。結果は重複排除され、重大度でランク付けされ、問題が見つかった特定の行にインラインコメントとして投稿され、レビュー本文に概要が記載されます。問題が見つからない場合、Code Review は GitHub チェック実行を更新して、問題が検出されなかったことを表示します。Claude は PR に短い確認コメントを投稿することもあります。
レビューはコストが PR のサイズと複雑さに応じてスケーリングされ、平均 20 分で完了します。管理者は分析ダッシュボードを通じてレビューアクティビティと支出を監視できます。
重大度レベル
各結果は重大度レベルでタグ付けされます:
| マーカー | 重大度 | 意味 |
|---|---|---|
| 🔴 | Important | マージ前に修正すべきバグ |
| 🟡 | Nit | 軽微な問題、修正する価値があるがブロッキングではない |
| 🟣 | Pre-existing | コードベースに存在するが、この PR で導入されなかったバグ |
結果には、展開可能な拡張推論セクションが含まれており、Claude がなぜ問題をフラグ立てしたのか、どのように問題を検証したのかを理解するために展開できます。
結果に対する評価と返信
Claude からの各レビューコメントには、👍 と 👎 が既に添付されているため、GitHub UI で両方のボタンがワンクリック評価のために表示されます。結果が有用だった場合は 👍 をクリックし、間違っていたか騒々しかった場合は 👎 をクリックしてください。Anthropic は PR がマージされた後にリアクションカウントを収集し、それを使用してレビュアーをチューニングします。リアクションは再レビューをトリガーしたり、PR 上の何かを変更したりしません。
インラインコメントに返信しても、Claude が応答したり PR を更新したりするようにプロンプトされません。結果に対処するには、コードを修正してプッシュしてください。PR がプッシュトリガーレビューにサブスクライブされている場合、次の実行は問題が修正されるとスレッドを解決します。プッシュせずに新しいレビューをリクエストするには、トップレベルの PR コメントとして @claude review とコメントしてください。
結果を却下するにはコード変更なしでスレッドを解決してください。返信しても却下されません。
チェック実行出力
インラインレビューコメントに加えて、各レビューは CI チェックと並んで表示される Claude Code Review チェック実行を生成します。その Details リンクを展開して、すべての結果の概要を 1 か所で確認でき、重大度でソートされています:
| 重大度 | ファイル:行 | 問題 |
|---|---|---|
| 🔴 Important | src/auth/session.ts:142 |
トークン更新がログアウトと競合し、古いセッションがアクティブなままになる |
| 🟡 Nit | src/auth/session.ts:88 |
parseExpiry は不正な形式の入力で黙って 0 を返す |
各結果は、Files changed タブの注釈としても表示され、関連する diff 行に直接マークされます。Important の結果は赤いマーカーで、nit は黄色の警告で、既存のバグは灰色の通知でレンダリングされます。注釈と重大度テーブルはインラインレビューコメントとは独立してチェック実行に書き込まれるため、移動した行のインラインコメントが GitHub に拒否された場合でも利用可能なままです。
チェック実行は常に中立的な結論で完了するため、ブランチ保護ルールを通じてマージをブロックすることはありません。Code Review の結果に基づいてマージをゲートしたい場合は、チェック実行出力から重大度の内訳を読み取り、独自の CI で使用してください。Details テキストの最後の行は、ワークフローが gh と jq で解析できるマシン可読コメントです。コミットのチェック実行を一覧表示するには、gh api repos/OWNER/REPO/commits/<commit-sha>/check-runs --jq '.check_runs[] | {id, name}' を使用して、Claude Code Review 実行の id を取得します。OWNER、REPO、CHECK_RUN_ID をリポジトリ所有者、リポジトリ名、およびそのID に置き換えます:
gh api repos/OWNER/REPO/check-runs/CHECK_RUN_ID \
--jq '.output.text | split("bughunter-severity: ")[1] | split(" -->")[0] | fromjson'
これは重大度ごとのカウントを含む JSON オブジェクトを返します。例えば {"normal": 2, "nit": 1, "pre_existing": 0} です。normal キーは Important の結果のカウントを保持します。ゼロ以外の値は、Claude がマージ前に修正する価値のあるバグを少なくとも 1 つ見つけたことを意味します。
Code Review がチェックする内容
デフォルトでは、Code Review は正確性に焦点を当てています:フォーマット設定の好みやテストカバレッジの欠落ではなく、本番環境を壊すバグです。リポジトリにガイダンスファイルを追加することで、チェック内容を拡張できます。
Code Review のセットアップ
管理者が組織に対して Code Review を 1 回有効にし、含めるリポジトリを選択します。
Claude Code 管理設定を開く
claude.ai/admin-settings/claude-code にアクセスして、Code Review セクションを見つけます。Claude 組織での Owner または Primary Owner ロールと GitHub 組織に GitHub Apps をインストールする権限が必要です。
セットアップを開始する
Setup をクリックします。これにより GitHub App インストールフローが開始されます。
Claude GitHub App をインストールする
プロンプトに従って Claude GitHub App をインストールします。レビュー対象のリポジトリを所有する GitHub 組織を選択し、アプリがアクセスできるリポジトリを選択して、リクエストされた権限を承認します。
Claude が pull request をレビューするには、アプリの読み取りアクセスを通じてリポジトリコンテンツを読み取り、その書き込みアクセスを通じて pull requests とチェックに対してコメントと check run を投稿します。インストール中に、GitHub Actions などの他の Claude 機能によって共有される、より広い権限セットを付与します。詳細なリストについては GitHub App permissions を参照してください。
リポジトリを選択する
Code Review を有効にするリポジトリを選択します。リポジトリが表示されない場合は、インストール中に Claude GitHub App にアクセス権を付与したことを確認してください。後でリポジトリを追加できます。
リポジトリごとにレビュートリガーを設定する
セットアップが完了すると、Code Review セクションはリポジトリをテーブルに表示します。各リポジトリについて、Review Behavior ドロップダウンを使用してレビューが実行されるタイミングを選択します:
- Once after PR creation: PR が開かれるか ready for review としてマークされたときにレビューが 1 回実行されます
- After every push: PR ブランチへのすべてのプッシュでレビューが実行され、PR が進化するにつれて新しい問題をキャッチし、フラグが立てられた問題を修正するとスレッドを自動解決します
- Manual: PR を開くか PR ブランチにプッシュしてもレビューは開始されません。
@claude reviewとコメントしてレビューをリクエストするか、@claude review alwaysとコメントして、その後のプッシュでレビューに PR をサブスクライブします
どのオプションを選択しても、Claude は fork からの pull request をレビューするのは、誰かが @claude review とコメントしたときだけです。
すべてのプッシュでレビューすると、最も多くのレビューが実行され、最もコストがかかります。Manual モードは、特定の PR をレビューにオプトインしたい高トラフィックリポジトリ、または PR が ready になったら PR のレビューを開始したい場合に便利です。
リポジトリテーブルは、最近のアクティビティに基づいて各リポジトリの平均レビューコストも表示します。行アクションメニューを使用して、リポジトリごとに Code Review をオンまたはオフにするか、リポジトリを完全に削除します。
セットアップを確認するには、テスト PR を開きます。自動トリガーを選択した場合、Claude Code Review という名前のチェック実行が数分以内に表示されます。Manual を選択した場合は、PR で @claude review とコメントして最初のレビューを開始します。チェック実行が表示されない場合は、リポジトリが管理設定に一覧表示されていることと、Claude GitHub App がアクセス権を持っていることを確認してください。
レビューを手動でトリガーする
コメントコマンドはオンデマンドでレビューを開始します。リポジトリの設定されたトリガーに関係なく機能するため、Manual モードで特定の PR をレビューにオプトインするか、他のモードで即座に再レビューを取得するために使用できます。
| コマンド | 実行内容 |
|---|---|
@claude review |
サブスクライブせずに単一のレビューを開始します |
@claude review always |
レビューを開始し、その後のプッシュでレビューがトリガーされるように PR をサブスクライブします |
@claude review once |
@claude review と同じです。サブスクライブせずに単一のレビューを開始します |
Manual モードに設定されたリポジトリの高優先度 PR など、PR への後続のすべてのプッシュで新しいレビューを開始したい場合は、@claude review always を使用します。ベアコマンドは PR をサブスクライブしないため、後続のプッシュがレビューをトリガーするかどうかを変更せずに、1 回限りの 2 番目の意見をリクエストできます。
2026 年 7 月の更新前は、@claude review は PR を push トリガーレビューにサブスクライブしていました。その動作に依存していた場合は、代わりに @claude review always をコメントしてください。@claude review once は引き続き機能し、ベアコマンドと同じように動作します。
これらのコマンドのいずれかでレビューをトリガーするには:
- トップレベルの PR コメントとして投稿し、diff 行のインラインコメントではない
- コメントの開始にコマンドを配置し、
onceまたはalwaysをコマンドの残りの部分と同じ行に配置します - リポジトリへの書き込み、メンテナンス、または管理者権限を持つ必要があります
- PR は開いている必要があります
リポジトリが組織に属し、その組織でのメンバーシップが非公開である場合(GitHub のデフォルト)、GitHub は Claude にメンバーとして識別されません。Claude はコメントに 👀 で反応する可能性がありますが、チームまたは組織のベース権限が書き込みアクセスを提供している場合でも、リポジトリに直接コラボレーターとして追加されていない限り、レビューは開始されません。これを修正するには、組織のメンバーシップを公開するか、リポジトリ管理者にリポジトリにコラボレーターとして追加するよう依頼してください。
自動トリガーとは異なり、手動トリガーはドラフト PR で実行されます。明示的なリクエストはドラフトステータスに関係なく、今すぐレビューが必要であることを示すためです。
その PR でレビューが既に実行されている場合、リクエストは進行中のレビューが完了するまでキューに入ります。PR のチェック実行を通じて進捗を監視できます。
フォークからのプルリクエストをレビューする
Claude はリポジトリの Review Behavior 設定に関係なく、フォークからのプルリクエストを自動的にレビューしません。開始するには、プルリクエストに @claude review をコメントしてください。コメントコマンドの要件は引き続き適用され、必要な書き込みアクセスはフォークではなくベースリポジトリへのアクセスです。
フォークプルリクエストの別のレビューを取得するには、新しい @claude review コメントを投稿してください。@claude review always も機能しますが、後続のプッシュでプルリクエストをレビューにサブスクライブしません。フォークプルリクエストでレビューを開始するのはコメントコマンド以外の何もありません:
- チェック実行で Re-run をクリックしてもレビューは開始されません
- 新しいコミットをプッシュしてもレビューは開始されません。After every push に設定されたリポジトリでも同様です
レビューをカスタマイズする
Code Review はリポジトリから 2 つのファイルを読み取り、フラグを立てる内容をガイドします。これらは、リビューにどの程度強く影響するかが異なります:
CLAUDE.md: Claude Code がすべてのタスク(レビューだけではなく)に使用する共有プロジェクト指示。Code Review はそれをプロジェクトコンテキストとして読み取り、新しく導入された違反を nit としてフラグ立てします。REVIEW.md: レビューのみのガイダンス、レビューパイプラインの検出と検証を行うエージェントに与えられ、結果をランク付けして報告するエージェントによって参照されます。チームがフラグを立てたいもの、どの重大度で、結果がどのように報告されるかを指定するために使用します。
CLAUDE.md
Code Review はリポジトリの CLAUDE.md ファイルを読み取り、新しく導入された違反をnit レベルの結果として扱います。これは双方向に機能します:PR が CLAUDE.md ステートメントを古くする方法でコードを変更する場合、Claude はドキュメントを更新する必要があることをフラグ立てします。
Claude はディレクトリ階層のすべてのレベルで CLAUDE.md ファイルを読み取るため、サブディレクトリの CLAUDE.md のルールはそのパスの下のファイルにのみ適用されます。CLAUDE.md の仕組みの詳細については、memory ドキュメントを参照してください。
一般的な Claude Code セッションに適用したくないレビュー固有のガイダンスについては、代わりにREVIEW.mdを使用します。
REVIEW\.md
REVIEW.md はリポジトリルートのファイルで、Code Review をリポジトリに合わせて調整します。レビューパイプラインの結果を検出および検証するエージェントはその内容をリポジトリのレビュー指示として受け取り、Code Review のデフォルトレビューガイダンスと並行して、結果をランク付けして報告するエージェントはそれを参照してから重大度を決定し、レビューを作成します。
フラグを立てたいルールを REVIEW.md に直接配置します。
チューニング可能な内容
REVIEW.md はフリーフォーム markdown であるため、レビュー指示として表現できるものはすべてスコープ内です。以下のパターンは実際に最も影響があります。
重大度: リポジトリの 🔴 Important の意味を再定義します。デフォルトのキャリブレーションは本番コードをターゲットにしています。ドキュメントリポジトリ、設定リポジトリ、またはプロトタイプは、はるかに狭い定義が必要な場合があります。Important である結果のクラスと、最大でも Nit である結果のクラスを明示的に述べます。別の方向にエスカレートすることもできます。例えば、デフォルトの nit ではなく、CLAUDE.md 違反を Important として扱う場合です。
Nit ボリューム: 単一のレビューが投稿する 🟡 Nit コメントの数をキャップします。散文と設定ファイルは永遠に磨くことができます。「最大 5 つの nit を報告し、残りを概要のカウントとして言及する」というようなキャップは、レビューを実行可能に保ちます。
スキップルール: Claude が結果を投稿しないべきパス、ブランチパターン、結果カテゴリを一覧表示します。一般的な候補は、生成されたコード、ロックファイル、ベンダーされた依存関係、マシン作成ブランチ、および linting やスペルチェックなど CI が既に実装しているものです。完全な精査を保証しないが何らかのレビューを保証するパスについては、完全にスキップするのではなく、より高いバーを設定します:「scripts/ では、ほぼ確実で重大な場合のみ報告します」。
リポジトリ固有のチェック: すべての PR でフラグを立てたいルールを追加します。例えば「新しい API ルートには統合テストが必要」。REVIEW.md はレビューパイプラインのすべての検出および検証エージェントに直接到達するため、これらは長い CLAUDE.md の同じルールよりも確実に着地します。
検証バー: 結果クラスが投稿される前に証拠を要求します。例えば「動作クレームは命名からの推論ではなく、ソースの file:line 引用が必要」は、そうでなければ著者に往復を費やさせる偽陽性を削減します。
再レビュー収束: PR が既にレビューされている場合、Claude がどのように動作するかを伝えます。「最初のレビュー後、新しい nit を抑制し、Important の結果のみを投稿する」というようなルールは、1 行の修正がスタイルだけで 7 ラウンド目に到達するのを防ぎます。
概要の形状: レビュー本文が 2 factual, 4 style のような 1 行のタリーで開くことを要求し、その場合は「ファクチュアルな問題なし」で始めることを要求します。著者は詳細の前に作業の形状を知りたいです。
例
この REVIEW.md はバックエンドサービスの重大度を再キャリブレーションし、nit をキャップし、生成されたファイルをスキップし、リポジトリ固有のチェックを追加します。
# レビュー指示
## ここで Important が意味するもの
Important は、動作を壊す、データをリークする、またはロールバックをブロックする結果のために予約します:不正なロジック、スコープされていないデータベースクエリ、ログまたはエラーメッセージの PII、および後方互換性のないマイグレーション。スタイル、命名、リファクタリング提案は最大でも Nit です。
## Nit をキャップする
レビューごとに最大 5 つの Nit を報告します。さらに見つけた場合は、インラインで投稿する代わりに、概要で「plus N similar items」と言います。見つけたすべてが Nit の場合、概要を「No blocking issues」で始めます。
## 報告しない
- CI が既に実装しているもの:lint、フォーマット、型エラー
- `src/gen/` の下の生成されたファイルと任意の `*.lock` ファイル
- 本番ルールを意図的に違反するテストのみのコード
## 常にチェック
- 新しい API ルートには統合テストがある
- ログ行にメールアドレス、ユーザー ID、またはリクエスト本文が含まれていない
- データベースクエリは呼び出し元のテナントにスコープされている
フォーカスを保つ
長さはコストがあります:長い REVIEW.md は最も重要なルールを薄めます。レビュー動作を変更する指示に保ち、一般的なプロジェクトコンテキストは CLAUDE.md に残します。
使用状況を表示する
claude.ai/analytics/code-review にアクセスして、組織全体の Code Review アクティビティを確認します。ダッシュボードは以下を表示します:
| セクション | 表示内容 |
|---|---|
| PRs reviewed | 選択した時間範囲でレビューされたプルリクエストの日次カウント |
| Cost weekly | Code Review の週次支出 |
| Feedback | 開発者が問題に対処したため自動解決されたレビューコメントのカウント |
| Repository breakdown | リポジトリごとのレビューされた PR とコメント解決のカウント |
ダッシュボードのコスト数値は活動を監視するための推定値です。請求書に正確な支出については、Anthropic の請求書を参照してください。
料金
Code Review はトークン使用量に基づいて課金されます。各レビューの平均コストは $15~25 で、PR のサイズ、コードベースの複雑さ、検証が必要な問題の数に応じてスケーリングします。Code Review の使用量は 使用クレジット を通じて個別に課金され、プランに含まれる使用量にはカウントされません。
選択するレビュートリガーは総コストに影響します。
- PR 作成後に 1 回: PR ごとに 1 回実行されます
- すべてのプッシュ後: 各プッシュで実行され、プッシュ数によってコストが乗算されます
- 手動: オープンまたはプッシュ時にレビューは実行されないため、コストはユーザーがリクエストしたレビューからのみ発生します
PR 作成後に 1 回または手動モードでは、@claude review always とコメントすると PR がプッシュトリガーレビューにオプトインされ、そのコメント後のプッシュごとに追加コストが発生します。すべてのプッシュ後モードでは、プッシュは既にレビューをトリガーするため、サブスクリプションはプッシュごとのコストを変更しません。@claude review とコメントすると、将来のプッシュにサブスクライブせずに単一のレビューが実行されます。Claude は フォークからのプルリクエスト をレビューするのは、ユーザーが @claude review とコメントした場合のみであるため、フォークプルリクエストはどのモードでもプッシュごとのコストを発生させません。
組織が他の Claude Code 機能に Amazon Bedrock または Google Cloud の Agent Platform を使用しているかどうかに関わらず、コストは Anthropic の請求書に表示されます。Code Review の月間支出上限を設定するには、claude.ai/admin-settings/usage にアクセスして Claude Code Review サービスの制限を設定してください。
分析 の週間コストチャートまたは管理設定のリポジトリごとの平均コスト列を通じて支出を監視してください。
トラブルシューティング
レビュー実行はベストエフォートです。失敗した実行は PR をブロックすることはありませんが、自動的に再試行されることもありません。このセクションでは、失敗した実行から回復する方法と、チェック実行が報告する問題が見つからない場合に確認する場所について説明します。
失敗またはタイムアウトしたレビューを再トリガーする
レビューインフラストラクチャが内部エラーに遭遇するか、時間制限を超える場合、チェック実行は Code review encountered an error または Code review timed out というタイトルで完了します。結論は依然として中立的であるため、マージをブロックするものはありませんが、結果は投稿されません。
レビューを再度実行するには、PR で @claude review とコメントしてください。これは PR を今後のプッシュにサブスクライブせずに新しいレビューを開始します。PR が フォークから のものでない場合、GitHub の Checks タブの Claude Code Review チェックで Re-run をクリックすることもできます。再実行も PR をサブスクライブせずに新しいレビューを開始します。
レビューが実行されず、PR が支出上限メッセージを表示する
組織の月次支出上限に達すると、Code Review は PR に単一のコメントを投稿し、レビューがスキップされたことを説明します。レビューは次の請求期間の開始時に自動的に再開されるか、管理者が claude.ai/admin-settings/usage で上限を引き上げるとすぐに再開されます。
インラインコメントとして表示されていない問題を見つける
チェック実行タイトルが問題が見つかったと言っているが、diff にインラインレビューコメントが表示されない場合は、結果が表示されるこれらの他の場所を確認してください:
- チェック実行 Details: Checks タブの Claude Code Review チェックの横にある Details をクリックします。重大度テーブルは、インラインコメントが受け入れられたかどうかに関係なく、ファイル、行、概要を含むすべての結果を一覧表示します。
- Files changed 注釈: PR の Files changed タブを開きます。結果はレビューコメントとは別に、diff 行に直接添付された注釈としてレンダリングされます。
- レビュー本文: レビューが実行されている間に PR にプッシュした場合、一部の結果は現在の diff に存在しなくなった行を参照する場合があります。これらは、インラインコメントではなく、レビュー本文テキストの Additional findings 見出しの下に表示されます。
ローカルで差分をレビューする
/code-review コマンドはターミナルで差分をレビューし、GitHub App をインストールせずに実行します。正確性バグと再利用、簡素化、効率化のクリーンアップを報告します。
/review は /code-review のエイリアスです。v2.1.223 より前は、GitHub プルリクエストの単一パス読み取り専用レビューを実行する別のコマンドでした。
/code-review を実行する
作業しているセッションから、コマンドを実行します:
/code-review
ブランチのアップストリームより先のコミットと未コミット変更をレビューするため、レポートするものがあるようにブランチまたはワーキングツリーで作業する必要があります。別のものをレビューするには、ターゲットを渡します:ファイルパス、PR 番号、ブランチ名、または main...my-feature などの ref 範囲です。
フラグを追加することもできます:
--fix:レビュー後に結果をワーキングツリーに適用します--comment:GitHub プルリクエストにインラインコメントとして結果を投稿するか、GitLab マージリクエストに単一のノートとして投稿します--post:github.comプルリクエストのultraクラウドレビューで、起動ダイアログで PR に結果を投稿することを事前選択します。プルリクエストに結果を投稿するを参照してください。Claude Code v2.1.227 以降が必要です
GitLab マージリクエストに --comment を渡すと、Claude Code は GitLab の glab CLI を通じて結果を投稿します。Claude Code v2.1.257 以降が必要です。glab がインストールされていない場合、Claude はターミナルに結果を出力します。
マージリクエストを URL または !123 参照として渡します。Claude Code は、チェックアウトのオリジンが gitlab.com 上にある場合にのみ、ベアな番号またはブランチ名をマージリクエストとして扱います。自己管理 GitLab インスタンスでは、URL または !123 形式を渡します。
作業を続ける
レビューは独自のコンテキストウィンドウを持つバックグラウンドサブエージェントとして実行されるため、会話を埋めません。結果はレビューが完了したときに会話に到着します。
結果に対応する
Claude にレビューが見つけたものを修正するよう依頼します。--fix または --comment を渡した場合、レビューはすでに結果を適用または投稿しています。
Claude は以下の両方の実行で、ホストアプリケーションが結果リストをリクエストした場合でも、返信のテキストとして結果を報告します:
- ターミナルセッション。ここで
/code-reviewはフォークされたサブエージェントとしてレビューを実行します - テキストまたは JSON 出力を含む
-p実行
デスクトップアプリなどの結果リストをリクエストするホストアプリケーションでは、Claude はReportFindings ツールを通じてレビューの結果を報告します。Claude Code は結果を結果リストとしてレンダリングし、各エントリはファイルの場所、1 文の要約、および結果が持つ場合は correctness などのカテゴリタグを表示します。ホストリクエストはすべての努力レベルで適用され、Claude Code v2.1.218 以降が必要です。
Claude が後でセッションで報告された結果を修正すると、それらを再度報告し、Claude Code は更新された結果リストの各結果を修正済み、スキップ済み、または変更不要としてマークします。
レビューが読み取り、編集するもの
レビューは任意の Claude Code セッションのように CLAUDE.md に従いますが、REVIEW.mdは読み取りません。バックグラウンドレビューはその --fix 編集をセッションのチェックポイントの外で適用するため、/rewind はそれらを元に戻しません。git を使用してそれらを戻します。レビューがフォアグラウンドで実行される場合、独自のターン中にワーキングツリーを編集するため、/rewind は通常どおりその編集を復元します。
努力とアーギュメントを調整する
努力レベルを渡してカバレッジと信頼度をトレードオフします。low と medium では、レビューは最も確信している結果のみを報告するため、偽陽性が少なくなります。high から max はカバレッジを広げ、レビューが確信していない結果を含む場合があります。
レベルを入力しない場合、レビューは以前のセッションでも、入力した low から max の最後のレベルを再利用し、Claude Code は Reusing high effort, the level you typed last time などの通知を表示します。/code-review high のようにレベルを入力して、後の実行が再利用するものを変更します。非対話型 -p 実行で渡すレベルはそれを更新しません。ultra は記憶されたレベルを更新も使用もしません。レベルを入力したことがない場合、レビューはセッションの現在の努力を使用します。v2.1.223 より前は、レベルのない /code-review は常にセッションの現在の努力を使用していました。
努力レベルとフラグの後、Claude Code は行の残りを 2 つの方法のいずれかで読み取ります:
ultraなし:残りのすべてはレビューターゲットです。別のコマンド名で始まる場合でも同様です。/code-review /fix-issue 123は/fix-issue 123をターゲットテキストとしてレビューし、/fix-issueを 2 番目のスタックされたスキルとして読み込みません。v2.1.218 より前は、/code-reviewの後にスタックされたコマンドは独自のスキルとして展開されました。ultraあり:Claude Code は単一の単語をベースブランチまたは PR 番号として読み取り、ブランチまたは PR に名前を付けない長いテキストをレビューに添付されたノートに変換します。/code-review ultra check my auth changesは現在のブランチをレビューし、Claude は結果をノートに関連付けます。
フォアグラウンドで実行する
レビューはデフォルトでバックグラウンドで実行されます。v2.1.218 より前は、会話内で実行されました。以下のような場合はフォアグラウンドで実行されます:
- 前のレビューがまだ進行中に
/code-reviewを再度実行する - 非対話型モード(
-pフラグまたは Agent SDK)で実行します。Claude Code はレビューを待機し、結果を応答に含めます。ただしultraは除きます。これはクラウドレビューを待たずに起動します CLAUDE_CODE_DISABLE_BACKGROUND_TASKSを1に設定します。これはすべての他のバックグラウンドタスク機能もオフにします
Claude にレビューを開始させる
Claude は独自に /code-review を開始できます。変更をレビューするよう平文で依頼すると、コマンドを入力せずにスキルを実行でき、プロンプトとして /code-review を持つスケジュールされたタスクはレビューを実行します。
スケジュールされたタスクはクラウドレビューを起動しないため、ultra 引数なしで /code-review をスケジュールします。
Claude とスケジュールされたタスクがレビューを開始するのを停止しながら、入力するために /code-review を利用可能に保つには、~/.claude/settings.json などの設定ファイルにskillOverridesエントリを追加します:
{
"skillOverrides": {
"code-review": "user-invocable-only"
}
}
v2.1.246 より前は、Claude は Anthropic から取得されたフィーチャーフラグがオンになった場所でのみ独自に /code-review を開始しました。フィーチャーフラグを取得しないセッションでは、/code-review は入力したときのみ実行され、スケジュールされた /code-review は平文として Claude に到達しました。
ultrareview にエスカレートする
/code-review ultra --fix はクラウドでより深いultrareviewを実行し、セッションに戻ってきたときに結果をワーキングツリーに適用します。
Ultrareview は独自のスコープを使用します:現在のブランチとリポジトリのデフォルトブランチ、およびワーキングツリーの未コミットおよびステージされた変更です。.env および *.tfvars ファイルなどの認証情報またはキーのような名前のファイルの未コミット変更については、Claude Code はローカルリポジトリをクラウドセッションにアップロードするためのルールに従います。/code-review ultra develop などのブランチ名を渡して、別のベースと比較します。
ターゲットが github.com プルリクエストの場合、Claude に完成した結果を PR に投稿させることができます。GitHub アカウントからのコメントとして。Claude Code v2.1.227 以降が必要です。
Ultrareview は claude.ai アカウントでの認証が必要であり、Amazon Bedrock、Google Cloud の Agent Platform、Microsoft Foundry、または Zero Data Retention が有効な組織では利用できません。ultrareview が利用できない場合、/code-review ultra はセッション内でローカルレビューを実行します。
スクリプトまたは CI からクラウドレビューを開始するには、claude -p '/code-review ultra' を実行します。Claude Code はレビューを起動し、追跡用のリンクを出力します。Claude Code v2.1.218 以降が必要です。
レビューが使用クレジットを請求する場合、Claude Code は起動前に停止します。請求確認には対話型セッションが必要なためです。代わりにclaude ultrareview サブコマンドを実行します。実行することで、料金に同意します。
このコマンドは v2.1.147 より前は /simplify という名前で、デフォルトで修正を適用していました。/simplify はバグを探さずに修正を適用するクリーンアップのみのレビューを実行します。バグ検出のために /simplify をスクリプト化した場合は、/code-review --fix に切り替えます。
関連リソース
- Commands: ローカルの Claude Code セッションで
/code-reviewを実行して、プッシュ前に差分をチェック - GitHub Actions: コードレビューを超えたカスタム自動化のための独自の GitHub Actions ワークフローで Claude を実行
- GitLab CI/CD: GitLab パイプライン用の自己ホスト型 Claude 統合
- Memory: Claude Code 全体で
CLAUDE.mdファイルがどのように機能するか - Analytics: コードレビューを超えた Claude Code 使用状況を追跡
- How Anthropic secures its AI-native software development lifecycle: 自動レビューが Anthropic のセキュアな開発プロセスの 1 つのレイヤーとしてどのように適合するか