Code Reviewが動かない時の確認手順|チェックの表示で原因を探す

この記事の要点
- まず、プルリクエストの Claude Code Review のチェックの表示(タイトル)を見ると、どこまで進んだかが分かる
- コメント命令が効かない時は、リポジトリの登録・コメントの種類・書き込み権限・予算の4つを順に確かめる
- 失敗や時間切れは、コメントか再実行で出し直せる。指摘が見えない時は、チェックの詳細・変更ファイル・本文の3か所を見る
活用例:AIレビューが動かない・指摘が見えない時の原因の切り分け
- 部署
- 開発・情報システム
- 使うもの
- Claude Code の Code Review と GitHub のチェック
- AIに任せる
- レビューの実行と指摘
- 人が決める
- 再実行の判断・予算の追加・権限の付与
AIによるコードレビューを入れたのに、プルリクエストに何も付かない、失敗する、予算の表示が出る。そんな時は、闇雲に設定を触る前に、チェックの表示を見ると原因を絞れます。
この記事では、公式ドキュメント「Troubleshoot Code Review」(2026年11月17日確認)にもとづいて、確認の順番をまとめます。仕組みの全体像は Claude Code の Code Review の記事を先にご覧ください。
結論:最初に「Claude Code Review」のチェックのタイトルを見る
プルリクエストの中に、「Claude Code Review」というチェックが出ます。そのタイトルで、どこまで進んだかが分かります。
| タイトル | 意味 | 次にやること |
|---|---|---|
| Code review queued / in progress | まだ終わっていない | 待つ |
| Code review found no issues | 終わって、指摘なし | 最初のレビューでなければ、本文にある「見送った指摘の数」を確認 |
| 指摘があったという趣旨のタイトル | 終わって、指摘あり | 画面に見えなければ、後述の3か所を探す |
| Code review skipped — no new changes | 最新の push では自動で動かなかった | 必要なら @claude review とコメント |
| Code review not repeated — earlier findings still open | 前回の「重要」な指摘が残っているので、自動では動かなかった | 修正を push するか、@claude review とコメント |
| Code review failed / timed out | 終わらなかった | 後述の再実行 |
| Code review declined | 動かなかった | 概要を読む。予算や上限の話なら、後述の予算の項 |
| チェック自体がない | レビューが始まっていない | @claude review とコメント |
レビューが始まらない時
コメント命令が効かない
@claude review とコメントしても、チェックが出ない時は、次を確認します。目の絵文字が付いても、レビューが始まった印ではありません。
- リポジトリに Code Review が入っていない:何の返事も出ない。管理者(Owner)にリポジトリの追加を頼む
- コメントの条件に合っていない:インラインのコメントやレビュー本文ではなく、新しい通常のコメントで、先頭に命令を書く。前のコメントの編集は数えない。プルリクエストが開いている必要もある
- 書き込み権限がない:リポジトリへの write、maintain、admin のどれかが必要。フォークからのプルリクエストでは、元のリポジトリでの権限が基準
- 予算が尽きた:「⚠️ Code review skipped」で始まるコメントが付く
予算のメッセージが出る時
予算で見送られると、プルリクエストに「⚠️ Code review skipped」で始まるコメントが付きます。文面で、どの上限かが分かります。
- 月のレビュー費用の上限に達した:翌月の期間の初めに再開。早めたければ、管理者が上限を上げる
- 追加の使用量がない(使用クレジットの残高が空、または組織全体の月の上限に達した):管理者がクレジットを足すか、上限を上げる
- 次のレビューを始めるには残りが少ない:上限を上げるか、クレジットを足す
予算を戻したあとは、@claude review とコメントすると、見送られた分のレビューが出ます。費用の仕組みは Claude Code Review の料金 にまとめました。
失敗・時間切れの時の再実行
概要に「レビューが途中で中断されたが、新しいレビューが自動で予約された」という趣旨の文があれば、何もしなくて大丈夫です。1回だけ自動でやり直されます。
それ以外の「failed」「timed out」の時は、次のどちらかで出し直します。
@claude reviewとコメント:新しい通常のコメントで。これは、以後の push には付いてこない、その場の1回- Re-run をクリック:GitHub の「Checks」タブで、チェックの Re-run を押す。フォークからのものは対象外。いまの最新のコミットが対象で、以後の push には付いてこない
指摘が行のコメントとして見えない時
「指摘あり」なのに、差分に行のコメントがない時は、次の3か所に出ています。
- チェックの Details:重要度の表に、ファイル・行・要約が並ぶ
- Files changed の注釈:行のコメントにならなかった指摘が、その行の注釈として出る
- レビューの本文:行の位置がない指摘や、差分の外の指摘は「Additional findings」の下に出る
REVIEW.md についての表示が出た時
チェックには、REVIEW.md についてのメッセージが付くことがあります。
- 既定のブランチが、直接の push から保護されていない:根の REVIEW.md だけを読んだ、という意味。ブランチを保護すると、読まれる範囲が変わる
- ブランチの保護を確認できなかった:REVIEW.md を読まなかった
- 変更するファイルへのリンク、またはリンクが多すぎる:リンクは64本以内にする。壊れたリンクは直す。そのプルリクエストが変えるファイルへのリンクは、ルールを REVIEW.md の本文に直接書く
- include の行が飛ばされた:根の REVIEW.md は効いたが、その行が指す先のファイルが読まれなかった
REVIEW.md の書き方は REVIEW.md で指摘の重さと対象を調整する をご覧ください。
導入時につまずく2つの点
- リポジトリが追加の一覧に出ない:名前で検索する。Claude の GitHub App が見られるリポジトリだけが出るので、「Install GitHub App」でリポジトリへのアクセスを許可する
- テスト用のプルリクエストにチェックが出ない:「Allow code review」がオンか、リポジトリが一覧にあるか、アプリが見られるかを確認する。下書きのプルリクエストは自動では対象外。「Manual」のリポジトリは、最初に
@claude reviewが要る
切り分けの順番(まとめ)
- チェックのタイトルを見る
- チェックがなければ、コメント命令の条件・権限・登録・予算を順に確認
- 失敗・時間切れは、コメントか Re-run
- 指摘が見えなければ、Details・Files changed・本文の3か所
- REVIEW.md の表示は、ブランチの保護とリンクの数を確認
出典:Troubleshoot Code Review(公式ドキュメント)
この記事はAIを使って下書きし、著者が事実確認・加筆しています。ツールの機能や料金は変わることがあるため、最新の情報は各社の公式ページでご確認ください。


