Skip to content
BENIBIX Learn

model Setting

AI⌨️ Claude CodeConfiguration

Also known as "model" key, Claude Code default model

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

Think of it like

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

Example

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

Why it matters

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

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 code

json
{
  "model": "opus"
}
Start every session on Opus.
The first source that names a model wins.

Common mistake

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

Key takeaways

  1. 1
    Starting model. Each new session.
  2. 2
    Alias or full ID. sonnet, opus.
  3. 3
    Flags win. For one session.

Compare