失敗した API リクエストのリトライ回数を上書きする(既定値:10)。リトライは 529 過負荷エラーが続いた場合に早めに停止することがある。たとえば Opus モデルで API キーを使用している場合、3 回目の 529 で停止し、Repeated 529 Overloaded errors を表示する。フォールバックモデルを設定している場合、エラーを表示する代わりにそのモデルへ切り替わる。v2.1.186 以降は上限が 15 に制限され、v2.1.199 以降では CLAUDE_CODE_RETRY_WATCHDOG が既定値を引き上げ、この上限を撤廃する。より長い障害に耐えて待機する必要のある無人セッションでは、代わりに CLAUDE_CODE_RETRY_WATCHDOG を設定すること。
claude_code.api_error イベントまでの挙動を調整し、障害発生時に監視や通知へ確実に終端シグナルを渡したい場合に設定する。Override the number of times to retry failed API requests (default: 10). Retrying can stop earlier on 529 overloaded errors. For example, with an API key on an Opus model, it stops at the third 529 and shows Repeated 529 Overloaded errors. If you set a fallback model, Claude Code switches to that model rather than showing the error. Capped at 15 as of v2.1.186; as of v2.1.199, CLAUDE_CODE_RETRY_WATCHDOG raises the default and removes the cap. For unattended sessions that need to wait through longer outages, set CLAUDE_CODE_RETRY_WATCHDOG instead
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変更後
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変更後
エラー時の挙動が予測可能になり、特に自動化スクリプトなどでの信頼性が向上します。