環境変数

CLAUDE_CODE_RETRY_WATCHDOG_MAX_WAIT_MS

CLAUDE_CODE_RETRY_WATCHDOGが設定されている場合に、各APIリクエストが429および529エラーの待機（バックオフ）に費やす最大時間をミリ秒で指定します。この時間を使い切ると、次に発生した同種のエラーでリクエストは終了します。1800000（30分）のような正の整数をプレーンな数字で指定します。未設定の場合は待機に上限がなく、Claude Code v2.1.295以降が必要です

使い方・用途

  • 無人リトライモード（CLAUDE_CODE_RETRY_WATCHDOG）による429/529容量エラーの無限待機に時間的上限を設ける環境変数
  • CIジョブなど無人実行で、容量エラーによる長時間滞留を防ぎたい場合にミリ秒単位で上限を指定する
  • 未設定なら待機は無制限のまま。v2.1.295以降が必要
英語原文(公式ドキュメントより)

Maximum time in milliseconds that each API request spends waiting out 429 and 529 errors when CLAUDE_CODE_RETRY_WATCHDOG is set. Once that time is spent, the next such error ends the request. Give a positive whole number in plain digits, such as 1800000 for 30 minutes. When unset, the wait has no limit. Requires Claude Code v2.1.295 or later

関連する変更履歴

v2.1.295(1件)

Added
無人リトライモード(CLAUDE_CODE_RETRY_WATCHDOG)が 429 と 529 エラーで待機できる時間を制限する CLAUDE_CODE_RETRY_WATCHDOG_MAX_WAIT_MS を追加
英語原文を表示
Added CLAUDE_CODE_RETRY_WATCHDOG_MAX_WAIT_MS to limit how long unattended retry mode (CLAUDE_CODE_RETRY_WATCHDOG) waits out 429 and 529 errors

変更後

CI ジョブなどの無人セッションでリトライ待機時間が無制間に長引く代わりに、上限を設定して待機時間を制御できるようになる。

関連ドキュメント