# ANTHROPIC_DEFAULT_OPUS_MODEL

> It sets which full model the alias opus stands for.

**Field:** Artificial Intelligence  
**Category:** Claude Code  
**Also known as:** ANTHROPIC_DEFAULT_SONNET_MODEL, ANTHROPIC_DEFAULT_HAIKU_MODEL, ANTHROPIC_DEFAULT_FABLE_MODEL, ANTHROPIC_SMALL_FAST_MODEL

## Think of it like

It is like you tell the shop that small means your own cup size.

## Definition

ANTHROPIC_DEFAULT_OPUS_MODEL sets which full model the alias opus stands for. Its siblings do the same for sonnet, haiku and fable. In plan mode, opusplan uses the Opus pin. Out of it, it uses the Sonnet pin. The Haiku pin also runs jobs in the back. Each value must be a full model name, or the ID your provider uses.

## Example

Emma's team uses Claude on Bedrock, where model names look different. She pins each alias once. Then opus and sonnet work as usual for all of them.

## Example code

```bash
export ANTHROPIC_DEFAULT_OPUS_MODEL=us.anthropic.claude-opus-5-5-v1:0
claude --model opus
```

Make opus mean your Bedrock model.

## Why it matters

On a cloud or a gateway, it keeps the short names tied to the IDs your account has.

## Common mistake

Thinking it sets the model. It only says what opus means. Something still has to pick opus.

## Three principles

- **One per alias.** opus, sonnet, haiku, fable.
- **Full name or ID.** Not an alias.
- **opusplan uses two.** Opus to plan, Sonnet to work.

## Related terms

- [Claude Code Model Alias](https://learn.benibix.com/term/ai/claude-code-model-alias)
- [ANTHROPIC_MODEL](https://learn.benibix.com/term/ai/anthropic-model-variable)
- [Amazon Bedrock](https://learn.benibix.com/term/ai/amazon-bedrock)
- [ANTHROPIC_DEFAULT_OPUS_MODEL_NAME](https://learn.benibix.com/term/ai/anthropic-default-opus-model-name-variable)

## Told apart from

- [ANTHROPIC_MODEL vs ANTHROPIC_DEFAULT_OPUS_MODEL](https://learn.benibix.com/compare/anthropic-model-variable-vs-anthropic-default-opus-model-variable): People think ANTHROPIC_DEFAULT_OPUS_MODEL makes Claude Code run on Opus. It does not pick a model at all. It only says which full model the short name opus stands for. ANTHROPIC_MODEL is what picks the model a session starts on. So on a cloud you often set both. The pin says what opus means there, and the other says to use it.

![Each alias reads one variable to find the model it stands for.](https://learn.benibix.com/diagrams/env-model-pins.svg)

---

Source: https://learn.benibix.com/term/ai/anthropic-default-opus-model-variable
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.
