Claude Code Reviewの指摘は解消しないと再カウントされる

Claude CodeのCode Review機能は、同じPRへの2回目以降のレビュー(フォローアップレビュー)で、前回までの指摘のうちまだ開いたままのものを一覧にして出します。Claude Code v2.1.268では、その一覧の下に注記が1行追加されました。指摘スレッドへ返信するだけでは解消扱いにならず、実際にスレッドを解消しない限り、次のレビューでも同じ指摘が開いたままとしてカウントされ続けるという内容です。

フォローアップレビューの「開いたまま」の指摘とは何か

Code Reviewは、PRが開いてから2回目以降にレビューが走ったとき、前のレビューで見つかった指摘のうちまだ解消されていないものをまとめて示します。ここでいう「解消(resolve)」は、コードの修正内容ではなくGitHubの各レビュースレッドが持つ解決状態そのものを指します。

公式changelogのv2.1.268には次の記述があります。

[Code Review] Added a note under the still-open findings list in follow-up reviews: resolving a finding's thread, not just replying to it, stops later reviews from counting it as open

フォローアップレビューが発生する条件は、PRのレビュートリガー設定によって変わります。「PR作成時に1回」モードは名前どおりPRが開いたときに1回走るだけで、自動的なフォローアップはありません。この設定のPRで前回の指摘が開いたままかどうかを確認するには、@claude reviewを投稿して手動でレビューを再実行する必要があります。「pushのたびに」モードを購読しているPRでは、次のpushのたびに自動でフォローアップレビューが走り、修正を検知したスレッドはそのタイミングで自動的に解消されます。「Manual」モードはどちらの自動トリガーも持たず、@claude review(単発)または@claude review always(以後のpushも購読)を投稿したときだけレビューが走ります。トリガーモードの全体像はClaude CodeでGitHub PR自動レビューを設定・運用するにまとめています。

GitHubのプルリクエストでは、1つのインラインコメントに返信を重ねると1本の会話(スレッド)としてまとまります。このスレッドには「Files changed」タブの下部に「Resolve conversation」というボタンが付いており、押すとスレッド全体が解決済みとしてマークされます。Code Reviewは指摘ごとに1本のスレッドを作るため、この解決状態がそのままフォローアップレビューでの「開いたまま」判定に使われる仕組みです。

チェック実行の「Details」に出る重大度別テーブルは、その回のレビューが検知した指摘をそのまま一覧化したものです。一方、フォローアップレビューの「開いたまま」の一覧は前回までの指摘のうち未解消のものだけを拾う仕組みなので、同じ指摘を指していても役割が異なります。

返信やリアクションでは指摘は解消されない

公式ドキュメントは、インラインコメントへの返信について明確に線を引いています。返信してもClaudeが応答したり内容を更新したりすることはなく、指摘に対応するにはコードを直してpushする必要があるとしています。各コメントには👍👎のリアクションボタンがあらかじめ付いていますが、これはAnthropicがPRマージ後に精度改善のための学習データとして集計するだけで、リアクション自体はレビューの再実行もPRの状態変更も引き起こしません。

指摘を消すために必要な操作は、次の4パターンに分かれます。

コードを直さずに指摘を却下したいとき

指摘が誤検知だった場合や、意図的に直さない判断をした場合はコードを変更する必要がありません。この場合に取る操作は1つで、GitHub上でそのスレッドの「Resolve conversation」を押すことです。公式ドキュメントも「コードを変更せずに指摘を却下するにはスレッドを解消する。返信だけでは却下したことにならない」と明記しています。

pushのたびにモードを購読しているPRでは、指摘対象の行を実際に直してpushすると、次のレビュー実行時に該当スレッドが自動で解消されます。ここが唯一「手を動かさずに解消される」ケースで、それ以外の指摘は人間がGitHub上で明示的に解消する以外に消える手段がありません。

v2.1.268で変わったのは注記の有無だけ

指摘スレッドの解消ルール自体は、v2.1.268より前から存在していた仕組みです。返信では解消にならず明示的な解消操作が必要という挙動そのものは公式ドキュメントの「Rate and reply to findings」節に元々書かれています。v2.1.268の変更点は、この事実を一覧の直下に注記として表示するようにした点だけです。ドキュメントを読んでいないと気づきにくかった挙動が、レビュー結果を見た瞬間に伝わるようになりました。

これまで「指摘に返信して経緯を説明したのに、次のレビューでも同じ指摘が開いたまま出てくる」という体験をしたことがあるなら、原因はスレッドを解消していなかったことにある可能性が高いです。この挙動自体は目新しいものではなく、GitHubのレビュースレッドが持つ「解決済み/未解決」という2値の状態を、Code Reviewがそのまま指摘のカウントに使っているだけと見ることもできます。返信という行為はGitHub側のスレッド状態を変えないため、Claudeにとっても「まだ開いている」以外の判定材料がありません。

pushせずに再レビューだけを走らせる

修正をまだpushしたくないが、スレッドを解消した後にフォローアップレビューの一覧が更新されたかだけ確認したい場合は、@claude reviewをPRのトップレベルコメントとして投稿すると、pushへの購読設定を変えずに単発のレビューを再実行できます。

gh pr comment 123 --body "@claude review"

このコマンドはPR番号123に対して@claude reviewとコメントを投稿するだけなので、alwaysを付けない限り以後のpushへの購読は発生しません。

REVIEW.mdの「再レビュー時の収束ルール」とは別の仕組み

REVIEW.mdには、同じPRへの再レビューが続くときに新規のNitを抑制するといった「再レビュー時の収束ルール」を書けます。これは今後投稿される指摘の量そのものを絞り込む設定であり、すでに投稿済みの指摘がフォローアップレビューで「開いたまま」とカウントされるかどうかとは別の話です。REVIEW.mdの調整項目はREVIEW.mdカスタマイズでClaude Codeの自動レビュー基準を変えるで扱っています。

つまり、新しいNitが増え続けるのを止めたいならREVIEW.md側の収束ルール、すでに出ている指摘を正しく片付けたことにしたいならGitHub上での解消操作、と対処する場所が分かれています。両方を混同すると、REVIEW.mdを調整したのに古い指摘だけがいつまでも一覧に残る、という状態になりかねません。

ローカルの/code-reviewやultrareviewとの使い分けなど、Code Review全体の実行経路はClaude Codeコードレビュー — 4つの実行経路の使い分けに整理しています。フォローアップレビューの「開いたまま」一覧が出るのは、GitHub App経由の管理Code Review機能に限った挙動です。ローカルの/code-reviewは毎回そのセッション内で完結するため、過去のレビューと指摘を突き合わせて開いたままの件数を表示する仕組みは持ちません。

まとめ

Code Reviewのフォローアップレビューは、前回までの指摘のうち解消されていないものを一覧に出し続けます。解消の条件は2つだけです。pushのたびにモードを購読していてコードを直してpushしたとき、またはGitHub上で「Resolve conversation」を押したときです。インラインコメントへの返信や👍👎リアクションは、どちらもスレッドの状態を変えません。v2.1.268はこの挙動自体を新しく作ったわけではなく、フォローアップレビューの一覧の下に注記を足して見えるようにしただけです。次のレビューでも同じ指摘が消えないときは、まずスレッドを解消したかどうかを確認します。コードを直したのに消えない場合は、pushへの購読設定が正しいかも合わせて見直します。