AIToday
大規模言語モデルAIコーディングZenn AI/ML掲載日時: 2026年10月7日 22:00

Claude Codeの孫AI、既定3階層と判明

LINEで送る
Claude Codeの孫AI、既定3階層と判明

3つのポイント

  1. 何が起きたか

    Claude Code 2.1.285で4層の鎖を回すと、3回とも subagent_stats は max_depth=3・spawned_by_subagents=2 を示し、孫もひ孫も走った。

  2. なぜ重要か

    深さを決める環境変数を1〜5で指定した13回の検証はすべて指定どおりの階層に届き、3は天井ではなく既定値にすぎないとみられる。

  3. 注目点

    上限に達しても refused.depth_limit は39回すべて0で、深すぎる拒否は記録されず静かに浅い所で止まる点が焦点。同じ設定でも最初の4回だけ1階層だった原因は検証不可とされている。

誰に効くかClaude Code上でAIエージェントの多段呼び出しを設計する開発者や、処理の深さを設定で制御したい運用担当者に影響する。既定値に頼ると階層数が変わりうるため、深さに依存する作りなら環境変数で明示する必要がある。

わからないところ、AIに聞けます

質問と回答はこのページに公開されます。

こういう要約が、毎朝あなたのメールに届きます。

背景と解説

Claude Codeのサブエージェントは、親のAIが別のAIを下請けに出す仕組みである。今回の検証は、その下請けがさらに下請けを出せるのか、つまり孫やひ孫を作れるのかを、機械が返す集計値だけで確かめたものである。

深さを決めているのは環境変数で、1から5までの指定が13回すべて一致した。3は既定値であって天井ではない。一方、上限に達したときの見え方も独特で、断った回数を示す欄は39回すべて0のままだった。上限の階層には下請けを出す道具自体が渡されないため、深すぎるから断ったという記録は残らないと読める。

さらに、同じセッションの最初の4回だけは1階層で止まり、同じ設定を後から回すと通った。設定ファイルは変えていない。実行ファイルには既定値が遠隔の機能フラグから来ることを示す名前があるが、原因の断定は検証不可とされている。深さに依存する作りにするなら、既定値に頼らず環境変数で明示することが実用上の教訓となる。

よくある質問
サブエージェントの階層はどうやって変えられますか?
CLAUDE_CODE_MAX_SUBAGENT_SPAWN_DEPTH という環境変数で指定できる。1から5まで振った検証では13回すべて指定どおりの階層に届いた。
上限を超えた深さを指定するとエラーになりますか?
ならない。上限に当たったときの refused.depth_limit は39回すべて0で、深すぎる拒否の記録は残らず静かに浅い所で止まる。
既定の階層数は安定していますか?
同じ設定でも最初の4回は1階層で止まり、以降は3階層になった。実行ファイルには既定値が遠隔の機能フラグから来ることを示す名前があるが、原因は検証不可とされている。
LINEで送る

あなたの仕事に関係するAIニュースを、毎朝お届けします。

業界と使っているAIツールを選ぶと、仕事に関係するニュースが毎朝届きます。

登録無料・Googleアカウントなら30秒・いつでも解除できますAITodayについて →

AIに質問

この記事についてわからないことをAIに質問できます。AIはこの記事・AIToday の過去記事・Wikipedia を読み、出典を付けて答えます。Q&Aはこのページに公開され、他の読者も読めます。

質問と回答はこのページに公開されます。

関連記事

次の記事へopenTPU、AIでAIチップを設計