Answer: You tune retry behavior with environment variables such as CLAUDE_CODE_MAX_RETRIES (default 10) and CLAUDE_CODE_RETRY_WATCHDOG (unset by default). Status: Confirmed Entry: tool/claude-code/settings/tune-retry-behavior Revision: 2 Digest: sha256:fa1f037b511a4b5a (changes whenever the content changes) Timeline: Created: 2026-11-13T03:04:06Z Last changed: 2026-11-13T12:10:17Z (API_TIMEOUT_MS default: — → 600000) Last verified: 2026-11-20T12:20:34Z Next check: 2026-11-21T12:20:34Z Check interval: Daily Expected change: No fixed schedule Data: Field | Value | Unit | Source | As of CLAUDE_CODE_MAX_RETRIES default | 10 | retry attempts | [1] | 2026-11-20 CLAUDE_CODE_RETRY_WATCHDOG default | unset | | [1] | 2026-11-20 CLAUDE_CODE_OVERLOADED_RETRY_BASE_DELAY_MS default | 500 | milliseconds | [1] | 2026-11-20 CLAUDE_CODE_OVERLOADED_RETRY_MAX_DELAY_MS default | 32000 | milliseconds | [1] | 2026-11-20 API_TIMEOUT_MS default | 600000 | milliseconds | [1] | 2026-11-20 Sources: [1] Anthropic. "Error reference". https://code.claude.com/docs/en/errors.md Role: primary. Accessed: 2026-11-20T12:20:34Z Quote: "| [`CLAUDE_CODE_MAX_RETRIES`](https://code.claude.com/docs/en/env-vars) | 10 | Number of retry attempts." (Supports: CLAUDE_CODE_MAX_RETRIES default) Quote: "| [`CLAUDE_CODE_RETRY_WATCHDOG`](https://code.claude.com/docs/en/env-vars) | unset | Set to `1` in unattended sessions" (Supports: CLAUDE_CODE_RETRY_WATCHDOG default) Quote: "| [`CLAUDE_CODE_OVERLOADED_RETRY_BASE_DELAY_MS`](https://code.claude.com/docs/en/env-vars) | 500 | Starting delay in milliseconds" (Supports: CLAUDE_CODE_OVERLOADED_RETRY_BASE_DELAY_MS default) Quote: "| [`CLAUDE_CODE_OVERLOADED_RETRY_MAX_DELAY_MS`](https://code.claude.com/docs/en/env-vars) | 32000 | Ceiling in milliseconds" (Supports: CLAUDE_CODE_OVERLOADED_RETRY_MAX_DELAY_MS default) Quote: "| [`API_TIMEOUT_MS`](https://code.claude.com/docs/en/env-vars) | 600000 | Time in milliseconds" (Supports: API_TIMEOUT_MS default) Published: 2026-11-20T10:25:18Z Snapshot SHA-256: c9ad601aff1e6a50d95382b7c498d9da861c091898ac54ec614418bd376887f4 (captured 2026-11-20T12:20:34Z) Verification: Method: Automated extraction from [1] with deepseek-flash (JSON output, thinking disabled). Every value was checked by code to appear verbatim in a quoted passage of [1]. Cross-check: not-available at 2026-11-20T12:20:34Z. No independent second source is configured for this entry Last successful check: 2026-11-20T12:20:34Z Last attempt: 2026-11-20T12:20:34Z Notes and limitations: Extracted automatically from a single official source (section "Tune retry behavior"). Related: https://latestn.com/tool/claude-code/settings/turn-off-agent-view How do I turn off agent view in Claude Code? https://latestn.com/tool/claude-code/settings/turn-off-one-step-updates How do I turn off one-step artifact updates in Claude Code? https://latestn.com/tool/claude-code/settings/turn-workflows-on-off How do I turn dynamic workflows on or off in Claude Code? https://latestn.com/tool/claude-code/settings/switch-back-to-default-renderer How do I switch Claude Code back to the default renderer from fullscreen? https://latestn.com/tool/claude-code/settings/team-settings-example What does a Claude Code team settings.json file look like? https://latestn.com/tool/claude-code/settings/terminal-bell-notification How do I get a terminal bell or notification when Claude Code finishes a task? https://latestn.com/tool/ All entries in AI tools Change log: Time | Event | Change | Source 2026-11-13T12:10:17Z | changed | API_TIMEOUT_MS default: — → 600000 | [1] 2026-11-13T12:10:17Z | changed | CLAUDE_CODE_OVERLOADED_RETRY_MAX_DELAY_MS default: — → 32000 | [1] 2026-11-13T12:10:17Z | changed | CLAUDE_CODE_OVERLOADED_RETRY_BASE_DELAY_MS default: — → 500 | [1] 2026-11-13T12:10:17Z | changed | CLAUDE_CODE_RETRY_WATCHDOG default: — → unset | [1] 2026-11-13T12:10:17Z | changed | CLAUDE_CODE_MAX_RETRIES default: — → 10 | [1] 2026-11-13T12:10:17Z | changed | API timeout default: 600000 → — | [1] 2026-11-13T12:10:17Z | changed | Overloaded max delay default: 32000 → — | [1] 2026-11-13T12:10:17Z | changed | Overloaded base delay default: 500 → — | [1] 2026-11-13T12:10:17Z | changed | Watchdog default retry count: 300 → — | [1] 2026-11-13T12:10:17Z | changed | Watchdog variable: CLAUDE_CODE_RETRY_WATCHDOG → — | [1] 2026-11-13T12:10:17Z | changed | Retry cap: 15 → — | [1] 2026-11-13T12:10:17Z | changed | Default retry attempts: 10 → — | [1] 2026-11-13T12:10:17Z | changed | Max retries variable: CLAUDE_CODE_MAX_RETRIES → — | [1] 2026-11-13T03:04:06Z | added | Entry created | — Changes for this entry as a feed: https://latestn.com/tool/claude-code/settings/tune-retry-behavior/latest Challenge this entry: Open challenges: None How: If a value here is wrong or out of date, send what is wrong and a link to evidence. Challenges are queued and checked against the evidence; they do not change the entry by themselves. If the entry changes as a result, the change log says so. Form: https://latestn.com/dispute/tool/claude-code/settings/tune-retry-behavior POST: https://latestn.com/dispute/tool/claude-code/settings/tune-retry-behavior with claim, evidence_url, and optionally field and contact (form-encoded or JSON) GET: https://latestn.com/dispute/tool/claude-code/settings/tune-retry-behavior?claim={what is wrong}&evidence_url={link} How to cite: LatestN. (2026). How do I tune or change Claude Code's automatic retry behavior? Revision 2, last verified 2026-11-20T12:20:34Z. https://latestn.com/tool/claude-code/settings/tune-retry-behavior (accessed 2026-11-21T09:54:54Z). @misc{LatestN_tool_claude_code_settings_tune_retry_behavior_r2, title = {How do I tune or change Claude Code's automatic retry behavior?}, author = {{LatestN}}, year = {2026}, howpublished = {\url{https://latestn.com/tool/claude-code/settings/tune-retry-behavior}}, note = {Revision 2; digest sha256:fa1f037b511a4b5a; last verified 2026-11-20T12:20:34Z; accessed 2026-11-21T09:54:54Z} } Reuse: License: CC BY 4.0 (https://creativecommons.org/licenses/by/4.0/) Attribution: Copying and adapting are allowed, including commercially, if you credit LatestN and link to the entry you used. Each entry ends with a ready-made citation. URL: https://latestn.com/tool/claude-code/settings/tune-retry-behavior