環境変数
CLAUDE_CODE_DISABLE_BG_EXIT_HANDOFF
1 を設定すると、スーパーバイザーがセッションのプロセスを停止・再起動・更新した際に、次のプロセスへ処理を引き継がせずに、バックグラウンドセッションの実行中の作業を停止する。この作業には、セッションで実行中のバックグラウンドシェルコマンドや動的ワークフローに加え、v2.1.198 以降ではバックグラウンドサブエージェントも含まれる。この引き継ぎのみに影響し、← や /background でセッションをバックグラウンド化した場合は、実行中のバックグラウンド作業は引き継がれる。Claude Code v2.1.196 以降が必要である。
使い方・用途
- スーパーバイザーがセッションのプロセスを停止・再起動・更新したとき、そのセッション内で実行中のバックグラウンドシェルコマンドや動的ワークフローを次のプロセスに引き継がせず、プロセスとともに停止させたい場合。
- 停止・再起動時に実行中のバックグラウンドサブエージェントもまとめて終了させ、古いプロセスが生み出した処理が新しいプロセスに残らないようにしたい場合。
英語原文(公式ドキュメントより)
Set to 1 to stop a background session's in-flight work when the supervisor stops, restarts, or updates that session's process, instead of handing it to the session's next process. That work is the session's running background shell commands and dynamic workflows, plus background subagents as of v2.1.198. Affects only that handoff: backgrounding a session with ← or /background still carries in-flight background work over. Requires Claude Code v2.1.196 or later