環境変数

CLAUDE_CODE_RETRY_WATCHDOG_USAGE_LIMIT_RECHECK_MS

CLAUDE_CODE_RETRY_WATCHDOG を設定してリクエストが利用制限のリセットを待っている間に、その制限がすでに解除されていないかを確認する最小間隔をミリ秒単位で指定する。確認で制限解除が判明すると、リクエストは即座に送信される。60000(1 分)から 10800000(3 時間)までの、プレーンな数字による整数を指定する。確認は、利用クレジットを使用していない claude.ai サブスクリプションのセッション制限または週次制限に対してのみ行われ、CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC が設定されている間は行われない。この変数が未設定または値が範囲外の場合、確認は行われない。Claude Code v2.1.305 以降が必要である。

使い方・用途

  • 無人実行セッションで CLAUDE_CODE_RETRY_WATCHDOG によりセッション上限や週間上限のリセット待ちをしている間に、上限が予定より早く解除されたことに気づいてすぐリクエストを再送したいときに使える。
  • リセット時刻まで待ち続ける代わりに一定間隔で上限解除を再確認させることで、CI ジョブなど長時間の無人実行でクレジット未使用中の利用上限解除後にすぐ処理を再開させたいときに使える。
英語原文(公式ドキュメントより)

Minimum interval in milliseconds between checks of whether a usage limit was already lifted, while a request waits for that limit to reset with CLAUDE_CODE_RETRY_WATCHDOG set. When a check finds the limit lifted, the request goes out at once. Give a whole number in plain digits from 60000, one minute, to 10800000, three hours. Checks are made only for a claude.ai subscription's session or weekly limit while usage credits aren't in use, and not while CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC is set. When this variable is unset or its value is outside that range, no checks are made. Requires Claude Code v2.1.305 or later

関連ドキュメント

関連する変更履歴

v2.1.305(1件)

Added
CLAUDE_CODE_RETRY_WATCHDOG_USAGE_LIMIT_RECHECK_MS を追加した。これにより無人リトライモード（CLAUDE_CODE_RETRY_WATCHDOG）が、リセット前に解除された使用量制限を検知できるようになる。
英語原文を表示
Added CLAUDE_CODE_RETRY_WATCHDOG_USAGE_LIMIT_RECHECK_MS so unattended retry mode (CLAUDE_CODE_RETRY_WATCHDOG) notices a usage limit that was lifted before its reset

変更後

無人実行向けのリトライモード(CI ジョブなど)でも、セッション制限などの使用上限がリセット時刻を待たずに解除されたことを検知できるようになり、解除のタイミングで待機を終えて処理を再開できる。

関連ドキュメント