新機能 / v2.1.269
CLAUDE_CODE_WORKFLOW_MAX_CONCURRENT_AGENTS
CHANGELOG 原文（英語）
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 公式の変更履歴を開く ↗ 日本語での補足
CLAUDE_CODE_WORKFLOW_MAX_CONCURRENT_AGENTS（1-256）を追加。推論待ちが中心のfan-outにおいて、Workflowツールの実行あたりの同時エージェント数上限を引き上げられる。
ドキュメント
ドキュメントの抜粋（参考訳）
動作と制限
ランタイムは、次の制約を適用します。
| 制約 | 理由 |
|---|---|
| 実行中のユーザー入力なし | 実行が自動的に一時停止するのは、エージェントの権限プロンプトと使用量制限による待機のときだけです。ステージ間で承認を挟みたい場合は、各ステージを個別のワークフローとして実行してください |
| ワークフロー自体からファイルシステムやシェルへ直接アクセスできない | エージェントが読み書きやコマンド実行を行います。スクリプトはエージェントを調整するだけです |
モジュールを読み込めない: import() を含むスクリプトは実行開始前に失敗する |
スクリプト本体はプレーンな JavaScript です。ライブラリが必要な処理はエージェントのタスクに含めてください |
既定では同時実行エージェントは最大 16。Claude Code が利用できる CPU が少ない場合(CPU 制限のあるコンテナ内を含む)はさらに少なくなります。上限を変更するには、CLAUDE_CODE_WORKFLOW_MAX_CONCURRENT_AGENTS に 1 から 256 の値を設定します。これには Claude Code v2.1.269 以降が必要です |
ローカルのリソース使用量を制限するためです |
| ファンアウトでは、最初のエージェントとプロンプトキャッシュのプレフィックスを共有するエージェントは、既定で最初のエージェントの開始から最大 5 秒後に開始します | 最初のエージェント以外は、それぞれ未キャッシュで処理する代わりに、最初のエージェントがキャッシュしたプレフィックスを読み取ります |
1 回の parallel() または pipeline() 呼び出しにつき最大 4,096 件まで: これを超えるリストはランタイムがエラーで拒否します |
上限を超えた分を黙って落とすと、スクリプトに知らせずに作業の一部が失われてしまいます |
| 1 回の実行あたり合計 1,000 エージェントまで | 暴走ループを防ぐためです |
取得日 · 2026-09-23