# --betas Flag

> It turns on API features that are still in testing.

**Field:** Artificial Intelligence  
**Category:** Claude Code  
**Also known as:** claude --betas, Beta headers

## Think of it like

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

## 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

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.

## Example code

```bash
claude --betas interleaved-thinking
```

Send one beta header with each request.

## Why it matters

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

## Common mistake

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

## Three principles

- **Beta headers.** One per feature.
- **API key only.** Not a Claude plan.
- **Still in testing.** Can change.

## Related terms

- [API Key](https://learn.benibix.com/term/development/api-key)
- [Claude Code Model Alias](https://learn.benibix.com/term/ai/claude-code-model-alias)

## Told apart from

- [--betas vs ANTHROPIC_BETAS](https://learn.benibix.com/compare/betas-flag-vs-anthropic-betas-variable): People think the --betas flag and the ANTHROPIC_BETAS variable are one switch in two places. Both add anthropic-beta headers, but they reach different runs. The flag lasts for one run, and it only works when you sign in with an API key. The variable lasts for each session that sees it, and it works with any sign-in, a plan too. On a plan, only the variable works.

## Taught in

- [Tool and Settings Flags](https://learn.benibix.com/learn/ai-claude-code-commands/tool-and-settings-flags): Claude Code Commands, 15/17

---

Source: https://learn.benibix.com/term/ai/betas-flag
Author: Behnia Zarei (a developer in Vienna, Austria, who builds and teaches data, AI and business intelligence at BENIBIX)
Publisher: BENIBIX Learn (https://learn.benibix.com/)
Last updated: 2026-11-16
Licence: CC BY 4.0 (https://creativecommons.org/licenses/by/4.0/). Quote freely with attribution.
