環境変数

CLAUDE_CODE_OVERLOADED_RETRY_BASE_DELAY_MS

APIが529（過負荷）エラーでリクエストを拒否した際の自動再試行間の指数バックオフの開始遅延をミリ秒で指定します（デフォルトの500の代わり）。APIが高負荷の際にこれを引き上げると、再試行をより長い時間窓に分散させられます。500〜32000の整数ミリ秒をプレーンな数字で指定し、それ以外の値は未設定として扱われます。CLAUDE_CODE_RETRY_WATCHDOGが1に設定されている場合や、拒否されたリクエストがfast modeで送信された場合は効果がありません。Claude Code v2.1.292以降が必要です

使い方・用途

  • 529（過負荷）エラー時の再試行バックオフのベース遅延を調整する環境変数で、デフォルトは500ms
  • 500〜32000msの範囲で指定し、APIが高負荷の際に再試行をより長い時間窓に分散させて回復率を高められる
  • CLAUDE_CODE_RETRY_WATCHDOGが1に設定されている場合やfast modeのリクエストには効果がなく、v2.1.292以降が必要
英語原文(公式ドキュメントより)

Starting delay in milliseconds, in place of the default 500, of the exponential backoff between automatic retries of a request that the API rejects with a 529 overloaded error. Raise it to spread the retries over a longer window when the API is at capacity. Give whole milliseconds from 500 to 32000 in plain digits; Claude Code treats any other value as unset. Has no effect when CLAUDE_CODE_RETRY_WATCHDOG is set to 1, or when the rejected request was sent in fast mode. Requires Claude Code v2.1.292 or later

関連ドキュメント

関連する変更履歴

v2.1.292(1件)

Added
過負荷 (529) のリクエストを再試行する際のバックオフの基本遅延を長く設定できる環境変数 CLAUDE_CODE_OVERLOADED_RETRY_BASE_DELAY_MS を追加した
英語原文を表示
Added CLAUDE_CODE_OVERLOADED_RETRY_BASE_DELAY_MS environment variable to set a longer base delay for the backoff when retrying an overloaded (529) request

変更後

API が高負荷 (529) の場合でも、リトライの待ち時間の基準値を長く設定できるようになり、リトライ間隔をより広げて再試行できる。

関連ドキュメント