Claude Code 解説 / 2026年11月時点
AIが仕事を速くこなすほど、「できあがったものを誰がどう見直すか」が追いつかなくなります。Claude Code の開発チームが公開したコードレビューの考え方を、専門用語を減らして整理しました。
この記事で分かることは、次の3つです。
紹介する元記事は、次のものです。ここでは翻訳ではなく、要点を日本語でまとめ直しています。細部や正確な表現は、元記事でご確認ください。
元記事によると、Claude Code のコードの約90%はClaude自身が書いています。そこでチームは「人が1行ずつ読む」ことを目指すのをやめ、「事故や取り消しを増やさない範囲で、人の見直し時間をできるだけ減らす」ことを目標にしました。読む作業の大半は機械が担当し、間違えても戻せる仕組みを整えた、という考え方です。
成果として、6月から9月にかけて、Claude Code のコードへ取り込まれた変更の数は2倍以上になり、取り消された変更の割合は40%以上減ったと書かれています。Anthropic社内の大きなコード置き場では、1日に取り込まれる変更が5月の約2,500件から9月には3万件超へ増えたそうです。
たとえるなら、生産量が増えても検査員を増やさず、検査機と手戻りの仕組みを整えて、人は危ない箇所だけ見るようにした工場です。
元記事は、コードレビューを2つの仕事に分けています。
| 仕事 | 中身 | AI時代の変化 |
|---|---|---|
| 1. 問題を世に出る前に見つける | 不具合や危険な変更を、公開前に見つけて直す | 機械が常に見る。人が先に読む前に、Claudeが少なくとも1回は見直して直す |
| 2. チームで理解を共有する | 誰が何を作ったか、コードがどうなっているかを皆が知る | 機械が読むぶん薄くなりやすい。別の工夫が要る(後述) |
元記事は、「人が読んだか」ではなく「何が起こりうるか、どの確認で止めるか」が大切だとしています。見直しは、スペルチェックのように作業中ずっと動き続けるものになりました。
目標は、主要なコード置き場の変更の大半を、人が1人だけ関わる形で取り込み、取り消しや事故を増やさないことです。測るのは人の承認数と返事待ちの時間、歯止めは取り消しと事故の率です。
元記事は、変更が通る道のりを「提出する前」「提出するたび」「取り込むとき」「取り込んだ後」の4つの時点に分けています。機械で済むところは機械に任せ、人の注意は危ない箇所に向ける設計です。
AIには、テストの実行や画面の比較のように「実際に動かせるもの」を渡し、「できました」と言わせるのではなく、出力を見せさせます。さらに別のAIが、前提を知らない状態で差分を見直します。Claude Code の作者であるBoris Cherny氏は、こうした確認で成果が2〜3倍よくなると見積もっているそうです。
同じ指摘が何度も出るときは、その場で直すのではなく、元になる場所を直します。置き場は次のとおりです。
CLAUDE.md:プロジェクトの技術構成、決まりごと、目標と「やらないこと」を短く書くファイル。見直しのたびに読み込まれます。REVIEW.md:コードの持ち主が、見直し役に向けて書くファイル。「このリポジトリでの失敗とは何か」を書き、細かい指摘の数を制限し、見なくてよい場所を示し、根拠としてファイルと行を求め、結論は件数から始めて「直す点なし」ならはっきりそう書かせる、といった内容が効果的だと紹介されています。Claudeは、差分だけでなく、コード全体と「何のための変更か」を踏まえて見直し、問題の根本原因に届いているかも見ます。製品としては Code Review for Claude Code(TeamとEnterpriseプランで一般提供)があり、手元で軽く動かす /code-review もあります。
別に、自動のセキュリティ見直しも動きます。不具合やセキュリティの指摘が1つでも未解決なら、変更は取り込まれません。解決の方法は、直すか、理由を書いて閉じるか(誤検知の処理)です。手元では /security-review が使えます。
書き方の検査、型の検査、全環境でのテスト、ビルドなどです。数十個のチェックが走ることもあります。変更の説明欄には、「どう確かめたか」と「どう元に戻すか」を書く欄があります。下書きはClaudeに任せてよいものの、依頼した人が責任をもって承認します。
| リスク | 例 | 人の承認 |
|---|---|---|
| 低 | 文書、文言、社内向けの機能、旗の裏にある追加だけの変更 | 不要(自動チェックとセキュリティが緑になれば) |
| 中 | ふつうの製品の変更。保存の仕組み、自動更新、AIへの指示文などの敏感な部分 | 1人 |
| 高 | 最も危険なコード、常に2人が必要とされる場所 | 2人 |
順番待ちの列(マージキュー)では、変更を取り込んだ状態で、最新の本体に対してチェックをやり直します。それぞれ単独では通った変更が、組み合わさって壊す事故を防ぐためです。新しい動きは、機能のオン・オフの旗(フィーチャーフラグ)の裏に入れ、まず社員が使います。社内で使ううちに、利用者より先に不具合が見つかることが多いそうです。公開は先行版(latest)から始め、安定版(stable)があとを追います。
旗は、再公開なしでオフにできます。週ごとの当番がいて、事故の振り返りでは「どの関門が止めるべきだったか」を問います。まだ無いものとして、取り消しや事故が増えたときに承認を自動で厳しくする仕組みが挙げられています。チームの姿勢は、遅くするより「気づいて直すのを速くしたい」というものです。
見直し役のAIは、作って終わりではなく、測って育てています。
作者がAIだと、細かい指摘1つごとに修正と見直しの往復が起きます。ある変更では、一晩で50回を超える往復が起きました。調べると、指摘箇所の約59%は最初からあったもので、毎回、古い不具合が少しずつ見つかっていただけでした。
そこで、3回たったら見直し役が作者に「やり方を考え直しませんか」と促し、数回後は新しい差分だけを見直し、同じ種類の不具合はまとめて直させ、出した指摘は繰り返さないようにしました。
| 指標 | 前 | 後 |
|---|---|---|
| 見直しと修正1回で合格する割合 | 65% | 78% |
| 5回以上かかる割合 | 8.9% | 1.5% |
| 合格までの見直し回数の平均 | 2.08回 | 1.32回 |
2つ目の仕事(理解の共有)には、特別な手続きはありません。全体を頭に入れている人もいません。必要になったら、その部分の解説をClaudeに頼みます。数分でできて、いまのコードに合った内容になります。
チームには「出した人が持ち主」という決まりがあります。小〜中程度の変更で問題が起きたら、出した人が直すのが基本です。これが成り立つのは、変更が小さく、元に戻せるからです。責める文化ではなく、事故の振り返りは仕組みを見ます。
元記事は、提出前の確認(短い CLAUDE.md と /code-review)、提出ごとの見直しと必須チェック、リスクに応じた承認、取り込み後の旗と少しずつの公開、の順に足していくことを勧めています。AIの見直し役は、まず1つのコード置き場で数週間調整してから広げます。承認の基準は、最初は厳しく、証拠が出たら緩めます。
元記事の結論は、次の3点に整理できます。
なお、ここで紹介した数字は、すべてAnthropic社内の変更についてのものです。社外の組織でも同じ結果になるとは限りません。
ここからは元記事の内容ではなく、筆者(富田)の考察です。元記事に書かれていない事実は足していません。
CLAUDE.md のようなもの)に1行足します。直す場所を、その場の修正から元の決まりへ移す考え方です。