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, 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

関連ドキュメント