環境変数

CLAUDE_CODE_MCP_STARTUP_WAIT_MS

非対話セッションの最初のターンが、接続中の MCP サーバーを待つ時間(ミリ秒)で、デフォルトの最初のターンの待機に代わって適用される。設定した場合、その待機はすべての未接続サーバーを対象とする。0 を設定すると待機をスキップする。--permission-prompt-tool のサーバーは、この値にかかわらず独自の MCP_TIMEOUT 待機を保持する。Claude Code v2.1.274 以降が必要。

使い方・用途

  • 非対話実行の最初のターンが、接続中の MCP サーバー(stdio・HTTP・SSE)の接続完了を待つ時間の上限を設定する。設定するとすべての未接続サーバーが対象になる
  • 0 を指定すると待機しない。例: env オプションに CLAUDE_CODE_MCP_STARTUP_WAIT_MS: "5000" を指定
  • --permission-prompt-tool のサーバーはこの値にかかわらず従来どおり MCP_TIMEOUT まで待機する。v2.1.274 以降が必要
英語原文(公式ドキュメントより)

How long in milliseconds the first turn of a non-interactive session waits for MCP servers that are still connecting, in place of the default first-turn wait. When set, the wait covers every pending server. Set to 0 to skip the wait. A --permission-prompt-tool server keeps its own MCP_TIMEOUT wait regardless of the value. Requires Claude Code v2.1.274 or later

関連ドキュメント

関連する変更履歴

v2.1.274(1件)

Added
最初の非対話ターンが接続中のMCPサーバーの接続を待つ時間に上限を設定する環境変数 CLAUDE_CODE_MCP_STARTUP_WAIT_MS を追加した(0 = 待機しない)。
英語原文を表示
Added CLAUDE_CODE_MCP_STARTUP_WAIT_MS to bound how long the first non-interactive turn waits for connecting MCP servers (0 = don't wait)

変更前

非対話実行時、最初のターンは接続中のMCPサーバーの接続完了をどれだけ待つかを制御する専用の環境変数がなく、待ち時間をユーザーが調整できなかった。

変更後

最初の非対話ターンが接続中のMCPサーバーの接続完了を待つ時間に上限を設定できる環境変数 CLAUDE_CODE_MCP_STARTUP_WAIT_MS が追加された。0 を指定すると待機しない。

ユーザーへの恩恵

ユーザーは待ち時間を環境変数で調整または無効化できるようになり、起動時の待ち時間を状況に応じて最適化できる。

関連ドキュメント