Claude Codeを唯一の開発者として本番SaaSアプリケーションを構築してきた開発者が、緊急バグ対応のためにClaude Codeを3つ同時に起動した実体験を共有しています。100以上の機能と20以上のリリースを1エージェントで成功させてきた彼が、複数エージェント並列運用で直面した「カオス」と、その解決策として構築したシステムについて詳しく語っています。
この記事のポイント
- Claude Code 3エージェント並列運用で発生する4つの深刻な問題を実体験ベースで報告
- 人間がメッセージルーターになる「人的ボトルネック」の実態
- エージェント間の共有メモリ不在・指示の上書き・スコープクリープの連鎖問題
並列運用に至った背景
筆者は6ヶ月間、Claude Codeを唯一の開発者として本番SaaSアプリケーションを構築してきました。1つのエージェント、1つのターミナル、1人の人間がレビューするというシンプルな体制で、100以上の機能と20以上のリリースを実現しています。
しかし、ベータユーザーが求人検索で結果がゼロになるバグを報告したことで状況が一変しました。バグの原因は9つのAPIアダプター、スコアリングパイプライン、オンボーディングウィザード、検索クライアントのどこかに潜んでおり、1つのエージェントで1つずつ調査する方法では間に合わない状況でした。そこで筆者は3つのターミナルを開き、同じリポジトリに対して3つのClaude Codeセッションを同時に起動するという決断をしました。
発生した4つの問題
問題1：人間がメッセージルーターと化す。 エージェント1が発見した情報をエージェント3が必要としても、エージェント同士は直接通信できません。筆者はターミナル間で発見内容をコピー&ペーストしながら、同時にプロダクトの意思決定も行わなければなりませんでした。コードレビューではなく、コミュニケーションそのものが人的ボトルネックになるという予想外の事態です。
問題2：指示の上書き。 共有JSONファイルでエージェントへの指示を管理していましたが、エージェント2にタスクを送ると、エージェント1の保留中の指示が上書きされてしまいました。指示の消失、作業の重複、古い情報に基づいたエージェントの動作という三重の問題が発生しました。
問題3：共有メモリの不在。 各エージェントはゼロからスタートするため、他のエージェントの発見内容を知ることができません。エージェント3がプロダクトに関する仮定を立てましたが、その仮定はエージェント1がすでに否定済みのものでした。エージェント3はその発見を見ていなかったのです。
問題4：スコープクリープの連鎖。 1つのエージェントが仕様から少しずれるのは管理可能です。しかし3つのエージェントがそれぞれ異なる方向に少しずつずれると、プロダクトマネジメントの悪夢になります。ずれが互いに影響し合い、制御不能な状態に陥る危険性があります。
具体的なバグの内容
実際に発見されたバグは、すべての検索クエリに「 remote」という文字列を付加する1行のコードでした。これにより9つのAPIアダプターのうち3つが機能しなくなり、検索結果がゼロになっていたのです。エージェント1がこの根本原因を特定し、エージェント2は監査証跡を構築し、エージェント3は空の検索結果時のUXを修正するという役割分担でしたが、全員が同時にコミットを出し、互いの変更を踏み合う結果となりました。
並列エージェント運用から得られた教訓
この経験は、現在のAIコーディングツールにおける根本的な課題を浮き彫りにしています。単一エージェントでの開発は非常にうまく機能しますが、複数エージェントを並列に動かす際には、エージェント間の通信プロトコル、共有状態の管理、指示の排他制御、スコープの厳密な定義といった、従来のチーム開発で必要とされるのと同種のインフラが必要になります。
人間の役割は「コードレビュアー」から「オーケストレーター（指揮者）」へと変化し、その負担は単一エージェント運用時よりもむしろ増大します。これは、AIエージェントが「もう1人の開発者」というよりも「非常に優秀だが文脈を共有できないフリーランサー集団」に近い存在であることを示唆しています。
知っておくと便利なTips
- 複数エージェント運用時は、各エージェントに明確なスコープとファイル領域を割り当て、変更範囲が重複しないようにする
- 共有指示ファイルはエージェントごとに分離し、上書き事故を防止する
- エージェント間で共有すべき発見事項は、専用のメモファイルに追記方式で記録する
- 1エージェントでの運用が十分に機能している場合、安易に並列化せず、タスクの緊急度と複雑度を見極める
まとめ
Claude Codeは単一エージェントとして驚異的な生産性を発揮しますが、複数エージェントの並列運用には現時点で大きな課題があります。エージェント間通信の不在、共有メモリの欠如、指示管理の脆弱性、スコープクリープの連鎖という4つの問題は、いずれもツール側の進化が待たれる領域です。しかし同時に、これらの問題を認識した上で運用の仕組みを工夫すれば、緊急時の並列デバッグなど特定の場面では大きな力を発揮する可能性も示されています。今後のClaude Codeのマルチエージェント対応に期待が高まる、実践的な報告です。
📎 元記事: https://www.reddit.com/r/ClaudeAI/comments/1r4tuu9/i_ran_3_claude_code_agents_in_parallel_against_a/
コメント