環境変数

CLAUDE_CODE_RETRY_WATCHDOG

評価ハーネス、CIジョブ、またはリモートワーカーなどの無人セッション向けに、429や529エラーを無制限にリトライするように設定します。

使い方・用途

  • CI/CDパイプラインなどの自動実行環境において、レート制限や一時的なサーバー負荷による失敗を防ぎ、成功するまでバックオフを取りながら待機させます。
  • CLAUDE_CODE_MAX_RETRIESの設定にかかわらず、リミットが解除されるまでリトライを継続させたい場合に有効です。
英語原文(公式ドキュメントより)

Set to 1 for unattended sessions such as eval harnesses, CI jobs, or remote workers. Retries 429 and 529 capacity errors indefinitely instead of failing after CLAUDE_CODE_MAX_RETRIES attempts. The watchdog backs off up to 5 minutes between attempts, or until the limit resets when the response carries a rate-limit reset time, so a session that hits a usage limit waits out the remaining window. Requires Claude Code v2.1.186 or later

関連する変更履歴

v2.1.186(1件)

Changed
Settings
CLAUDE_CODE_MAX_RETRIES の上限が15回に変更されました。無人セッションでの利用には、代わりに CLAUDE_CODE_RETRY_WATCHDOG の使用が推奨されます。
英語原文を表示
Changed CLAUDE_CODE_MAX_RETRIES to cap at 15; for unattended sessions, use CLAUDE_CODE_RETRY_WATCHDOG instead

変更前

リトライ回数を過剰に設定できていたため、接続障害時にプロセスが長時間停止してしまうことがありました。

変更後

リトライ回数に適切な上限が設けられ、より堅牢な監視メカニズムであるウォッチドッグの利用が促されるようになりました。

ユーザーへの恩恵

エラー時の挙動が予測可能になり、特に自動化スクリプトなどでの信頼性が向上します。

関連ドキュメント