目次
Claude Codeチームは、レビューを「人が全行を読む工程」から、リスクに応じて自動チェックと人の判断を組み合わせる仕組みに変えています。狙いはレビュー時間を減らしながら、リバートやインシデントを増やさないことです。
要点#
- 変更の多くは、PRを開く前からClaudeと自動チェックで検証する。
- 人の承認数は変更のリスクで決め、低リスクなら自動チェックだけで通す場合もある。
- AIレビューの指摘は別のエージェント群で確かめ、著者は各指摘に対応する。
- レビューは3ラウンドで区切り、それ以降は新しい差分を中心に見る。
- リバート率やインシデント率を、人のレビュー時間を減らせているかの歯止めにする。
人の時間を基準にする#
Anthropicのモノレポでは、1日に取り込む変更が2026年5月の約2,500件から、9月には3万件超に増えました。Claude Codeのリポジトリは別ですが、そこでも変更量が増え、すべてを人が行単位で読むやり方は難しくなっています。
チームが追うのは「人がコードを読んだか」ではなく、「この変更で何が起こりうるか、どのチェックがそれを見つけるか」です。人の時間はレビューにかかる分だけではありません。悪い変更の修正に時間を取られれば、レビューを短くした意味が薄れます。
そこで、PRあたりの人間の承認数やコメント数、誰かの対応を待つ時間を測定し、リバートとインシデントの増加を避ける条件にしています。2026年6月から9月にかけて、Claude Codeのマージ済みPRは倍以上になり、リバートされた割合は40%超下がったと記事は報告しています。
PRの前後にチェックを置く#
最初の確認はPRを開く前です。テストやビルド、画面の比較など、Claudeが実行して結果を見せられる手段を用意します。さらに、新しい文脈で差分を見るサブエージェントを使い、バグ探しや単純化、動作確認を行うチームメンバーもいます。
PRごとにClaudeのレビューとセキュリティレビューが走り、指摘は別のエージェント群が検証します。スタイル上の好みや根拠の薄い指摘を減らし、残った指摘は重要度を付けて投稿。著者は修正するか、理由を添えてスレッドを解決します。未解決の指摘がある間はマージできません。
その後、リンター、型チェック、各プラットフォームのテスト、ビルドが実行されます。マージキューでは変更をmainに適用した状態でチェックをやり直します。個別には通った二つのPRが、組み合わさると壊れるケースを防ぐためです。
リスクで承認数を変える#
変更内容からリスクを判定し、人の確認数を決めます。記事で示された基準は、低リスクが承認不要、中リスクが1人、高リスクが2人です。文言の修正やフラグ付きの追加機能は低リスクの例、通常の機能変更やキャッシュ、更新機構などは中リスクの例です。リスクの高いコードや、常に二人の確認を要する指定箇所は高リスクに当たります。
承認を軽くできるのは、リポジトリの信頼済みメンバーが作業した場合に限られます。CI設定などの指定パスには人の確認を必須にし、エージェントの承認を人の承認の代わりにはしません。新しいコミットが入れば、承認を取り直します。エージェントに作業を頼んだ人も、変更に対する責任を負います。
マージ後は、フラグや段階的なリリースで影響を抑えます。Claude Codeでは社内利用を先行させ、公開版では最新チャンネルが安定版より先に配信されます。問題が起きればフラグを切る、またはリバートする。自動チェックを増やしても、すべてのミスを事前に防げるわけではありません。
レビューを長引かせない#
AIが書いたコードをAIが何度もレビューすると、修正と再確認が止まらなくなることがあります。記事では、あるCLIのPRが一晩で50回を超えるレビューと修正を繰り返した例が紹介されています。毎回新しいバグが見つかるとは限らず、以前からあるコードを順に指摘していただけのケースもありました。
チームは通常の再レビューを3ラウンドで区切り、それを超えたら実装方針から見直します。初期の確認を終えた後は新しい差分に絞り、同じ種類の問題を一か所ずつ直すのではなく、同類の箇所をまとめて直すよう促します。以前投稿した指摘の繰り返しも避けます。
指摘の多さだけを成果にすると、誤検知まで増えます。人が指摘にどう対応したかを集計し、問題のないPRに不要な修正を促していないかも確認します。過去のインシデントやリバートを再現用の評価セットに加え、レビューの変更後も毎日チェックします。
人が判断する仕事#
人には、何を作るか、設計をどうするか、リスクの高い変更を出してよいかを判断する役割が残ります。請求、更新機構、CI設定などは人が確認し、他の変更にも使われる設計パターンは経験のある人が見ます。
確認では、テスト結果や実行したコマンド、その出力、画面の証拠を読みます。どのチェックでも拾えない問題が分からないなら、簡単な承認で済ませず、詳しいレビューを依頼する。小さな変更を出した人は、問題が起きたときに直す責任も持ちます。
レビュー負荷を下げるには、変更を小さく保ち、失敗したら戻せる仕組みを整えることも必要です。チームはインシデントを個人の責任追及に結びつけず、どのチェックや手順が問題を見逃したかを調べます。人の確認を減らせるかは、こうした運用を含めて判断します。
次の一歩#
まず一つのリポジトリを選び、テスト・リスク・戻し方をPRテンプレートに加えてください。次に、変更を低・中・高リスクに分け、各段階で必要な人の承認数を決めます。人のレビュー時間とリバートやインシデントの両方を記録し、数週間後に基準を見直しましょう。
出典: https://claude.dev/blog/solving-code-review-at-anthropic/
目次
