CLAUDE_CODE_DISABLE_BACKGROUND_TASKS

環境変数

1 を設定すると、Bash、PowerShell、subagent の各ツールから run_in_background パラメータが削除され、Ctrl+B ショートカットとフォークされたスキルのバックグラウンド実行が無効になる。これに伴い、Claude Code はサブエージェント、長時間の MCP ツール呼び出し、タイムアウトしたシェルコマンドをバックグラウンドへ自動的に移動する動作も停止する。MCP タスクと Monitor ツールは引き続きバックグラウンドで実行される。バックグラウンドセッションも無効にするには、CLAUDE_CODE_DISABLE_AGENT_VIEW を 1 に設定する。

使い方・用途

  • コードレビューなどのタスクが自動的にバックグラウンドに回されて待ちたくない場合に、すべてのバックグラウンド実行を無効化してフォアグラウンドで完結させる。
  • Ctrl+B ショートカットやシェルコマンドの自動バックグラウンド移行といったバックグラウンドタスク機能をまとめてオフにしたい場合に、この環境変数を 1 に設定する。
  • SDK の backgroundTasks() を含め、タスクのバックグラウンド移行をセッション単位で完全に禁止したい場合に、確実に無効化する。
英語原文

Set to 1 to remove the run_in_background parameter from the Bash, PowerShell, and subagent tools and to turn off the Ctrl+B shortcut and background runs of forked skills. Claude Code then also stops moving subagents, long MCP tool calls, and timed-out shell commands to the background automatically. MCP tasks and the Monitor tool still run in the background. To turn off background sessions too, set CLAUDE_CODE_DISABLE_AGENT_VIEW to 1

関連ドキュメント

関連する変更履歴

v2.1.4(1件)

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

変更後

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

関連ドキュメント