CLAUDE_CODE_OVERLOADED_RETRY_MAX_WAIT_MS
Updated by Alex Sorokoletov
CLAUDE_CODE_OVERLOADED_RETRY_MAX_WAIT_MS is a Claude Code environment variable: Maximum wait in milliseconds before retrying after an overloaded response; used only on the main request when neither the max-retries nor retry-watchdog variables are set and a server-side setting is on. Added between v2.1.321 and v2.1.323 and still present in v2.1.324. It is not in the official reference.
| Status | Present in v2.1.324 |
|---|---|
| Added | Added between v2.1.321 and v2.1.323 |
| Category | Network and proxy |
| Official docs | Not listed |
How to set it
For one session, export it in the shell that starts Claude Code:
export CLAUDE_CODE_OVERLOADED_RETRY_MAX_WAIT_MS=<value>
claudeTo apply it to every session, add it to the env object of a settings file:
// ~/.claude/settings.json
{
"env": {
"CLAUDE_CODE_OVERLOADED_RETRY_MAX_WAIT_MS": "<value>"
}
}Related variables
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.CLAUDE_CODE_OVERLOADED_RETRY_BASE_DELAY_MS: Sets the base delay, in milliseconds, for the backoff when a request comes back overloaded (HTTP 529).BASH_MAX_TIMEOUT_MSCLAUDE_CODE_DISABLE_REFUSAL_RETRY: When set, disables the automatic retry of a response that stopped with a refusal.CLAUDE_CODE_MAX_RETRIES: Maximum API request retries.CLAUDE_CODE_RETRY_WATCHDOG: Tunes the retry watchdog that detects API calls silently looping without progress.
Frequently asked questions
What does CLAUDE_CODE_OVERLOADED_RETRY_MAX_WAIT_MS do?
Maximum wait in milliseconds before retrying after an overloaded response; used only on the main request when neither the max-retries nor retry-watchdog variables are set and a server-side setting is on.
Which Claude Code version has CLAUDE_CODE_OVERLOADED_RETRY_MAX_WAIT_MS?
Added between v2.1.321 and v2.1.323 and still present in v2.1.324.
How do I set CLAUDE_CODE_OVERLOADED_RETRY_MAX_WAIT_MS?
Export it before starting Claude Code (export CLAUDE_CODE_OVERLOADED_RETRY_MAX_WAIT_MS=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.