環境変数

CLAUDE_STREAM_IDLE_TIMEOUT_MS

ストリーミングのアイドル監視が停止した接続を閉じるまでのタイムアウト時間をミリ秒単位で設定します(デフォルトおよび最小値は5分)。

使い方・用途

  • ネットワークが不安定な環境や、Claudeが非常に複雑で長い思考プロセスを必要とするタスクを実行している際の予期せぬ切断を防ぎます。
  • プロキシによるバッファリングなどでレスポンスが一時的に滞る場合に、セッションを維持するための待機時間を調整できます。
英語原文(公式ドキュメントより)

Timeout in milliseconds before the streaming idle watchdog closes a stalled connection. Default and minimum 300000 (5 minutes) for both the byte-level and event-level watchdogs; lower values are silently clamped to absorb extended thinking pauses and proxy buffering. For third-party providers, requires CLAUDE_ENABLE_STREAM_WATCHDOG=1

関連ドキュメント

関連する変更履歴

v2.1.257(1件)

Improved
Sub-agents
ゲートウェイのキープアライブにより応答が開いたまま保持されている間、SDK ホストへの生きている状態の報告を改善し、引き上げられた CLAUDE_STREAM_IDLE_TIMEOUT_MS の下での長い待機時間をハングしたセッションと誤認させないようにする。
英語原文を表示
Improved liveness reporting to SDK hosts while a response is held open by gateway keep-alives, so long waits under a raised CLAUDE_STREAM_IDLE_TIMEOUT_MS are not mistaken for a hung session

変更前

ゲートウェイのキープアライブにより応答が開いたまま保持されている間、SDK ホストへの生きている状態の報告が停止していたため、長い待機時間が発生した際にセッションがハングしたと誤認される可能性があった。

変更後

ゲートウェイのキープアライブにより応答が開いたまま保持されている間も、SDK ホストへの生きている状態の報告が継続されるようになったため、長い待機時間が発生してもセッションがハングしたと誤認されない。

ユーザーへの恩恵

長い待機時間が発生してもセッションがハングしたと誤認されることなく、適切に処理できるようになる。

関連ドキュメント

v2.1.84(1件)

Added
Settings
ストリーミングのアイドルタイムアウトしきい値を設定する環境変数を追加
英語原文を表示
Added CLAUDE_STREAM_IDLE_TIMEOUT_MS env var to configure the streaming idle watchdog threshold (default 90s)

変更前

APIからのレスポンスストリーミングが長時間停止した場合、一律のタイムアウト(90秒)が適用されていました。ネットワーク環境や複雑な思考プロセスによってこれ以上の時間が必要な場合でも、調整が困難でした。

変更後

環境変数 CLAUDE_STREAM_IDLE_TIMEOUT_MS を使用して、ストリーミング停止時のウォッチドッグのしきい値をミリ秒単位で設定できるようになりました。

ユーザーへの恩恵

不安定なネットワーク環境や非常に長い思考を伴うタスクにおいて、セッションが不意に切断されるのを防ぎ、開発作業の中断を最小限に抑えることができます。

関連ドキュメント