環境変数

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件)

Added
Workflow ツールの実行ごとの同時エージェント上限を引き上げられる新しい環境変数 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 ツールの同時実行エージェント数は、CPU 状況に応じて最大16(少ない場合はそれ未満)に固定されており、環境変数で調整することはできなかった。

変更後

新しい環境変数 CLAUDE_CODE_WORKFLOW_MAX_CONCURRENT_AGENTS(1〜256)が追加され、Workflow ツールの1回の実行あたりの同時エージェント数上限(旧デフォルトは最大16)を引き上げられるようになった。

ユーザーへの恩恵

推論律速のファンアウト処理で、より多くのエージェントを同時に実行できるようになり、複数ソースの並列調査などが高速に完了する。

関連ドキュメント