Claude Code マルチエージェント安全運用

複数のAIエージェントを同時稼働させるとき、何が壊れるか。800時間の経験から。

なぜマルチエージェントが必要か

Claude Codeは1つのセッションで1つのタスクしか扱えない。コードを書きながらテストを走らせ、ドキュメントも更新する——これを1セッションでやるとコンテキストが膨らみ、トークン効率が悪化する。

解決策は役割分離。実装エージェント、レビューエージェント、テストエージェントに分けて、それぞれが専門の仕事に集中する。

全体方針の決定、優先順位付け、品質判断

コード実装、テスト実行、ドキュメント更新。tmuxで同時稼働

全エージェントに共通の安全制約。rm -rf防止、秘密漏洩防止、トークン制限

マルチエージェントは事故リスクが単体の2〜3倍になる。各エージェントが独立して動くため、一方のエージェントが変更したファイルを別のエージェントが上書きするケースが発生する。

最低限必要な安全設定:

npx cc-safe-setup --shield

このコマンドで8個の基本hookが一括インストールされる。マルチエージェント環境では全てのエージェントが同じhookを共有する（~/.claude/settings.jsonは共通）。

tmuxの各ペインでClaude Codeを起動。左ペインで実装、右ペインでテスト。send-keysでタスクを投入。

特定のディレクトリにファイルが追加されたら自動でClaude Codeにタスクを投入。inotifywaitで監視。

Claude Code内蔵のAgent toolで並列実行。メインセッションのコンテキストを汚さずに調査・分析を実行。

マルチエージェント協調はまだ発展途上。以下の問題が日常的に発生する:

マルチエージェントの前に、まず単体の安全設定を固めよう。