環境変数

CLAUDE_CODE_DISABLE_BG_SHELL_PRESSURE_REAP

OSがメモリ不足を報告した際に、Claude Codeがバックグラウンドのシェルコマンドを終了させる挙動を無効化するには1を設定します。

使い方・用途

  • デフォルト（macOS/Linux）では、セッションが30分間アイドル状態で、かつ実行中のターンやサブエージェントがない場合に、メモリ負荷に応じてタスクが自動クリーンアップされます
  • メモリ不足時でも特定のバックグラウンドタスクを維持し続けたい場合に有効です
  • Windowsにはメモリ圧迫信号がないため、この設定は影響しません
英語原文(公式ドキュメントより)

Set to 1 to stop Claude Code from terminating background shell commands when the operating system reports memory pressure. By default, on macOS and Linux, Claude Code terminates a background shell started in the main session on a memory-pressure signal once the session has been idle for 30 minutes and no turn or subagent is running. Windows has no memory-pressure signal, so this variable has no effect there. Requires Claude Code v2.1.193 or later

関連する変更履歴

v2.1.193(1件)

Added
アイドル状態のバックグラウンドシェルコマンドに対するメモリの自動解放機能を追加
英語原文を表示
Added automatic memory-pressure reaping for idle background shell commands (disable with CLAUDE_CODE_DISABLE_BG_SHELL_PRESSURE_REAP=1)

変更前

バックグラウンドで実行されたまま放置されたシェルコマンドが、メモリを消費し続けてシステムのパフォーマンスに影響を与える可能性がありました。

変更後

システムにメモリ負荷がかかった際、アイドル状態のバックグラウンドプロセスを自動的にクリーンアップする仕組みが導入されました。

ユーザーへの恩恵

長時間 CLI を使用していてもリソースの枯渇を防ぎ、常に安定した動作環境を維持することができます。

関連ドキュメント