プルリクエストのレビューを読む・リクエストする

GitHub のプルリクエストで Code Review の指摘を読み、返信または却下し、@claude review でレビューをリクエストします。

Code Review は、Claude 組織の Owner が一連の GitHub リポジトリに対してオンにするマネージドサービスです。オンにすると、Claude はそれらのリポジトリのプルリクエストをレビューし、指摘をインラインコメント、レビュー本文のサマリー、そして Claude Code Review という名前のチェックランとして投稿します。レビューがプルリクエストを承認したりブロックしたりすることはなく、チェックランが失敗として終了することもありません。

Owner は、リポジトリごとにレビューを実行するタイミングとレビューの詳細度を制御します。

[!NOTE]

プランに Code Review が含まれていない場合でも、Claude Code セッションから Claude にブランチをレビューさせることができます。/code-review でローカルにレビューするを参照してください。

重大度レベル

Claude は各指摘を該当する行へのインラインコメントとして投稿し、3 つの重大度レベルのいずれかでマークします。

レビューが推論を記録した場合、指摘には折りたたまれた Why this was flagged セクションがあります。これを展開すると、Claude がその問題を指摘した理由と、問題をどのように検証したかを読むことができます。

リポジトリで Claude が指摘する内容や重大度の判定方法を変更するには、Code Review をカスタマイズするを参照してください。

指摘に対応する

リポジトリ独自のルールで求められていない限り、指摘に対応しなくてもマージできます。ブランチ保護で会話の解決が必須になっている場合は、マージする前に各指摘のスレッドを解決してください。

指摘を解消するには、そのスレッドを解決するか、修正をプッシュします。

• コードを変更せずに却下する: GitHub 上で自分でスレッドを解決します。返信するだけでは指摘は却下されません。
• 問題を修正する: コードを変更してプッシュします。プルリクエストの次のレビューは、問題が修正されたと判断した場合に以前のスレッドを解決します。これは、そのレビューがプッシュで自動的に実行された場合でも、リクエストによって実行された場合でも同じです。
• 説明する、または反論する: コメントに返信します。Claude はすぐには応答せず、返信によってレビューが開始されることもありません。プルリクエストの次のレビューが以前の指摘への返信を読み、スレッドを解決するか、フォローアップの返信を 1 件投稿することがあります。同じ種類の指摘が繰り返し出る場合は、メンテナーに REVIEW.md へのルール追加を依頼してください。

プッシュせずに次のレビューを実行するには、@claude review をプルリクエストのトップレベルコメントとして投稿します。

チェックランの出力

Claude Code Review チェックランの Details リンクを開くと、GitHub がインラインコメントを受け付けなかった指摘も含め、すべての指摘が重大度順に並んだ 1 つの表で表示されます。

行情報があるもののインラインコメントとして投稿されなかった指摘は、Files changed タブの該当行にアノテーションとして表示されます。Important の指摘は赤、Nit は黄、既存のバグはグレーで表示されます。

チェックランは neutral として終了します。ファイルを変更せず以前の結果を維持する一部のプッシュの後は skipped として終了します。失敗として終了することはないため、完了したレビューが必須チェックを失敗させることはありません。指摘が表示されない場合やレビューが実行されなかった場合は、Code Review のトラブルシューティングを参照してください。

プッシュで以前の結果が維持される場合

プッシュ後にチェックランのタイトルが次のいずれかになっている場合、Code Review は新しいレビューを開始せず、以前のレビューの結果を維持しています。

• Code review skipped — no new changes: 以前のレビューの Important の指摘で未解決のものは残っていないため、新しいレビューは不要です
• Code review not repeated — earlier findings still open: 新しいレビューを開始するには、未解決の Important の指摘に対する修正をプッシュするか、そのスレッドを解決してから再度プッシュします

github.com では、次の両方が成り立つ場合に Code Review が結果を維持することがあります。

• 空のコミット、ベースブランチのクリーンなマージ、クリーンなリベースの後など、プルリクエストが引き続き同じ行を追加・削除している
• そのレビュー以降、誰も Important の指摘のスレッドを解決していない

コードを変更せずにレビューを受けるには、@claude review とコメントするか、チェックランの Re-run をクリックします。

スクリプトから結果を読む

独自の CI でマージをゲートしたりサマリーを投稿したりするには、gh と jq を使って Details テキストの最終行を解析します。この行は、重大度ごとの件数を JSON として保持する HTML コメントです。

