CLAUDE_CODE_DISABLE_NONSTREAMING_FALLBACK

Updated October 13, 2026 by Alex Sorokoletov

CLAUDE_CODE_DISABLE_NONSTREAMING_FALLBACK is a Claude Code environment variable: Disables the fallback path that retries failed streaming requests as non-streaming calls. The changelog explicitly documents this variable. Added between v2.1.79 and v2.1.83 and still present in v2.1.294. It is listed in the official reference.

How to set it

For one session, export it in the shell that starts Claude Code:

export CLAUDE_CODE_DISABLE_NONSTREAMING_FALLBACK=<value>
claude

To apply it to every session, add it to the env object of a settings file:

// ~/.claude/settings.json
{
  "env": {
    "CLAUDE_CODE_DISABLE_NONSTREAMING_FALLBACK": "<value>"
  }
}

Release notes that mention it

• Claude Code v2.1.83 — 8 New Environment Variables: Security Hardening and the 40-Fix Mega Release
• Claude Code Version Tracker: Undocumented Env Vars, Feature Gates & Models

Related variables

• CLAUDE_CODE_DISABLE_DANGEROUS_RM_TIMEOUT
• CLAUDE_CODE_DISABLE_MEMORY_STREAM_LIST: Turns off the incremental metadata-streaming path inside multi-store memory sync.
• CLAUDE_CODE_DISABLE_MTLS_RELOAD_ON_STALE_CONNECTION
• CLAUDE_CODE_NONSTREAMING_TIMEOUT_RETRIES: Caps how many times a timed-out non-streaming fallback request is re-sent.
• CLAUDE_CODE_DISABLE_REFUSAL_RETRY
• ANTHROPIC_BASE_URL: Custom endpoint for Anthropic services.
• API_FORCE_IDLE_TIMEOUT
• API_TIMEOUT_MS: Request timeout in milliseconds.

Frequently asked questions

All variables, searchable: Claude Code environment variables.