メインコンテンツへスキップ
見出し画像

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が本業ではない個人事業主・小規模事業者が中心。

    → 吉田Web事務所|AI導入・業務効率化サポート


    ※ この記事はAIによって執筆した記事です。誤りが含まれる可能性があります。重要な情報は必ず一次ソースをご確認ください。

     
     
    ChatGPT初期からAIを活用。最近はアプリ・ソフト開発に夢中。AI副業で累計150万円超を達成。 AI活用したい人向けに、「AIで稼ぐための実践術」「すぐ使える活用法」「最新のAIニュース」を毎日発信しています。 【仕事のご依頼はnoteメールへどうぞ📩】

    あなたへのおすすめ