評価ハーネス、CIジョブ、またはリモートワーカーなどの無人セッション向けに、429や529エラーを無制限にリトライするように設定します。
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
CLAUDE_CODE_RETRY_WATCHDOG now raises the default retry count for non-capacity transient errors to 300 and lifts the cap of 15 on CLAUDE_CODE_MAX_RETRIES変更前
通信エラー等の際、最大リトライ回数が 15 回に制限されており、一時的な障害でセッションが失敗しやすくなっていました。
変更後
非容量性のエラーに対しては最大 300 回まで自動リトライし、かつ上限を撤廃することで粘り強く接続を維持します。
ユーザーへの恩恵
CIやリモート環境などの自動化タスクが、一時的なネットワーク断絶で失敗する確率を大幅に減らせます。
CLAUDE_CODE_MAX_RETRIES の上限が15回に変更されました。無人セッションでの利用には、代わりに CLAUDE_CODE_RETRY_WATCHDOG の使用が推奨されます。CLAUDE_CODE_MAX_RETRIES to cap at 15; for unattended sessions, use CLAUDE_CODE_RETRY_WATCHDOG instead変更前
リトライ回数を過剰に設定できていたため、接続障害時にプロセスが長時間停止してしまうことがありました。
変更後
リトライ回数に適切な上限が設けられ、より堅牢な監視メカニズムであるウォッチドッグの利用が促されるようになりました。
ユーザーへの恩恵
エラー時の挙動が予測可能になり、特に自動化スクリプトなどでの信頼性が向上します。