環境変数

CLAUDE_CODE_PRINT_BG_WAIT_CEILING_MS

-p フラグによる非対話モードで、最後のターンの後にサブエージェントやワークフローなどのバックグラウンド処理を待機するアイドル時間の上限(ミリ秒)。Claude がバックグラウンドの結果を処理するターンを行うたびに、アイドル待機は最初からやり直す。デフォルトは 600000(10 分)。アイドル待機が上限に達すると、Claude Code は残りのバックグラウンドタスクの待機をやめる。メイン会話が開始した実行中のバックグラウンドコマンドは、この上限を越えても実行を保持する。0 を設定すると無期限に待機する。Claude Code v2.1.182 以降が必要

使い方・用途

  • 非対話モードの claude -p でサブエージェントやワークフローなどのバックグラウンド処理の完了待ちが既定の 10 分で打ち切られてしまうとき、上限を引き上げて処理結果が破棄されるのを防ぐ
  • 長時間かかるバックグラウンドコマンドを主会話から起動しており、claude -p の実行をバックグラウンド処理が終わるまで確実に保持したいときに待ち時間の上限を調整する
  • CI などで claude -p の実行時間を一定以内に収めたい場合、待ち時間の上限を短めに設定して残りのバックグラウンドタスクを早めに打ち切る
英語原文(公式ドキュメントより)

Ceiling in milliseconds on idle waiting for background work, such as subagents and workflows, after the final turn in non-interactive mode with the -p flag. Idle waiting starts over each time Claude takes a turn to handle a background result. Default: 600000, or 10 minutes. When idle waiting reaches the ceiling, Claude Code stops waiting for the remaining background tasks. A running background command that the main conversation started holds the run open past it. Set to 0 to wait indefinitely. Requires Claude Code v2.1.182 or later

関連ドキュメント