<!-- bughunter-severity: {"nit":1,"normal":2,"pre_existing":0} -->

その上の行には、プルリクエストのファイル名が含まれることがあります。テキストを独自の方法で解析する場合は、以下の手順のコマンドと同様に、件数を最終行からのみ取得してください。

1. チェックラン ID を見つける

シェルからコミットのチェックランを一覧表示し、Claude Code Review ランの id を取得します。OWNER と REPO をリポジトリのオーナーと名前に、<commit-sha> をプルリクエストの head コミットに置き換えてください。

gh api repos/OWNER/REPO/commits/<commit-sha>/check-runs --jq '.check_runs[] | {id, name}'

Re-run の後など、コミットに Claude Code Review ランが複数ある場合、GitHub は最新のものだけを一覧表示します。

2. 重大度ごとの件数を読む

Details テキストを保持するチェックランの output.text フィールドから件数を読み取ります。CHECK_RUN_ID を ID に置き換えてください。

gh api repos/OWNER/REPO/check-runs/CHECK_RUN_ID --jq '
  (.output.text | split("\n") | last
    | scan("^<!-- bughunter-severity: (.*) -->$")[0] | fromjson)?
  // error("no severity line")'

これにより、重大度ごとの件数を持ち、キーがアルファベット順に並んだ JSON オブジェクトが出力されます。例: {"nit": 1, "normal": 2, "pre_existing": 0}。以前の結果を維持したチェックランを除き、件数には、スレッドがまだ未解決のままになっているプルリクエストの以前のレビューによる指摘も含まれます。

タイトルが Code review skipped — no new changes の場合、件数には以前のレビューによる未解決の Nit と既存の指摘は含まれません。この場合、以前のレビューの Important の指摘で未解決のものは残っていません。

3. 結果に基づいて処理する

スクリプトで次のケースを順に処理するようにします。

• タイトルが Code review not repeated で始まる: Code Review は Important の指摘が未解決のままの以前の結果を維持しており、チェックランに重大度の行はありません。件数より先に gh api repos/OWNER/REPO/check-runs/CHECK_RUN_ID --jq .output.title でタイトルを読み取ります。マージをゲートしたい場合はジョブを失敗させます。
• タイトルが no new changes で終わる: 件数を読まずにジョブを成功させます
• normal が 0 より大きい: マージをゲートしたい場合はジョブを失敗させます。normal キーには Important の指摘の件数が入っているため、Claude がマージ前に修正すべきバグを少なくとも 1 件見つけたことを意味します。この件数のみを出力するには、閉じの単一引用符の前に | .normal を追加します。
• 行が存在しない: コマンドは件数の代わりに no severity line を含むエラーを出力し、0 以外のステータスで終了します。これは指摘 0 件ではなく、判定なしとして扱います。失敗した、タイムアウトした、キャンセルされた、または新しいレビューに置き換えられたレビューのチェックランにはこの行がなく、完了したレビューの中にもこの行がないものがあります。

レビューをリクエストする

プルリクエストがドラフトである場合やフォークからのものである場合、自動レビューはスキップされるため、コメントコマンドでレビューをリクエストしてください。プルリクエストのレビューを受けるには、次のいずれかを行います。

• オープンする、または ready にする: Once after PR creation または After every push に設定されたリポジトリでは、プルリクエストをオープンまたは再オープンしたとき、あるいはドラフトを ready for review にしたときにレビューが開始されます。
• コマンドをコメントする: プルリクエストに @claude review を投稿します。
• コミットをプッシュする: After every push に設定されたリポジトリ、または @claude review always でサブスクライブしたプルリクエストでは、プッシュによってレビューが開始されます。プッシュ後もプルリクエストが同じ行を追加・削除している場合、Code Review は代わりに以前の結果を維持することがあります。
• Re-run をクリックする: フォークからではないプルリクエストでレビューが失敗またはタイムアウトした場合は、チェックランから再実行します。フォークからではないプルリクエストでは、以前の結果が維持されたプッシュの後にも Re-run をクリックできます。
• 自動再試行を待つ: セッションが中断されたレビューは、自動的に 1 回再試行されます。再試行が行われている場合は、チェックランのサマリーにその旨が表示されます。

コメントコマンド

次のいずれかのコマンドをプルリクエストへのコメントとして投稿します。

