IT女子 アラ美海外×高単価エンジニア案件を匿名スカウト、無料登録3分
自分らしく働けるエンジニア転職を目指すなら【strategy career】
お疲れ様です！IT業界で働くアライグマです！
Claude Code を個人タスクで使えるようになったあと、いざ50万行を超える業務リポジトリに持ち込むと「コンテキストが入りきらない」「Subagent が暴走する」「Plan Mode を出してもレビュー往復が減らない」という壁にぶつかります。複数のSaaS開発チームで Claude Code を導入した事例を整理すると、最も効くのは Plan Mode・Subagent・Worktree を役割で使い分ける設計でした。本記事では、大規模リポジトリで Claude Code のレビュー負荷を分散させるための実務パターンを段階的に紹介します。
テーマの全体像と背景
IT女子 アラ美社内SE特化エージェント無料相談で年収診断もできる、求人数も豊富
社内SEを目指す方必見！IT・Webエンジニアの転職なら【社内SE転職ナビ】
Claude Code は単体ツールとしては Anthropic が公式提供している CLI エージェントですが、大規模コードベースで本当に価値を出すには「単発のコード生成器」ではなく「設計→実装→レビューを分散して回す運用基盤」として捉える必要があります。最近は Anthropic 公式ブログでも大規模コードベース向けのベストプラクティスが公開され、Plan Mode・Subagent・Worktree を組み合わせる方向が公式に推奨されています。
しかしツール紹介記事の多くは「単一エージェントでコードを書いてもらう」止まりで、実務で起きる以下の課題に踏み込んでいません。
- 1リポジトリの行数が大きく、コンテキストウィンドウに入りきらない
- Subagent が並列で動いた結果、責務が曖昧でレビュー観点がブレる
- Plan Mode を素朴に使うと「設計の妥当性レビュー」と「実装レビュー」が混ざる
トークン消費を抑えながら品質を維持する観点ではClaude Codeのトークン消費を月3000円に抑える実務テクニック7選でまとめた節約設計が前提知識になります。本記事ではその上で、レビュー負荷の分散にフォーカスして掘り下げます。
IT女子 アラ美
ITアライグマ前提条件と環境整理
本記事は、以下の条件を想定して書いています。バージョン依存の機能差を避けるため、Claude Code は 2026年5月時点のCLI最新版を前提にしています。
- Claude Code CLI（VS Code 拡張または ターミナル）が利用可能
- 対象リポジトリの規模が50万行〜200万行クラス（モノレポ含む）
- レビューフローに Pull Request 単位の人間レビュアーが少なくとも1人存在
- CLAUDE.md（リポジトリ直下）と .claude/agents（Subagent定義）を編集できる
開発環境の差で挙動が変わると検証ができないため、可能であれば DevContainer などで Claude Code 本体と依存ツールのバージョンを固定するのが安全です。具体的な構築方法はDevContainer設計実践：コーディングCLIとローカルLLMを統合する開発環境の作り方で紹介した手順をベースにしてください。
また、Worktree は git の標準機能（git worktree）であって Claude Code 専用ではありません。本記事の中では「同じリポジトリの別ブランチを別ディレクトリにチェックアウトし、Subagent ごとに作業領域を隔離する仕組み」として扱います。
IT女子 アラ美ITアライグマステップ1：基本的な実装・設定
最初に整えるのは「Plan Mode で設計を固め、Subagent に責務を切る」骨格です。Claude Code 単体でも Plan Mode は使えますが、大規模リポジトリでは Plan Mode の出力を Subagent に投げ直す二段構えが効きます。
- CLAUDE.md にレビュー観点（命名規約・テスト方針・禁止パターン）を明記する
- .claude/agents 配下に「Plan」「Explore」「Implement」「Review」の Subagent 定義を置く
- タスク開始時はまず Plan Mode で設計を出し、人間が承認したら Implement Subagent に渡す
- Implement の成果物に対して Review Subagent を別セッションで走らせる
ポイントは、Plan / Implement / Review を同じセッションで連続実行しないことです。同一セッションで全部やると Plan の前提が Implement にバイアスを残し、Review が「自分の設計を擁護する側」に立ってしまいます。Subagent をどの粒度で切るかはタスク種別ごとに変わるため、マルチエージェント基本設計8パターン：エンジニアリングマネージャーが押さえるAIチーム構築の実務判断ガイドのパターン集を参考に、自チームの開発フローに合わせて調整してください。
最小構成の Subagent 定義は次のように書きます。
---
name: Review
description: 実装差分のレビュー観点チェック専用。設計判断には踏み込まない。
tools: Read, Grep, Bash
---
差分を受け取り、CLAUDE.md のレビュー観点に従って指摘リストを返す。
独自に設計を書き換えてはならない。
ステップ2：発展的な活用・応用パターン
骨格ができたら、次は「Worktree で並行作業を捌く」段階に進みます。大規模リポジトリでは「機能A の Subagent」と「機能B のリファクタ Subagent」を同時に走らせたい場面が多く、main ブランチを共有していると変更が衝突します。
実務で安定するパターンは次の3つです。
- Worktree 1本＋Subagent 直列: 単一機能の改修。安全だが速度は出ない
- Worktree 複数＋Subagent 並列: 機能改修とリファクタの分離。Implement Subagent をそれぞれの worktree に閉じ込める
- Worktree 複数＋Review 統合: 並列で動いた差分を、Review Subagent だけは横串で走らせて衝突点を洗い出す
3つ目のパターンが大規模リポジトリで最も効きます。並列実装のあと「機能A の差分」「機能B の差分」「両方をマージした統合差分」の3視点で Review を回すと、人間レビュアーが本来見るべき設計判断に集中できます。
組織配布する場合は、CLAUDE.md と .claude/agents をリポジトリ管理にしてレビュー観点を全員に揃える必要があります。配布設計のリアルケースはメルカリ流Claude Codeセキュリティ設定の組織配布戦略：チーム導入で失敗しないガバナンス実務ガイドを参考にすると、ガバナンス側の落とし穴を避けられます。
IT女子 アラ美ITアライグマ実装後の効果検証（ケーススタディ）
IT女子 アラ美ここでは、ある中堅SaaS企業での導入事例を紹介します。なお社外向けに公開できる範囲で抽象化しています。
状況（Before）
- 佐藤さん（仮名・38歳・テックリード・経験13年）が率いる8人チーム
- 対象リポジトリは Rails + React のモノレポで約80万行
- PRレビュー往復が平均5回、設計の差し戻しでリードタイムが平均3日
- 「コードレビューだけで週の半分が溶ける。正直、設計の議論まで手が回らない」と本人の本音
行動（Action）
- CLAUDE.md にチームのレビュー観点（命名・テスト・禁止パターン）を集約し、毎週末に更新する運用に切替
- .claude/agents に Plan / Implement / Review の3種類を定義し、セッションを必ず分けるよう徹底
- 機能改修とリファクタは別 worktree で並行実装し、Review Subagent で横串チェックを実施
- Plan Mode の出力は人間レビュアーが承認するまで Implement に渡さないゲートを設置
結果（After）
- PRレビュー往復が平均5回 → 2回に短縮（60%削減）
- リードタイムが平均3日 → 1.2日に短縮（60%削減）
- テックリードのコードレビュー時間が週20時間 → 週8時間に縮小
- 削減できた時間を設計議論と若手メンタリングに再配分
振り返り・教訓
佐藤さんの本人コメント:「Subagent を増やすこと自体は目的じゃなかった。Plan / Implement / Review をセッション単位で完全に切ったのが正解でした。最初にCLAUDE.mdを整備せず Subagent だけ並べていた時期は、レビューが逆に増えて失敗していました」。
ツールを並べる前に「人間が見るべき差分はどこか」を定義するのが先で、それを翻訳した結果が Subagent と Worktree の運用設計になる、という順番が大事です。日次の運用ログを蓄積して翌週のCLAUDE.md更新に反映する仕組みはClaude Code × Obsidian連携で日次ノートから週次レビューまで自動化する実践ガイドのやり方を流用すると一気に楽になります。
IT女子 アラ美ITアライグマよくある質問
Q. Plan Mode と Subagent はどちらを先に導入すべきですか？
A. Plan Mode を先に導入してください。Plan Mode で設計の言語化を習慣化していないチームに Subagent を増やすと、責務が定義されないまま並列実行されて逆にレビュー負荷が増えます。設計の議論が安定してから Subagent に切り出すのが安全です。
Q. Worktree を使わずに Subagent だけで運用できますか？
A. 単一機能の改修なら可能です。ただし機能改修とリファクタを並行する規模になると、main ブランチで Subagent が並列に動いて衝突が起きやすくなります。並列度を上げるタイミングで Worktree も導入するのが現実的です。
Q. CLAUDE.md の更新頻度はどのくらいが適切ですか？
A. 週1回の振り返りでまとめて更新する運用が現実的です。日次で更新するとレビュー観点が頻繁に変わって Subagent の挙動が不安定になります。週次のレトロスペクティブと組み合わせて「今週増やすべき観点」「外すべき観点」を整理するサイクルが回しやすいです。
Q. Review Subagent を別セッションで走らせる理由は何ですか？
A. 同じセッションで Plan / Implement / Review を回すと、Review が自分の設計判断を擁護する側に立ってしまい独立性が失われるためです。差分とCLAUDE.mdだけを共有した別セッションでレビューを回すと、設計の前提に縛られない指摘が出やすくなります。
IT女子 アラ美ITアライグマさらなる実践・活用に向けて
Claude Code の Subagent 運用は、単発のテクニックではなく「自チームのレビュー観点をどう言語化するか」という設計の話です。本記事のパターンを叩き台にして、自社のリポジトリ・チーム規模・開発フローに合わせてカスタマイズしてください。
スキルが固まってくると、AI裁量導入を主導した経験そのものが市場価値になります。実際、Claude Code を含むAIコーディング基盤の導入経験を武器にハイクラス転職や年収交渉に活用するエンジニアが増えており、エージェント側もこのスキルを優先評価する動きが強まっています。年収重視で比較検討するならハイクラスエンジニア転職エージェント3社比較を、LLM実装経験を主軸に動くならLLM実装経験を武器にするエンジニア転職エージェント4社比較：年収アップに直結する選び方ガイドを参照すると、キャリアの選択肢を整理しやすくなります。
年収レンジで比較検討する際は、ハイクラス特化型のエージェントを横並びで比較すると判断が早くなります。
さらなる年収アップやキャリアアップを目指すなら、ハイクラス向けの求人に特化した以下のサービスがおすすめです。
| 比較項目 | TechGo | レバテックダイレクト | ビズリーチ |
|---|---|---|---|
| 年収レンジ | 800万〜1,500万円ハイクラス特化 | 600万〜1,000万円IT専門スカウト | 700万〜2,000万円全業界・管理職含む |
| 技術スタック | モダン環境中心 | Web系に強い | 企業によりバラバラ |
| リモート率 | フルリモート前提多数 | 条件検索可能 | 原則出社も多い |
| おすすめ度 | 技術で稼ぐならここ | A受身で探すなら | Bマネジメント層向け |
| 公式サイト | 無料登録する | - | - |
IT女子 アラ美ITアライグマまとめ
大規模コードベースで Claude Code を本番運用するなら、Plan Mode・Subagent・Worktree を「役割の分担」として設計するのが王道です。ツールを増やすことが目的にならないように、まずはCLAUDE.mdでレビュー観点を言語化することから始めてください。
- Plan / Implement / Review はセッションを必ず分け、独立性を保つ
- 並列実装は worktree で隔離し、Review Subagent だけ横串で走らせる
- CLAUDE.md は週次更新の運用に乗せ、レビュー観点をチーム全員に揃える
明日から試すなら、まずはCLAUDE.mdの整備と Plan / Review Subagent の分離だけでも効果が出ます。並列度を上げるのはチームが慣れてからで構いません。
IT女子 アラ美ITアライグマ
