Skip to content
BENIBIX Learn

--betas Flag

Also known as claude --betas, Beta headers

It turns on API features that are still in testing.

Think of it like

It is like you try a new toy before it is in the shops.

Example

Lucy reads that a new API feature is in beta. She signs in with her API key and starts claude --betas with its name to try it.

Why it matters

You can try a new feature early. You do not have to wait for it to be the default.

Definition

--betas adds beta headers to the requests Claude Code sends to the API, to try a feature that is still being tested. Each header turns on one feature by name, such as interleaved-thinking. It only works when you sign in with an API key, not with a Claude plan.

Example code

bash
claude --betas interleaved-thinking
Send one beta header with each request.

Common mistake

Using it while signed in with a Claude plan. It only works with an API key.

Key takeaways

  1. 1
    Beta headers. One per feature.
  2. 2
    API key only. Not a Claude plan.
  3. 3
    Still in testing. Can change.

Compare

Learn it properly