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 skipped」で始まるコメントが付きます。文面で、どの上限かが分かります。

予算を戻したあとは、@claude review とコメントすると、見送られた分のレビューが出ます。費用の仕組みは Claude Code Review の料金 にまとめました。

失敗・時間切れの時の再実行

概要に「レビューが途中で中断されたが、新しいレビューが自動で予約された」という趣旨の文があれば、何もしなくて大丈夫です。1回だけ自動でやり直されます。

それ以外の「failed」「timed out」の時は、次のどちらかで出し直します。

指摘が行のコメントとして見えない時

「指摘あり」なのに、差分に行のコメントがない時は、次の3か所に出ています。

  1. チェックの Details:重要度の表に、ファイル・行・要約が並ぶ
  2. Files changed の注釈:行のコメントにならなかった指摘が、その行の注釈として出る
  3. レビューの本文:行の位置がない指摘や、差分の外の指摘は「Additional findings」の下に出る

REVIEW.md についての表示が出た時

チェックには、REVIEW.md についてのメッセージが付くことがあります。

REVIEW.md の書き方は REVIEW.md で指摘の重さと対象を調整する をご覧ください。

導入時につまずく2つの点

切り分けの順番(まとめ)

  1. チェックのタイトルを見る
  2. チェックがなければ、コメント命令の条件・権限・登録・予算を順に確認
  3. 失敗・時間切れは、コメントか Re-run
  4. 指摘が見えなければ、Details・Files changed・本文の3か所
  5. REVIEW.md の表示は、ブランチの保護とリンクの数を確認

出典:Troubleshoot Code Review(公式ドキュメント)

永上裕之

ユニコスクール株式会社 代表取締役。AIエージェント専門のスクール&コミュニティを運営しています。

この記事はAIを使って下書きし、著者が事実確認・加筆しています。ツールの機能や料金は変わることがあるため、最新の情報は各社の公式ページでご確認ください。

関連する記事