環境変数

CLAUDE_CODE_MAX_CONCURRENT_SUBAGENTS

1つのセッションでAgentツールが新しいサブエージェントを生成するのを拒否するまでの同時実行可能なサブエージェント数の上限を設定します（デフォルト: 20）。

使い方・用途

  • セッションあたりの同時サブエージェント実行数に制限を設けることで、リソース消費を抑制できます。
  • 指定した上限に達するとAgentツールによる生成は失敗しますが、実行数が減少すれば再び生成可能になります。
  • ultracodeが有効なセッションではこの制限は適用されず、無効化することはできません。
英語原文(公式ドキュメントより)

How many subagents can be running in one session before the Agent tool refuses to spawn another (default: 20). Accepts a positive whole number in plain digits; anything else is ignored, so the variable can adjust the cap but can't disable it. Requires Claude Code v2.1.217 or later

関連する変更履歴

v2.1.217(1件)

Added
同時実行サブエージェントに上限（デフォルト20）を設定しました。
英語原文を表示
Added a cap on concurrently-running subagents (default 20, override with CLAUDE_CODE_MAX_CONCURRENT_SUBAGENTS) so one message can't fan out unbounded background agents

変更前

単一のメッセージから無制限にサブエージェントが生成され、意図しない負荷増大が起きていました。

変更後

CLAUDE_CODE_MAX_CONCURRENT_SUBAGENTSで制御可能な上限を設けました。

ユーザーへの恩恵

サブエージェントの連鎖的な大量生成によるセッションの過負荷を避けられます。

関連ドキュメント