【実測】独立セッションを深さ3で再帰させたら|subagent にある上限を wrapper で足して分かった「守れること・守れないこと」

【実測】独立セッションを深さ3で再帰させたら|subagent にある上限を wrapper で足して分かった「守れること・守れないこと」 AIエージェント

「調べものをエージェントに頼んだら、途中で見つけた疑問を別のエージェントに任せて、そのエージェントもまた別のエージェントに任せて……と勝手に広がっていけば、人が指示を出し直さなくても深い調査ができそう。でも、際限なく増えたら怖い」。複数のエージェントを使い始めると、こんな発想と不安が同時に出てきます。

親が子に任せ、子が孫に任せ、どの階層も同じ手順(受け取る → 分ける → 任せる → 確かめる → まとめて報告する)で動く形を、本記事では「フラクタル型エージェント」と呼びます。Claude Code には、この形を作れる道具が 2 つあります。一つはセッションの中で別のエージェントを呼ぶ subagent(Agent ツール)、もう一つは claude --bg で起動する独立したバックグラウンドセッションです。

結論を先に言うと、subagent には入れ子の深さと同時実行数の上限がハーネスに組み込まれていますが、独立セッションには、公式ドキュメントで確認できる範囲ではその種の上限がありません。筆者は検証用のリポジトリで、独立セッションの起動を外付けの wrapper(起動用のスクリプト)に寄せて上限を足し、深さ 3・子は最大 2 で再帰させてみました。分かったのは、協力的なエージェントが通常の経路で起動する限り上限は守れる一方、わざと迂回するエージェントを止める強さはない、ということです。数字と一緒に見ていきましょう!

この記事の要点

  • Claude Code の subagent には、入れ子の深さ(既定 3 層)と同時実行数(既定 20)の上限が組み込まれている。claude –bg の独立セッションには、公式ドキュメントで確認できる範囲では同じ種類の上限がない
  • 独立セッションの起動を wrapper に寄せて上限(深さ ≤ 3・子 ≤ 2・累積 ≤ 8・同時実行 ≤ 5)を足し、再帰させてみると、実際に効いたのは同時実行数の上限だった(根のセッション自身も 1 枠を使う)
  • 協力的なエージェントが wrapper を通して起動する限り、上限は守れた。wrapper を通さない直接起動は一部の形しか止まらず、呼び出し元の偽装や台帳の書き換えは防げない
  • わざと迂回するエージェントまで止めるには、wrapper と台帳を別ユーザーの持ち物にする、OS のサンドボックスで書き込み先を絞る、といった層が要る

「フラクタル型」という考え方

フラクタル型という呼び方は、確立した用語ではないようです。筆者が見つけた出どころは、Web 上の「トーラスエンジニアリング」シリーズのフラクタル編(2026 年 8 月、表記は The Torus Engineering Working Group)で、サイト自身が「AI駆動開発コミュニティのバズワード文化へのオマージュ」と書き、本文にも「ここまでを冗談として読んだ読者は正しい。」とあります。ただ、冗談の部分を除くと、各階層が同じ契約に従い、作ることより確かめることに重きを置く、という、まっとうな設計の話として読めます(筆者の要約)。

実装の例もあります。2026 年 7 月に公開されたオープンソースの Plasma AI Fractal は、エージェントの実行を木の形に入れ子にします。ソースコード(commit e0cb096 時点)を読むと、子を起動するときに Node._check_caps が深さ・子の数・子孫の数を確かめ、上限を超えると例外を出して起動を拒否します。docstring には「every ancestor’s config is checked so limits hold without agent cooperation」(エージェントの協力に頼らず上限が守られるよう、すべての祖先の設定を確かめる)とあります。再帰させるなら、上限はプロンプトのお願いではなくコードで持つ、という考え方です。

subagent の入れ子には、上限が組み込まれている

Claude Code の公式ドキュメントによると、subagent は既定で、メインの会話から 3 層下まで subagent を起動できます(v2.1.219 以降。それより前の版では既定値が違います)。上限に達した subagent からは Agent ツールが外されるので、その subagent は任された仕事を自分でこなして要約を 1 つ返すしかありません(会話の分岐である fork だけはツールが残りますが、呼ぶとエラーになります)。深さは環境変数 CLAUDE_CODE_MAX_SUBAGENT_SPAWN_DEPTH で変えられ、1 にすると入れ子そのものを止められます。

同時に動ける数にも上限があります。既定では、1 つのセッションで subagent が 20 個動いているときに次を起動しようとすると Concurrent subagent limit reached で失敗し、CLAUDE_CODE_MAX_CONCURRENT_SUBAGENTS で数を変えられます(v2.1.217 以降)。ただし、ドキュメントは例外も明記しています。

  • セッションの中で起動する生成の総数には上限がない
  • /subtask で始める会話の分岐(fork)は、枠を使うが上限では止められない
  • 終わった subagent を再開すると、上限を確かめずに新しい枠を取るので、動いている数が上限を超えることがある
  • ultracode が有効なセッションでは、同時実行数の上限そのものが適用されない

