1 に設定すると、長時間実行されるエージェントタスクの自動バックグラウンド化を強制的に有効にする。有効にすると、サブエージェントは約 2 分実行した後にバックグラウンドへ移る。サブエージェントの後ろにファイル編集などのツール呼び出しがキューイングされていた場合、その呼び出しが開始される前にサブエージェントはフォアグラウンドで完了する。Claude Code v2.1.212 以降では、非インタラクティブモードにおける長時間の MCP ツール呼び出しの自動バックグラウンド化も有効になる。
Set to 1 to force-enable automatic backgrounding of long-running agent tasks. When enabled, a subagent moves to the background after running for approximately two minutes. If Claude queued a tool call such as a file edit behind the subagent, the subagent finishes in the foreground before that call starts. Also enables automatic backgrounding of long MCP tool calls in non-interactive mode on Claude Code v2.1.212 or later
CLAUDE_AUTO_BACKGROUND_TASKS が、サブエージェントの後ろで編集やシェルコマンドが待っている間にそのサブエージェントをバックグラウンドに移動し、その呼び出しがサブエージェントの完了前に開始される問題を修正CLAUDE_AUTO_BACKGROUND_TASKS moving a subagent to the background while an edit or shell command waited behind it, which started that call before the subagent finished関連ドキュメント
--output-format stream-json の出力で、サブエージェントが実行中にバックグラウンドへ移行された場合(例: CLAUDE_AUTO_BACKGROUND_TASKS による移行)、その残りのメッセージと最終レポートが欠落する問題を修正する--output-format stream-json output dropping a subagent's remaining messages and final report after it is moved to the background mid-run (e.g. by CLAUDE_AUTO_BACKGROUND_TASKS)