Skip to content
BENIBIX Learn

CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS

AI⌨️ Claude CodeConfiguration

Also known as CLAUDE_CODE_DISABLE_STRUCTURED_OUTPUTS

Set to 1, it strips pre-release betas from each request.

Think of it like

It is like you peel the new stickers off a toy. Then it fits in the old box.

Example

Jack's gateway says Extra inputs are not permitted on every call. He sets this, and the calls go through.

Why it matters

Strict gateways reject fields they do not know. This makes the requests plain enough to pass.

Definition

CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS set to 1 takes the beta headers out of each request. Their fields go too. Use it when a gateway fails with an error about them. Some features then stop, such as tool search. A second one, for structured output, takes out just that beta.

Example code

bash
export CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1
claude
Send only plain requests to a strict gateway.

Common mistake

Leaving it on after the gateway is fixed. You keep losing the beta features for no reason.

Key takeaways

  1. 1
    Strips betas. Headers and fields.
  2. 2
    For strict gateways. Unexpected value errors.
  3. 3
    Some features stop. Such as tool search.