II.
RetryPolicy overview
Reference · liveretry-policy:claude-code-default
Claude Code default API retry policy overview
Default policy for the claude-code withRetry generator. Exponential backoff with ~25% jitter, server Retry-After overrides computed delay. 529 overload retries are gated to user-blocking foreground sources only — background sources bail immediately to avoid capacity-cascade amplification. After MAX_529_RETRIES consecutive 529s on a foreground source, escalate to fallback model via FallbackTriggeredError.
Attributes
displayName
Claude Code default API retry policy
variant
default
maxRetries
10
maxRetriesOnOverload
3
baseDelayMs
500
maxDelayMs
32000
backoffStrategy
exponential-jitter
jitterFactor
0.25
honorRetryAfterHeader
true
floorOutputTokens
3000
retryableStatusCodes
- 408
- 409
- 429
- 500
- 502
- 503
- 504
- 529
foregroundOnlyOnOverload
true
foregroundSources
- repl_main_thread
- sdk
- agent:custom
- agent:default
- agent:builtin
- compact
- hook_agent
- hook_prompt
- verification_agent
- side_question
- auto_mode
triggersFallbackModelOn
repeated-overload
clearsAuthCacheOn
- 401
- 403
disablesKeepAliveOn
- ECONNRESET
- EPIPE
description
Default policy for the claude-code withRetry generator. Exponential backoff
with ~25% jitter, server Retry-After overrides computed delay. 529 overload
retries are gated to user-blocking foreground sources only — background
sources bail immediately to avoid capacity-cascade amplification. After
MAX_529_RETRIES consecutive 529s on a foreground source, escalate to
fallback model via FallbackTriggeredError.
Outgoing edges
has_retry_policy_variant3
- retry-policy:claude-code-background-bail·RetryPolicyClaude Code background-source bail-on-overload policy
- retry-policy:claude-code-fast-mode·RetryPolicyClaude Code fast-mode retry policy
- retry-policy:claude-code-persistent-unattended·RetryPolicyClaude Code persistent (unattended) retry policy
Incoming edges
client_uses_retry_policy2
- transport-client:claude-code-anthropic-direct·TransportClientClaude Code Anthropic-direct transport client
- transport-client:claude-code-bedrock·TransportClientClaude Code Bedrock transport client