環境変数

CLAUDE_CODE_DISABLE_BG_EXIT_HANDOFF

1に設定すると、バックグラウンドセッションのプロセスが停止・再起動・更新される際に、実行中のバックグラウンドシェルコマンドや動的ワークフローを次のプロセスへ引き継がずに停止させます。

使い方・用途

  • デフォルトではセッションプロセスの中断後もタスクは維持され、再開時に継続されますが、リソース解放などの目的でこれらを強制終了したい場合に1を指定します
  • セッションを中断（←キーまたは/background）した際の引き継ぎには影響せず、あくまでプロセス更新時のハンドオフのみを無効化します
  • Claude Code v2.1.196以降で利用可能です
英語原文(公式ドキュメントより)

Set to 1 to stop a background session's running background shell commands and dynamic workflows when the supervisor stops, restarts, or updates that session's process, instead of handing them to the session's next process. Affects only that handoff: backgrounding a session with ← or /background still carries in-flight work over, and CLAUDE_DISABLE_ADOPT turns off both. Requires Claude Code v2.1.196 or later