After every push に設定されたリポジトリでは、サブスクリプションの有無にかかわらずプッシュによってレビューが開始されるため、コメントでレビューを停止することはできません。そのようなリポジトリで 1 つのプルリクエストについてプッシュによるレビューの開始を止めるには、そのプルリクエストをドラフトに変換してください。再び ready for review にすると、レビューが開始されます。

コメントコマンドを有効にするには、次の条件をすべて満たす必要があります。

• 新しいプルリクエストのトップレベルコメントとして投稿すること。差分の行へのインラインコメントやレビュー本文では機能しません。以前のコメントを編集しても対象になりません。
• コマンド全体をコメントの先頭の 1 行に書くこと。その後に他のテキストを続けてもかまいません。always や stop のスペルが間違っていたり、後の行に書かれていたりすると、Claude はそのコメントを単なる @claude review として読み取り、1 回だけレビューを開始します。大文字と小文字は区別されません。
• リポジトリに対する write、maintain、または admin 権限を持っていること。Claude はコメントした各ユーザーについて GitHub でこれを確認し、ボットからのコメントではレビューは開始されません。
• プルリクエストがオープンであること。

レビューを開始するコマンドが受け付けられると、Code review queued... というタイトルの Claude Code Review チェックランがプルリクエストに表示されます。レビューが開始されると、タイトルは Code review in progress... に変わります。Claude がコメントに 👀 でリアクションすることもありますが、このリアクションはレビューが開始されない場合にも表示されることがあるため、代わりにチェックランを確認してください。

プルリクエストの最新コミットですでにレビューが実行中の場合、新しいリクエストによって 2 つ目のレビューが開始されることはありません。

[!NOTE]

2026 年 7 月のアップデート以前は、@claude review によって PR がプッシュでトリガーされるレビューにサブスクライブされていました。その動作に依存していた場合は、代わりに @claude review always をコメントしてください。

以降のレビューの対象範囲

プッシュ後など、自動的に開始される以降のレビューは、前回のレビュー以降に変更された部分に焦点を当て、Nit や既存の問題の指摘を少なく投稿します。その結果として指摘が除外されたかどうかを確認するには、レビュー本文でその件数を示す文を探してください。

• 前回のレビュー以降に変更されていないコードに対する指摘: 文の末尾が "outside the scope of this re-review and not posted" となります
• Nit と既存の問題の指摘: 文の末尾が "found and not posted" となります

これらを何も除外しないレビューを受けるには、@claude review をコメントしてください。プルリクエスト全体が改めてレビューされます。

ドラフトとフォークからのプルリクエストをレビューする

自動レビューはこれらの両方をスキップするため、コメントコマンドでレビューをリクエストしてください。

• ドラフトのプルリクエスト: コメントコマンドはドラフトでも実行されるため、プルリクエストを ready にする前にレビューをリクエストできます。ドラフトへのプッシュでは、@claude review always の後でもレビューは開始されません。サブスクリプションは、プルリクエストを ready にした時点で有効になります。
• フォークからのプルリクエスト: リポジトリの Review runs 設定にかかわらず、Claude はフォークからのプルリクエストを自動的にはレビューしません。レビューを開始するには、プルリクエストに @claude review をコメントします。コメントコマンドの条件は引き続き適用され、必要な書き込み権限はフォークではなくベースリポジトリに対するものです。

フォークからのプルリクエストでも @claude review always は機能しますが、以降のプッシュでのレビューにプルリクエストがサブスクライブされることはありません。また、そこではチェックランの Re-run をクリックしてもレビューは開始されません。

Claude Code GitHub Action と併用する

リポジトリで Claude Code GitHub Action もデフォルトの @claude トリガーフレーズを使ったインタラクティブモードで実行している場合、@claude review コメントによって Action も開始されます。2 つを区別するには、Action の trigger_phrase 入力を別のフレーズに設定してください。

関連リソース

• Code Review のトラブルシューティング: 開始されなかった、失敗した、または予算のためにスキップされたレビュー
• Code Review: サービスの概要とレビューの実行方法
• Code Review をセットアップする: Owner 向け。Code Review をオンにし、レビューを実行するタイミングとレベルを選択する
• Code Review をカスタマイズする: REVIEW.md と CLAUDE.md で Claude が指摘する内容を変更する
• Code Review のコストと使用量: レビューの課金方法と支出上限の設定場所
• /code-review でローカルにレビューする: Claude Code セッションからブランチのレビューを実行する