# model Setting

> The key that sets which model a new session starts on.

**Field:** Artificial Intelligence  
**Category:** Claude Code  
**Also known as:** "model" key, Claude Code default model

## Think of it like

It is like your usual order at a cafe. You get it unless you ask for something else.

## Definition

The model setting sets the model every new Claude Code session starts on, so you do not have to pick one with /model each time. It takes an alias, such as sonnet, or a full model ID. You can still switch in a session. The --model flag and the ANTHROPIC_MODEL variable both win over it for one session.

## Example

Jack always switched to Opus at the start of a session. He sets model in his user file, and now it starts there.

## Example code

```json
{
  "model": "opus"
}
```

Start every session on Opus.

## Why it matters

It saves a step each time, and a team file can set one model for all.

## Common mistake

Setting it and still getting another model. A flag, a variable or a higher file may set one too.

## Three principles

- **Starting model.** Each new session.
- **Alias or full ID.** sonnet, opus.
- **Flags win.** For one session.

## Related terms

- [availableModels](https://learn.benibix.com/term/ai/available-models-setting)
- [/model Command](https://learn.benibix.com/term/ai/model-command)
- [ANTHROPIC_MODEL](https://learn.benibix.com/term/ai/anthropic-model-variable)

## Told apart from

- [model vs availableModels](https://learn.benibix.com/compare/model-setting-vs-available-models-setting): People think model limits which models can be used. It only picks the one a session starts on, and you can switch. availableModels is the list anyone may pick from at all. Set in managed settings, it holds against the model key, the flag and /model.

![How Claude Code picks the model a session starts on: the first source that names one wins, then availableModels must allow it.](https://learn.benibix.com/diagrams/settings-model-choice.svg)

---

Source: https://learn.benibix.com/term/ai/model-setting
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-17
Licence: CC BY 4.0 (https://creativecommons.org/licenses/by/4.0/). Quote freely with attribution.
