CLAUDE_CODE_MAX_RETRIES
Updated by Alex Sorokoletov
CLAUDE_CODE_MAX_RETRIES is a Claude Code environment variable: Maximum API request retries. Present since v2.1.69 or earlier and still present in v2.1.310. It is listed in the official reference.
| Status | Present in v2.1.310 |
|---|---|
| Added | Present since v2.1.69 or earlier |
| Category | Network and proxy |
| Official docs | Listed |
How to set it
For one session, export it in the shell that starts Claude Code:
export CLAUDE_CODE_MAX_RETRIES=<value>
claudeTo apply it to every session, add it to the env object of a settings file:
// ~/.claude/settings.json
{
"env": {
"CLAUDE_CODE_MAX_RETRIES": "<value>"
}
}Release notes that mention it
Related variables
MAX_STRUCTURED_OUTPUT_RETRIESBASH_MAX_TIMEOUT_MSCLAUDE_CODE_NONSTREAMING_TIMEOUT_RETRIES: Caps how many times a timed-out non-streaming fallback request is re-sent.CLAUDE_CODE_OVERLOADED_RETRY_MAX_DELAY_MS: Raises the ceiling on the backoff delay when retrying a request that returned a 529 overloaded response.CLAUDE_CODE_RETRY_WATCHDOG_MAX_USAGE_LIMIT_WAIT_MS: Bounds how long unattended retry mode (CLAUDE_CODE_RETRY_WATCHDOG) waits for a usage-limit reset.CLAUDE_CODE_RETRY_WATCHDOG_MAX_WAIT_MS: Caps the total time unattended retry mode (CLAUDE_CODE_RETRY_WATCHDOG) waits through 429 and 529 responses.ANTHROPIC_BASE_URL: Custom endpoint for Anthropic services.API_FORCE_IDLE_TIMEOUT
Frequently asked questions
What does CLAUDE_CODE_MAX_RETRIES do?
Maximum API request retries
Which Claude Code version has CLAUDE_CODE_MAX_RETRIES?
Present since v2.1.69 or earlier and still present in v2.1.310.
How do I set CLAUDE_CODE_MAX_RETRIES?
Export it before starting Claude Code (export CLAUDE_CODE_MAX_RETRIES=value), or add it to the "env" object in ~/.claude/settings.json to apply it to every session.
All variables, searchable: Claude Code environment variables.