一方の独立セッションは、claude --bg "<指示>" で起動する、ターミナルを閉じても動き続ける完全な Claude Code の会話です。セッション同士は SendMessage でメッセージを送り合え(セッション間メッセージは v2.1.224 以降)、受け取る側が待機中なら、届いたメッセージで新しいターンが始まります。待つ側が sleep や確認の繰り返しを書く必要はありません。ただし、受信側の設定や、送受信の片方だけが権限確認を飛ばすモードの場合には、メッセージが承認待ちに保留されたり捨てられたりします。ただ、エージェントビューのドキュメントが挙げる制限は、並列に 10 体動かせば利用枠は 1 体のときのおよそ 10 倍の速さで減る、といった利用量の注意で、筆者が確認した範囲の公式ドキュメントには、独立セッションが別の独立セッションを起動する深さや数を止める仕組みの記載がありませんでした。どのセッションがどのセッションを起動したか、という親子関係も今回はハーネス側では追えなかったため、wrapper の台帳で管理しました。

観点subagent(Agent ツール)独立セッション(claude --bg)
深さの上限既定 3 層(環境変数で変更可)公式 docs に記載なし
同時実行の上限既定 20(例外あり)公式 docs に記載なし
生成の総数上限なし(docs に明記)公式 docs に記載なし
動く場所と寿命親セッションの中別々のプロセス。権限モード・作業場所・寿命をそれぞれ持つ
結果の受け渡し要約が親に返るSendMessage で報告を送り合う

違いは「文脈を持てるかどうか」ではありません。subagent も独立した文脈を持ち、SendMessage で再開すれば、それまでのツール呼び出しや結果を保ったまま続きから動けます(組み込みの Explore と Plan は 1 回限りで、再開できません)。違いは、上限を誰が持つかと、各階層が独立したプロセスとして判断を続けられるかにあります。独立セッションを再帰させるなら、上限は自分で作る必要があります。

外付けの wrapper で上限を足す

筆者が作った wrapper は、子の起動をすべて 1 本のスクリプトに通し、起動の前に数えて、超えていれば拒否する、という単純なものです。使い方は次の 2 つだけです。

spawn.sh --init <接頭辞>             # 呼び出したセッションを根(深さ 0)として台帳に登録する
spawn.sh <接頭辞>-<名前> <<'BRIEF'    # 子を起動する。指示書は標準入力から読む
(指示書の本文)
BRIEF

wrapper の中でやっていることは次のとおりです(実験のあとのレビューで直した点を含む現在の版です。実験時の版は、台帳への記録を起動の成功後に書いていました)。

  • 呼び出し元のセッションを環境変数 CLAUDE_CODE_SESSION_ID で特定し、台帳から深さと親を引く。台帳に無いセッションからの呼び出しは拒否する
  • ファイルロック(flock)の下で、深さ ≤ 3、1 親あたりの子 ≤ 2(終わった子も数える)、累積の生成総数 ≤ 8、同時実行 ≤ 5、空きメモリ ≥ 2GB を確かめ、超えていれば終了コード 2 で拒否する
  • 起動のコマンドは wrapper が固定する。claude --bg -n <名前> --model sonnet --permission-mode auto --settings <JSON> "<前置き>(改行)<指示書>" の形で、受け付ける引数は 1 個だけ、- で始まる引数は拒否する。権限モードを緩める後続の引数を付けられないようにするためです
  • 子に渡す設定では、claude --bg などを Bash で直接実行することと、wrapper や台帳をファイル編集ツールで書き換えることを禁止ルール(deny)に入れる
  • 起動の前に台帳へ予約の行を書き、起動後の処理が途中で落ちても数え漏れないようにする。また、台帳に無いのに接頭辞付きの名前を持つセッションが見つかったら、以後の起動をすべて拒否する
  • 上限の値はスクリプト内の定数で、環境変数では緩められない

Plasma AI Fractal との違いが 1 つあります。Plasma の _check_caps は、深さは終わったノードも含めて数えますが、子の数と子孫の数は終わっていないノードだけを数えます。docstring 自身が「bounding concurrency, not lifetime spawn count」(抑えるのは同時実行数で、生涯の生成総数ではない)と書いています。筆者の wrapper は、それに加えて累積の総数も数えるようにしました。

深さ 3・子 2 で動かしたら

