CLAUDE_CODE_WORKFLOW_MAX_CONCURRENT_AGENTS

環境変数

1 回の workflow 実行が同時に実行するエージェント数で、1 から 256 の範囲。デフォルトでは最大 16 エージェントを同時に実行し、CPU が少ない場合はそれより少なくなる。キューイングされた agent() 呼び出しは空きスロットを待つ。実行中の各エージェントのトランスクリプトは Claude Code のメモリに保持されるため、大きな値はメモリ使用量を増やす。プレーンな数字のみを受け付け、範囲外の値やその他の表記はデフォルトを維持する。Claude Code v2.1.269 以降が必要。

使い方・用途

  • Workflow ツールの 1 回の実行あたりの同時エージェント数上限を指定する。デフォルトは最大 16(CPU が少ない環境・CPU 制限付きコンテナ内ではさらに少ない)
  • 1〜256 の範囲で設定でき、推論律速のファンアウト処理で並列性を高め、複数ソースの並列調査などを高速化できる
  • 実行中の各エージェントのトランスクリプトはメモリに保持されるため、大きい値ほどメモリ使用量が増える。範囲外の値や不正な表記はデフォルトのまま。v2.1.269 以降が必要
英語原文

How many agents a single workflow run executes at once, from 1 to 256. By default, a run executes up to 16 agents at once, fewer when Claude Code has fewer CPUs available; queued agent() calls wait for a free slot. Each running agent's transcript stays in Claude Code's memory, so higher values raise memory use. Takes plain digits only; out-of-range values and other spellings keep the default. Requires Claude Code v2.1.269 or later

関連ドキュメント

関連する変更履歴

v2.1.269(1件)

推論律速のファンアウト処理のために Workflow ツールの 1 実行あたりの同時エージェント上限を引き上げる CLAUDE_CODE_WORKFLOW_MAX_CONCURRENT_AGENTS(1〜256)を追加した
英語原文を表示
Added CLAUDE_CODE_WORKFLOW_MAX_CONCURRENT_AGENTS (1–256) to raise the Workflow tool's per-run concurrent agent limit for inference-bound fan-outs

変更後

環境変数を設定することで、Workflow ツールの同時実行エージェント数をデフォルト上限の 16 から最大 256 まで引き上げられる。推論がボトルネックになる大量のファンアウト処理でも、より多くのエージェントを並列に動かしてワークフロー全体の完了を速められる。

関連ドキュメント