環境変数

CLAUDE_CODE_MAX_SUBAGENT_SPAWN_DEPTH

メインの会話から派生できるサブエージェントの階層の深さを指定します（デフォルト: 1）。

使い方・用途

デフォルトではサブエージェントがさらに別のサブエージェントを生成することはできません。
タスクを階層的に委譲したい場合（例：レビュー担当がさらに検証担当を派遣する等）に、2以上の値を設定してネストを許可します。
階層を深くすることで複雑な並列サブタスクを管理できますが、無効化（制限解除）することはできません。

英語原文(公式ドキュメントより)

Number of subagent layers allowed below the main conversation (default: 1). At the default, subagents can't spawn their own subagents; set 2 or higher to allow it. Accepts a positive whole number in plain digits; anything else is ignored, so the limit can be raised but not turned off. Requires Claude Code v2.1.217 or later

関連する変更履歴

v2.1.219(1件)

Added

Sub-agents

サブエージェントがネストされたサブエージェントを生成できる深さを、デフォルトで 1 から 3 に引き上げました。

英語原文を表示

Subagents can now spawn nested subagents up to depth 3 by default (was 1); set CLAUDE_CODE_MAX_SUBAGENT_SPAWN_DEPTH=1 to disable nesting

変更前

ネスト可能な深さが 1 に制限されており、複雑な委譲構造を持つタスクの実行が困難でした。

変更後

デフォルトで 3 階層までサブエージェントを生成できるようになりました。

ユーザーへの恩恵

より多段階で複雑なタスクの分解・実行を自動化できます。

v2.1.217(1件)

Changed

サブエージェントのネスト生成をデフォルトで無効化しました。

英語原文を表示

Changed subagents to no longer spawn nested subagents by default; set CLAUDE_CODE_MAX_SUBAGENT_SPAWN_DEPTH to allow deeper nesting

変更前

サブエージェントがさらにサブエージェントを生成することが無制限に可能でした。

変更後

ネストは許可しない設定とし、必要に応じてCLAUDE_CODE_MAX_SUBAGENT_SPAWN_DEPTHで拡張するように変更しました。