IT女子 アラ美海外×高単価エンジニア案件を匿名スカウト、無料登録3分
自分らしく働けるエンジニア転職を目指すなら【strategy career】
お疲れ様です!IT業界で働くアライグマです!
Claude Code を個人タスクで使えるようになったあと、いざ50万行を超える業務リポジトリに持ち込むと「コンテキストが入りきらない」「Subagent が暴走する」「Plan Mode を出してもレビュー往復が減らない」という壁にぶつかります。こうした壁に対して効くのが、Plan Mode・Subagent・Worktree を役割で使い分ける設計です。本記事では、大規模リポジトリで Claude Code のレビュー負荷を分散させるための実務パターンを段階的に紹介します。
Claude Codeの大規模コードベース運用で直面する3つの課題
IT女子 アラ美社内SE特化エージェント無料相談で年収診断もできる、求人数も豊富
社内SEを目指す方必見!IT・Webエンジニアの転職なら【社内SE転職ナビ】
Claude Code は単体ツールとしては Anthropic が公式提供している CLI エージェントですが、大規模コードベースで本当に価値を出すには「単発のコード生成器」ではなく「設計→実装→レビューを分散して回す運用基盤」として捉える必要があります。最近は Anthropic 公式ブログでも大規模コードベース向けのベストプラクティスが公開され、Plan Mode・Subagent・Worktree を組み合わせる方向が公式に推奨されています。
しかしツール紹介記事の多くは「単一エージェントでコードを書いてもらう」止まりで、実務で起きる以下の課題に踏み込んでいません。
- 1リポジトリの行数が大きく、コンテキストウィンドウに入りきらない
- Subagent が並列で動いた結果、責務が曖昧でレビュー観点がブレる
- Plan Mode を素朴に使うと「設計の妥当性レビュー」と「実装レビュー」が混ざる
トークン消費を抑えながら品質を維持する観点ではClaude Codeのトークン消費を月3000円に抑える実務テクニック7選でまとめた節約設計が前提知識になります。本記事ではその上で、レビュー負荷の分散にフォーカスして掘り下げます。
IT女子 アラ美Claude CodeとWorktreeを導入するための前提環境
本記事は、以下の条件を想定して書いています。バージョン依存の機能差を避けるため、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女子 アラ美Plan Modeでの設計言語化とSubagent責務分割の基本構成
最初に整えるのは「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 をどの粒度で切るかはタスク種別ごとに変わるため、自チームの開発フローに合わせて調整してください。
最小構成の Subagent 定義は次のように書きます。
---
name: Review
description: 実装差分のレビュー観点チェック専用。設計判断には踏み込まない。
tools: Read, Grep, Bash
---
差分を受け取り、CLAUDE.md のレビュー観点に従って指摘リストを返す。
独自に設計を書き換えてはならない。
IT女子 アラ美Git WorktreeによるSubagent並行実行と差分衝突の防止
骨格ができたら、次は「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女子 アラ美大規模リポジトリでSubagentを入れる進め方の例
IT女子 アラ美Rails + React のような大きなモノレポを、数人のチームでClaude Codeを使って開発している場面を例に、入れる順番を整理します。
よくある状態
- PRのレビューの往復が多く、設計の差し戻しでリードタイムが延びる
- テックリードの時間がコードレビューに取られ、設計の議論まで手が回らない
進める順番
- CLAUDE.md にチームのレビュー観点(命名・テスト・禁止パターン)を集約し、毎週末に更新する運用に切替
- .claude/agents に Plan / Implement / Review の3種類を定義し、セッションを必ず分けるよう徹底
- 機能改修とリファクタは別 worktree で並行実装し、Review Subagent で横串チェックを実施
- Plan Mode の出力は人間レビュアーが承認するまで Implement に渡さないゲートを設置
効果を確かめる
入れる前と後で、PRのレビューの往復回数、リードタイム、テックリードがレビューに使った時間を記録して比べます。浮いた時間を設計の議論や若手のメンタリングに回せているかも確かめてください。
つまずきやすい点
Subagentを増やすこと自体は目的ではありません。Plan / Implement / Review をセッション単位で分けることが大切です。CLAUDE.mdを整えないままSubagentだけを並べると、出力がそろわず、かえってレビューが増えることがあります。
ツールを並べる前に「人間が見るべき差分はどこか」を定義するのが先で、それを翻訳した結果が Subagent と Worktree の運用設計になる、という順番が大事です。日次の運用ログを蓄積して翌週のCLAUDE.md更新に反映する仕組みはClaude Code × Obsidian連携で日次ノートから週次レビューまで自動化する実践ガイドのやり方を流用すると一気に楽になります。
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女子 アラ美CLAUDE.mdの段階的カスタマイズとチーム展開の進め方
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女子 アラ美まとめ
大規模コードベースで Claude Code を本番運用するなら、Plan Mode・Subagent・Worktree を「役割の分担」として設計するのが王道です。ツールを増やすことが目的にならないように、まずはCLAUDE.mdでレビュー観点を言語化することから始めてください。
- Plan / Implement / Review はセッションを必ず分け、独立性を保つ
- 並列実装は worktree で隔離し、Review Subagent だけ横串で走らせる
- CLAUDE.md は週次更新の運用に乗せ、レビュー観点をチーム全員に揃える
明日から試すなら、まずはCLAUDE.mdの整備と Plan / Review Subagent の分離だけでも効果が出ます。並列度を上げるのはチームが慣れてからで構いません。
IT女子 アラ美