環境変数

CLAUDE_CODE_DISABLE_BACKGROUND_TASKS

1に設定すると、バックグラウンドでのタスク実行、Ctrl+Bショートカット、およびサブエージェントの非同期実行をすべて無効にします。

使い方・用途

  • リソース制約がある環境で、意図しないバックグラウンド処理の発生を完全に抑止し、すべてのタスクを同期的(フォアグラウンド)に実行させたい場合に使用します。
  • サブエージェントの挙動を逐一把握したい場合や、不安定な環境でのデバッグ時に役立ちます。
英語原文(公式ドキュメントより)

Set to 1 to disable all background task functionality, including the run_in_background parameter on Bash and subagent tools, auto-backgrounding, and the Ctrl+B shortcut

関連する変更履歴

v2.1.4 (1件)

Added
CLAUDE_CODE_DISABLE_BACKGROUND_TASKS 環境変数が追加され、自動バックグラウンド化や Ctrl+B ショートカットを含む、すべてのバックグラウンドタスク機能を無効にできるようになりました。
英語原文を表示
Added CLAUDE_CODE_DISABLE_BACKGROUND_TASKS environment variable to disable all background task functionality including auto-backgrounding and the Ctrl+B shortcut

変更前

以前は、Claude Code のバックグラウンドタスク機能(例えば、自動バックグラウンド処理や Ctrl+B ショートカットによる手動でのバックグラウンド化)は常に有効でした。これにより、特定のワークフローや環境において、意図しない挙動やリソースの使用が発生する可能性がありました。

変更後

この変更により、CLAUDE_CODE_DISABLE_BACKGROUND_TASKS 環境変数を設定することで、バックグラウンドタスク機能を完全に無効にできるようになりました。これにより、ユーザーは Claude Code の動作をより細かく制御できるようになります。

ユーザーへの恩恵

バックグラウンドタスクが不要な場合や、特定のリソース制約がある環境で作業する場合に、不要な処理を停止し、より安定した開発環境を維持できます。これにより、開発体験が向上し、作業に集中できるようになります。