2026 年 10 月 19 日に、お題を変えて 2 回試しました。子はすべて Sonnet・auto mode で、作業場所は空の専用ディレクトリ、お題は Web の公開情報を読むだけのものです。禁止事項と報告の形式は、子へ一字一句そのまま渡すよう指示しました。

  • 1 回目: 記事の裏取り 2 問。委譲は任意(「10 分で片付くなら委譲しない」)
  • 2 回目: 「再帰的に起動する公開実装 6 つは、広がりすぎをどう抑えているか」。深さ 3 未満のノードは必ず 2 つに分けて委譲する
項目1 回目(委譲は任意)2 回目(委譲は必須)
起動したセッション2(深さ 1 が 2)4(深さ 1 が 1、深さ 2 が 2、深さ 3 が 1)
wrapper の呼び出し3(成功 2・拒否 1)。子からの委譲は 07(成功 4・拒否 3)
拒否の理由根の 3 体目が子の数の上限に当たった3 回とも同時実行数の超過(稼働中 5 体・上限 5)
拒否のあと—3 回とも迂回せず、拒否された分を親が自分で調べた
2 体以上が開いた URL03(どれも「子の結果を 1 つ以上独立に確認する」という指示による再取得)
禁止事項からの逸脱00(灰色が 1 件。深さ 2 の 1 体が別の作業ディレクトリへ移ってから wrapper を実行した。読み取りのみ)
子の留保が親の報告で消えた数—0(9 項目すべて残った)
所要時間1 分 15 秒/2 分 13 秒木全体で 2 分 32 秒

数え方を添えます。起動したセッションの数は wrapper の台帳と claude agents --json --all の一覧を突き合わせ、拒否の数は wrapper の監査ログ(拒否ごとに 1 行を書く)から数えました。重複・逸脱・所要時間は、各セッションの記録ファイル(transcript)からツール呼び出しを全件取り出して数え、エージェントの自己申告は使っていません。所要時間は記録の最初と最後の時刻の差です。留保は、子の報告の「留保」の項目が親の報告に残っているかを 1 項目ずつ照合しました。

まず目に付くのは、広がりすぎが起きなかったことです。委譲を任意にすると、子は問いが小さいと判断して 1 体も委譲しませんでした。委譲を必須にしても、起動できた子孫は 4 体でした。上限ごとに、子孫の数の天井を計算すると次のようになります。

数え方子孫の最大数
木の形だけ(深さ ≤ 3・子 ≤ 2、根が 2 体起動した場合)14(2+4+8)
木の形だけ(根が 1 体だけ起動した、2 回目の実際の形)7(1+2+4)
+累積の上限(2 回目は開始時に 6 へ絞った)6
+同時実行の上限 5(根を含む。誰もまだ終わっていない間)4

効いていたのは同時実行数の上限でした。しかも、その 5 には根自身が入っていました。根も独立セッションなので、一覧の「稼働中」に数えられ、子孫に使える枠は実質 4 だったのです。上限を決めるときは、根を数えるのかどうかを先に決めておく必要があります。

重複は「独立に確かめよ」と指示した再取得だけで、指示の外の重複は 0 でした。重複を減らすことと検証を確保することは、引っ張り合う関係にあります。留保が消えなかったのは、報告形式で「子の留保は消さずに残す」と見出し付きで求めたためとみられますが、比べる条件を置いていないので推測です。どの条件も 1 回ずつの観測で、モデルやお題を変えれば結果は変わりえます。

何が守れて、何が守れなかったか

wrapper 自体は、Claude Code を起動しない偽物(スタブ)に差し替えた自己テスト 64 項目で確かめました。子の 3 体目、深さ 4、累積 9 体目、権限モードを緩める後続の引数、台帳の行を消して枠を取り戻す、などの試した変異はすべて拒否されました(台帳の行の削除を見抜けるのは、そのセッションがまだ一覧に残っている間だけです。削除済みのセッションの行を消されると検出できません)。6 本を同時に起動すると上限の数だけが通り、ファイルロックを外した版では 3 回試して 3 回とも 6 本すべてが通りました。数えてから書くまでの隙間を突かれる競合(TOCTOU)を、ロックなしでは防げないことの再現です。

難しいのは、wrapper を通らない起動です。子のセッションから、--help だけを付けて(セッションは作らずに)直接起動を試すと、止めた層が形によって分かれました。

試したコマンドの形止めた層
claude --bg --help、command claude --bg --help、env claude --bg --help、claude --background --help設定の禁止ルール
絶対パスで claude を指定禁止ルールをすり抜け、auto mode の分類器が拒否
bash -c 'claude --bg --help'禁止ルールをすり抜け、分類器が拒否
claude -n x --bg --help(フラグの順序を変える)禁止ルールをすり抜け、分類器が拒否

