Skip to content
BENIBIX Learn

CLAUDE_CODE_DISABLE_NONSTREAMING_FALLBACK

AI⌨️ Claude CodeConfiguration

Also known as CLAUDE_CODE_DISABLE_NONSTREAMING_FALLBACK=1

Set to 1, it stops the one-piece retry when a stream breaks.

Think of it like

It is like you stop a waiter from bringing a dish twice.

Example

Emma saw the same file written twice after a dropped stream. Her proxy had made the retry repeat the tool call. This fixed it.

Why it matters

Running a tool twice can do real harm, such as sending a message twice.

Definition

CLAUDE_CODE_DISABLE_NONSTREAMING_FALLBACK set to 1 turns off a retry. Claude Code makes it when a stream breaks halfway. It asks again for the whole answer in one piece. Behind some proxies, that retry runs a tool twice. This stops it.

Example code

bash
export CLAUDE_CODE_DISABLE_NONSTREAMING_FALLBACK=1
claude
Stop double tool runs behind a proxy.

Common mistake

Setting it with no proxy trouble. Then a broken stream just fails, with no retry to save it.

Key takeaways

  1. 1
    Stream breaks. Is when it acts.
  2. 2
    No one-piece retry. When set.
  3. 3
    Stops double runs. Behind proxies.