環境変数

CLAUDE_CODE_BG_TASKS_REPORT_RUNNING

0 を設定すると、バックグラウンド作業が実行中でも、非対話セッションがターン終了のたびにホストへアイドル状態を報告するようになる。デフォルトでは、バックグラウンドエージェントやワークフロー実行などのバックグラウンド作業が生きている間は、セッションはターン終了後も実行中ステータスを報告し続ける。これにより、リモートセッションリストのようなステータスを監視するホストが、作業中に Claude が入力待ちであると告知してしまうのを防ぐ。開発サーバーなどのバックグラウンドシェルコマンドは実行中ステータスを保持しない。実行中ステータスのデフォルト動作と 0 でのオプトアウトには Claude Code v2.1.269 以降が必要で、それ以前のバージョンでは 1 を設定して実行中ステータスを保持する。

使い方・用途

  • デフォルトでは、バックグラウンドエージェントやワークフロー実行が生きている間、非対話セッションはターン終了後も実行中ステータスを報告し続け、リモートセッションリストなどが作業中に「入力待ち」と誤表示するのを防ぐ(v2.1.269 以降)
  • 0 を設定すると以前の動作に戻り、ターン終了のたびにアイドル状態が報告される
  • 開発サーバーなどのバックグラウンドシェルコマンドは実行中ステータスを保持しない。v2.1.269 未満では 1 を設定して実行中ステータスを保持する
英語原文(公式ドキュメントより)

Set to 0 to make a non-interactive session report an idle status to its host at every turn end, even while background work is still running. By default, the session keeps reporting a running status past turn end while background work such as a background agent or a workflow run is still live. This keeps a host that watches the status, such as a remote session list, from announcing that Claude is waiting for your input mid-work. Background shell commands, such as a dev server, don't hold the running status. The running-status default and the 0 opt-out require Claude Code v2.1.269 or later; on earlier versions, set 1 to hold the running status

関連する変更履歴

v2.1.269(1件)

Fixed
バックグラウンドエージェントの実行中に、リモートセッションやヘッドレスセッションが「waiting for your input(入力待ち)」と誤って報告される問題を修正しました(環境変数 CLAUDE_CODE_BG_TASKS_REPORT_RUNNING=0 を設定すると以前の動作に戻せます)。
英語原文を表示
Fixed remote and headless sessions reporting "waiting for your input" while background agents were still running (set CLAUDE_CODE_BG_TASKS_REPORT_RUNNING=0 to restore the old behavior)

変更前

バックグラウンドエージェントが動作中でも、リモートセッションやヘッドレスセッションが「入力待ち」と誤って報告され、実際には処理が進行中であるにもかかわらずユーザー入力を待っている状態に見える。

変更後

バックグラウンドエージェントが動作中でも、リモートセッションやヘッドレスセッションが即座に「入力待ち」と表示されるようになる。

ユーザーへの恩恵

バックグラウンドエージェントの実行状況を正しく把握でき、完了前にセッションを終了して処理を中断してしまうリスクを避けられる。

関連ドキュメント