これはドキュメントどおりの挙動です。Bash の権限ルールは、エージェントが書いたコマンドの文字列に当てはめるもので、同じプログラムを別の形で呼ぶと当たらず、そのプログラムを囲うセキュリティの境界にはならない、と明記されています。すり抜けた 3 形を止めたのは auto mode の分類器で、こちらは判定が状況で変わりうる仕組みです。さらに、分類器が 4 回続けて拒否したところで、子は人の確認待ちの状態で止まりました。ドキュメントには、分類器が 3 回続けて、または通算 20 回拒否すると auto mode を一時停止して確認に戻る、とあります(回数の差の理由は今回の記録からは分かりません)。人が見ていない独立セッションで動かすなら、この止まり方も設計に入れておく必要があります。

もう一つ、改ざんには耐えられません。wrapper と台帳は子と同じユーザー権限で書き込めますし、禁止ルールはファイル編集ツール経由の書き込みしか塞がず、Bash のリダイレクトは塞げません。呼び出し元の特定も環境変数を信じているので、根の値を名乗れば根として振る舞えます。まとめると次のようになります。

対象守れたか
協力的なエージェントが wrapper 経由で起動するときの深さ・子の数・累積・同時実行・空きメモリ✅ 守れた
権限モードの固定と、危険な後続引数の拒否✅ 守れた
wrapper を通さない直接起動△ 一部の形は禁止ルール、残りは分類器頼み
呼び出し元の偽装、台帳・wrapper の書き換え❌ 守れない

シェルスクリプトで塞げるのは「wrapper の中で決まること」までです。意図して迂回するエージェントまで止めるなら、wrapper と台帳を別のユーザーの持ち物にする、OS のサンドボックスで子の書き込み先を絞る、といった層が要ります。この点は Plasma AI Fractal も同じで、上限は Python の中にあり、ノードは権限確認をすべて飛ばす bypassPermissions の設定で動いています。

筆者の検証では:起動の可否も、指示の守られ方も揺れた

数字以外にも、記録しておきたい観測があります。

  • 分類器の判定は場面で変わった: 初回の検証では、人が起動したセッションから claude --bg で子を直接起動しようとすると、分類器が「安全でないエージェントの作成」として拒否しました。一方、人が起動した子が孫を起動するのは通り、wrapper を使った回では、木の実験の 10 回に計測専用の子の起動 1 回を加えた呼び出し 11 回が、すべて分類器を通りました。ただ、同じ条件で比べてはいないので、「wrapper を通せば通る」とは言えません
  • allow ルールで通す方法は採らなかった: Bash(claude --bg *) のような前方一致の許可は、後ろに続く引数を全部通すので、権限確認を飛ばすオプション付きの起動まで無承認になります。指示文は毎回変わるので、完全一致の列挙もできません
  • 指示は決まりであって、強制ではない: 「ファイルを作らない」と指示した子が、調べるソース 67 件をセッション専用の作業ディレクトリへダウンロードしていました。リポジトリへの変更はなく、セッションの削除で片付きましたが、深くするほどこうした小さな逸脱が積み重なります
  • 拒否されうるコマンドに前処理を混ぜない: 指示書を作る処理と起動を 1 つのコマンドにまとめていたため、起動が拒否されると指示書も作られず、人が手で起動し直したときに中身の空の子が立ち上がる手戻りがありました。前処理と起動は別の呼び出しに分けるのが安全です

再帰委譲を試すときの鍵は次の3点です

  • 上限は指示文ではなくコードで持つ
    深さ・子の数・累積・同時実行をロックの下で数え、起動の前に拒否します。subagent ならハーネスの上限と例外を確かめ、独立セッションなら自分で足します。同時実行の数に根を含めるかも決めておきましょう。
  • 何を守れて何を守れないかを分けて書く
    Bash の権限ルールはコマンド文字列の照合で、境界ではありません。同じユーザー権限の wrapper は、協力的なエージェントの「通常の経路」を守る道具だと割り切ると、過信せずに済みます。
  • 委譲しない判断と、報告の形式を設計する
    今回、広がりすぎを抑えたのは上限そのものより、子の「委譲しない」判断と同時実行の上限でした。留保を消さない報告形式も、階層をまたぐ伝言の劣化を防ぐ手がかりになります。

まとめ:上限は「誰が持つか」で選ぼう!

subagent は、深さと同時実行の上限をハーネスが持ってくれる代わりに、親セッションの中で動きます。独立セッションは、各階層が別のプロセスとして判断を続けられる代わりに、上限を自分で作らなければなりません。外付けの wrapper で上限を足すと、協力的なエージェントが通常の経路で動く限りはきちんと止まりますが、迂回しようとするエージェントまで止めるには、ユーザーの分離やサンドボックスという別の層が要ります。

複数のエージェントの協調そのものについては、マルチエージェントの協調の記事で、ハーネスが成績を左右するという研究の流れはエージェント・ハーネスの記事で紹介しています。まずは深さ 2・子 1 くらいの小さな木から、上限と後始末の手順を決めて試してみてください!

参考文献

タイトルとURLをコピーしました