titc.ai › BLOG

Claude Code 解説 / 2026年11月時点

AIが書いたコードをどう見直すか:Claude Code チームの「コードレビュー」の考え方をやさしく整理

公開日 / 著者 富田 良治(TITC合同会社 代表社員)

AIが仕事を速くこなすほど、「できあがったものを誰がどう見直すか」が追いつかなくなります。Claude Code の開発チームが公開したコードレビューの考え方を、専門用語を減らして整理しました。

はじめに

この記事で分かることは、次の3つです。

紹介する元記事は、次のものです。ここでは翻訳ではなく、要点を日本語でまとめ直しています。細部や正確な表現は、元記事でご確認ください。

前提:人が全部を読むのをやめた

元記事によると、Claude Code のコードの約90%はClaude自身が書いています。そこでチームは「人が1行ずつ読む」ことを目指すのをやめ、「事故や取り消しを増やさない範囲で、人の見直し時間をできるだけ減らす」ことを目標にしました。読む作業の大半は機械が担当し、間違えても戻せる仕組みを整えた、という考え方です。

成果として、6月から9月にかけて、Claude Code のコードへ取り込まれた変更の数は2倍以上になり、取り消された変更の割合は40%以上減ったと書かれています。Anthropic社内の大きなコード置き場では、1日に取り込まれる変更が5月の約2,500件から9月には3万件超へ増えたそうです。

たとえるなら、生産量が増えても検査員を増やさず、検査機と手戻りの仕組みを整えて、人は危ない箇所だけ見るようにした工場です。

見直しには2つの仕事がある

元記事は、コードレビューを2つの仕事に分けています。

コードレビューの2つの仕事
仕事中身AI時代の変化
1. 問題を世に出る前に見つける不具合や危険な変更を、公開前に見つけて直す機械が常に見る。人が先に読む前に、Claudeが少なくとも1回は見直して直す
2. チームで理解を共有する誰が何を作ったか、コードがどうなっているかを皆が知る機械が読むぶん薄くなりやすい。別の工夫が要る(後述)

元記事は、「人が読んだか」ではなく「何が起こりうるか、どの確認で止めるか」が大切だとしています。見直しは、スペルチェックのように作業中ずっと動き続けるものになりました。

いちばん足りないのは人の時間

目標は、主要なコード置き場の変更の大半を、人が1人だけ関わる形で取り込み、取り消しや事故を増やさないことです。測るのは人の承認数と返事待ちの時間、歯止めは取り消しと事故の率です。

変更が世に出るまでの7つの関門

元記事は、変更が通る道のりを「提出する前」「提出するたび」「取り込むとき」「取り込んだ後」の4つの時点に分けています。機械で済むところは機械に任せ、人の注意は危ない箇所に向ける設計です。

1. 出す前に、自分で確かめさせる

AIには、テストの実行や画面の比較のように「実際に動かせるもの」を渡し、「できました」と言わせるのではなく、出力を見せさせます。さらに別のAIが、前提を知らない状態で差分を見直します。Claude Code の作者であるBoris Cherny氏は、こうした確認で成果が2〜3倍よくなると見積もっているそうです。

同じ指摘が何度も出るときは、その場で直すのではなく、元になる場所を直します。置き場は次のとおりです。

2. 提出のたびに、AIが見直す

Claudeは、差分だけでなく、コード全体と「何のための変更か」を踏まえて見直し、問題の根本原因に届いているかも見ます。製品としては Code Review for Claude Code(TeamとEnterpriseプランで一般提供)があり、手元で軽く動かす /code-review もあります。

3. 止められるセキュリティの見直し

別に、自動のセキュリティ見直しも動きます。不具合やセキュリティの指摘が1つでも未解決なら、変更は取り込まれません。解決の方法は、直すか、理由を書いて閉じるか(誤検知の処理)です。手元では /security-review が使えます。

4. 止められる自動チェック

書き方の検査、型の検査、全環境でのテスト、ビルドなどです。数十個のチェックが走ることもあります。変更の説明欄には、「どう確かめたか」と「どう元に戻すか」を書く欄があります。下書きはClaudeに任せてよいものの、依頼した人が責任をもって承認します。

5. 人の承認は、リスクに応じて変える

リスクの段階と、必要な人の承認
リスク例人の承認
低文書、文言、社内向けの機能、旗の裏にある追加だけの変更不要(自動チェックとセキュリティが緑になれば)
中ふつうの製品の変更。保存の仕組み、自動更新、AIへの指示文などの敏感な部分1人
高最も危険なコード、常に2人が必要とされる場所2人

6. 順番待ちの列、旗、少しずつの公開

順番待ちの列(マージキュー)では、変更を取り込んだ状態で、最新の本体に対してチェックをやり直します。それぞれ単独では通った変更が、組み合わさって壊す事故を防ぐためです。新しい動きは、機能のオン・オフの旗(フィーチャーフラグ)の裏に入れ、まず社員が使います。社内で使ううちに、利用者より先に不具合が見つかることが多いそうです。公開は先行版(latest)から始め、安定版(stable)があとを追います。

7. すぐ見つけて、すぐ戻す

旗は、再公開なしでオフにできます。週ごとの当番がいて、事故の振り返りでは「どの関門が止めるべきだったか」を問います。まだ無いものとして、取り消しや事故が増えたときに承認を自動で厳しくする仕組みが挙げられています。チームの姿勢は、遅くするより「気づいて直すのを速くしたい」というものです。

見直し役のAIを育てる

見直し役の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社内の変更についてのものです。社外の組織でも同じ結果になるとは限りません。

中小企業・小さなチームで真似するなら(筆者の考察)

ここからは元記事の内容ではなく、筆者(富田)の考察です。元記事に書かれていない事実は足していません。

  1. AIの成果物は、出す前に「別の目」を通す。見積書や案内文なら、書いたAIとは別のAIに、前提を伝えずに読ませるだけでも、元記事の「まっさらな頭で見直す」に近づきます。
  2. 確認の重さは、失敗したときの痛さで決める。社内メモは確認なし、お客様への送付物は1人、請求や契約は2人のように、中身で分けます。
  3. AIの「OK」を、人の承認と数えない。AIの見直しは下調べとして使い、最後に「これで出します」と言うのは、必ず人にします。
  4. 同じ指摘は、一覧に書き足す。繰り返し出る注意は、AIへの指示書(CLAUDE.md のようなもの)に1行足します。直す場所を、その場の修正から元の決まりへ移す考え方です。
  5. 元に戻す方法を、出す前に書いておく。「どう確かめたか」「どう戻すか」を一言ずつ書く習慣は、すぐに始められます。

出典

ご相談

AIが作った成果物の見直し方を、自社の業務に合わせて組み立てたい、費用を抑えて自走化したい——そうした相談は、無料AI自走化診断またはお問い合わせからどうぞ。

無料AI自走化診断 お問い合わせ

← ブログ一覧へ戻る

富田 良治

富田 良治(とみた よしはる)

TITC合同会社 代表社員

AI経営コンサルタント。中小企業診断士・ITストラテジスト。元ITエンジニアで駄菓子屋オーナー。 プロフィールを見る