
Claude Code開発チームのレビュー術が話題|コードの9割をAIが書き、取り消し率は4割減
Claude Code(クロードコード)の開発チームが、自分たちのコードレビューのやり方を公式ブログで公開した。2026年10月15日の記事で、海外の開発者掲示板Hacker News(ハッカーニュース)では483ポイントを集めた。
Claude Codeのコードは、約90%をClaude自身が書いている。6月から9月にかけて取り込んだ変更は2倍を超え、あとから取り消した変更の割合は4割以上減ったという。
レビュー役のAIに渡す指示書「REVIEW.md」の5項目と、作業の最後に別のAIへ確認させるプロンプトは下に書いた。
Claude Codeチームが公開したレビューの数字
記事の筆者は、Addy Osmani(アディ・オスマニ)氏ら3人。Claude.devの公式ブログによれば、目標は「取り消しや障害を増やさない範囲で、人がレビューに使う時間を最小にする」。
Anthropic(アンソロピック)社内のコード置き場では、1日に取り込まれる変更が5月の約2,500件から、9月には3万件超に増えた。
チームはレビューの大半を自動チェックとAIに任せ、人は危険な変更と設計の判断に集中する形へ変えた。記事が示す変化は次のとおり。
中身のある指摘がついた変更は、16%から54%へ(レビュー用ツールの導入時)
1回の指摘と修正で通った変更は、65%から78%へ
5回以上やり直した変更は、8.9%から1.5%へ
AIのレビューで中身のある指摘がついた変更は、16%から54%に増えた。
提出前の検証|テスト・ビルド・別のAIの確認
チームが最初に置くのは、変更を提出する前の検証。Claudeに実行できるもの(テスト、ビルド、デザインと見比べるスクリーンショット)を渡し、「終わった」と言わせる代わりに実行結果を見せさせる。
続いて、サブエージェント(作業を分担する別のAI)に、まっさらな文脈で差分だけを読ませる。書いた本人とは別の目で確かめるための工程になる。
記事によれば、Claude CodeチームのBoris Cherny(ボリス・チャーニー)氏は、この検証で最終的な結果が2〜3倍良くなると見積もっている。
Claudeに「終わった」と報告させず、テストやビルドの実行結果を見せさせる。
レビューのやり直しにも上限がある。3回やり直しても通らない変更では、レビュー役のAIが書き手に作り方そのものの見直しを求める。
CLAUDE.mdとREVIEW.mdに書く内容
チームはリポジトリ(コード一式の置き場)に、2つの指示ファイルを置いている。
CLAUDE.md
プロジェクトの説明書にあたるファイル。使っている技術、書き方の決まり、目標と「やらないこと」を書く。レビューのたびに読み込まれるため、大きなコードでは短く保ち、詳しい資料へのリンクをここから張る。
REVIEW.md
コードの担当者が書く、レビュー役のAIへの指示書。記事が挙げる中身は次の5つ。
そのリポジトリでの「失敗」とは何かを書く(文書なら事実と違う内容、設定なら処理の行き先の誤り)
細かい指摘の数に上限を設ける
見なくてよいパスを並べる
推測ではなく、ファイル名と行番号を根拠として求める
要約は件数から書き始め、直す点が無いときははっきりそう書かせる
良いREVIEW.mdは短い、とチームは書いている。
コピペで使えるプロンプト
記事に書かれた手順を、そのまま指示文の形にしたもの。(例)の部分は、自分のリポジトリに合わせて書き換えて使う。
1つ目はREVIEW.mdのひな形。そのままREVIEW.mdという名前のファイルに貼り付ける。
【このリポジトリでの「失敗」】
- (例)ドキュメント:事実と違う内容を書く
- (例)設定ファイル:処理の行き先を間違える
【指摘のルール】
- 細かい指摘(表記・好み)は(例)3件までにする
- 根拠は推測でなく「ファイル名:行番号」で示す
- 要約は指摘の件数から書き始める。直す点が無ければ「指摘なし」と書く
【見なくてよいパス】
- (例)dist/
- (例)自動生成されたファイル2つ目は、Claude Codeへの作業依頼の最後に足す指示。
作業が終わったら、テストとビルドを実行し、その出力をそのまま見せて。
「完了した」とだけ報告しないこと。
そのあと、サブエージェントを1つ立てて、今回の差分だけを新しい文脈でレビューさせて。
指摘はファイル名と行番号つきで、件数から書き始めて。ひな形の項目は、REVIEW.mdについて記事が挙げた5つをそのまま並べたもの。
まとめ|/code-reviewと人が見る範囲
チームのレビュー機能は「Code Review for Claude Code」として、TeamプランとEnterpriseプランで一般提供されている。
手元では「/code-review」コマンドで軽量版を動かせる。セキュリティの確認には「/security-review」コマンドか、オープンソースのGitHub Action(ギットハブ アクション)を使う。
人の判断に残るのは、それを作るべきかどうか、課金や自動更新などの危険なコード、設計の選択、そして結果への責任。
今日試せること:Claude Codeで作業しているリポジトリに、上のひな形でREVIEW.mdを作り、「/code-review」を1回実行する。
手元で動く「/code-review」は、チームが使うレビュー機能の軽量版。
▼ 毎朝、AIの最新ニュースが1分で読める
Substack「えーAI」では、最新AIニュースと活用術を毎朝 無料配信している。
その日いちばん効くニュースだけを選び、1分で読める形にして届ける。
▼ あわせて読みたい
Claude Codeの自動承認で、AIが危険な操作をどれだけ見抜いたかはこちら。
AIニュースは毎日更新。取りこぼしたくない方はフォローを。
▼「うちの仕事でも使えるのか」を整理する
記事で扱ったAIを自分の業務にどう組み込むか、無料相談で一緒に整理する。ITが本業ではない個人事業主・小規模事業者が中心。
※ この記事はAIによって執筆した記事です。誤りが含まれる可能性があります。重要な情報は必ず一次ソースをご確認ください。