CLAUDE_CODE_MCP_AUTO_BACKGROUND_MS

環境変数

実行中のままの MCP ツール呼び出しがバックグラウンドタスクへ移動されるまでの経過時間をミリ秒で指定する(既定: 120000、つまり 2 分)。0 に設定すると自動バックグラウンド化がオフになり、対話セッションでは Claude が MCP タスクの完了を待つようになる。Claude Code v2.1.212 以降が必要

使い方・用途

  • MCPツール呼び出しが長時間完了せず、その間セッションが操作できなくなる事態を避けたい場合に、一定時間経過後に呼び出しをバックグラウンドタスクへ移してセッションを使い続けられるようにする。
  • 2分という既定の自動バックグラウンド移行までの閾値が短すぎる・長すぎると感じる場合に、ミリ秒単位で閾値を調整する。
  • 対話セッションでMCPタスクの結果を必ず待ってから次の処理に進ませたい場合に、この環境変数を0に設定して自動バックグラウンド化を無効化する。
英語原文

Elapsed time in milliseconds before a still-running MCP tool call moves to a background task (default: 120000, or 2 minutes). Set to 0 to turn automatic backgrounding off and, in an interactive session, to make Claude wait for MCP tasks. Requires Claude Code v2.1.212 or later

関連ドキュメント

関連する変更履歴

v2.1.212(1件)

2分以上実行される MCP ツール呼び出しは自動的にバックグラウンド処理へ移行させ、メインセッションの操作性を維持します。
英語原文を表示
MCP tool calls running longer than 2 minutes now move to the background automatically so the session stays usable; configure the threshold or disable with CLAUDE_CODE_MCP_AUTO_BACKGROUND_MS

変更後

MCP サーバーの応答待ち時間に作業を中断させられることがなくなります。

関連ドキュメント