環境変数

CLAUDE_CODE_OVERLOADED_RETRY_MAX_DELAY_MS

API が 529 過負荷エラーで拒否したリクエストの自動再試行間の指数バックオフに対する上限(ミリ秒)で、デフォルトの 32000 を置き換えます。API が高負荷の間に後続の再試行間隔が広がり続けるようにするには、この値を引き上げます。32000〜64000 の整数ミリ秒をプレーンな数字で指定し、それ以外の値は未設定として扱われます。CLAUDE_CODE_RETRY_WATCHDOG が 1 に設定されている場合や、拒否されたリクエストが fast モードで送信された場合は効果がありません。Claude Code v2.1.296 以降が必要です。

使い方・用途

  • 529 過負荷エラー時の再試行バックオフの最大遅延を調整する(デフォルト: 32000ms)
  • API が長時間高負荷の状態でも、再試行をより広い時間帯に分散させて過負荷による失敗を減らせる
  • 指定可能な範囲は 32000〜64000 ミリ秒。CLAUDE_CODE_RETRY_WATCHDOG=1 設定時や fast モードのリクエストには無効
  • 有効化には Claude Code v2.1.296 以降が必要
英語原文(公式ドキュメントより)

Ceiling in milliseconds, in place of the default 32000, on the exponential backoff between automatic retries of a request that the API rejects with a 529 overloaded error. Raise it so that later retries keep spreading apart when the API is at capacity. Give whole milliseconds from 32000 to 64000 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.296 or later

関連ドキュメント

関連する変更履歴

v2.1.296(1件)

Added
オーバーロード(529)となったリクエストをリトライする際のバックオフ最大遅延時間を長めに設定できる環境変数 CLAUDE_CODE_OVERLOADED_RETRY_MAX_DELAY_MS を追加した
英語原文を表示
Added CLAUDE_CODE_OVERLOADED_RETRY_MAX_DELAY_MS environment variable to set a longer maximum delay for the backoff when retrying an overloaded (529) request

変更後

API が過負荷 (529) エラーを返した際のリトライ間隔の最大値を最長 64 秒まで引き上げられるようになり、混雑時により長い間隔でリトライを続けられる。バックオフが上限に達して以降は固定間隔になってしまう状況を避けたいときに設定できる。

関連ドキュメント