Pick the right model and effort level in Claude Code
Choose between Claude Fable 5.1, Opus 5.5, Sonnet 5.5 and Haiku 5.5 in Claude Code, then set the effort for each task, in under 20 minutes.

What you need
On Amazon Bedrock, Google Cloud and Microsoft Foundry, some model names point to older models.
Step 1: Update Claude Code
3 minThe picker only lists models your version knows, so an old install hides the newest ones.
- New to Claude Code? On a Mac, Linux or WSL, run the command below. In Windows PowerShell, run
irm https://claude.ai/install.ps1 | iex. - Already installed? Run
claude update, orbrew upgrade claude-codeif you used Homebrew. - Open a new terminal window and run
claude --version. - In your project folder, run
claudeand log in when asked.
Mac, Linux or WSL: run thiscurl -fsSL https://claude.ai/install.sh | bash
You should see a version number of 2.1.293 or higher, then a Claude Code session open in your project.
Homebrew says you're up to date, but the new models are missing?
The
claude-codecask runs about a week behind. Installclaude-code@latest, or use the native installer, which updates itself.- New to Claude Code? On a Mac, Linux or WSL, run the command below. In Windows PowerShell, run
Step 2: Open the model picker
2 minOpus 5.5 is the default on every Claude plan and on the API, and the picker is where you change it.
- In your session, type
/modeland press Enter. - Pick a model. Press
Enterto switch and save it as your default, orsto switch for this session only. - Run
/statusto check which model is active.
You should see the model you picked in
/status, next to your account details.The Fable row says Requires usage credits?
Pro bills Fable to usage credits, not your plan's limits. Max includes Fable up to half your weekly limit.
Each model has its own cache, so the first message after a switch re-reads the whole chat. Switch at the start of a task.
- In your session, type
Step 3: Match the model to the task
3 minA lighter model on routine work saves your limit and money for jobs that need more depth.
- Not sure? Stay on
opus. Anthropic suggests Opus 5.5 for most work, including long agent runs. - Daily coding with a clear scope:
/model sonnetgives you Sonnet 5.5, faster and cheaper. - Simple tasks like a rename:
/model haikugives you Haiku 5.5, the fastest. /model opusplanplans with Opus in plan mode, then writes the code with Sonnet.
Type one/model opus /model sonnet /model haiku /model opusplan
You should see a switch to the model you named, which also becomes your default.
Your weekly limit runs out too fast?
Move routine work to Sonnet or Haiku. Claude's pricing page says how fast you hit a limit depends on the model.
API prices per million tokens in and out: Opus 5.5 is $4 and $20, Sonnet 5.5 is $2 and $10. Haiku 5.5 starts at $0.10 and $0.50, and Fable 5.1 is $10 and $50.
- Not sure? Stay on
Step 4: Set the effort level
3 minEffort sets how hard Claude thinks on each step, so it changes speed, cost and depth.
- Type
/effortto open the slider, or/effort highto set a level directly. - Use
lowfor quick edits,mediumfor clear feature work andhighwhen edge cases matter. - Save
maxfor hard problems you hand off. Test it first, since it can overthink. - For one deeper answer, put
ultrathinkanywhere in that prompt.
Type this/effort medium
You should see the level in the session header, for example "with medium effort".
Your
maxsetting is gone in a new session?Claude Code keeps
maxfor the current session only. To keep it, start withCLAUDE_CODE_EFFORT_LEVEL=max claude.Opus 5.5, Sonnet 5.5 and Haiku 5.5 start at
medium. Fable 5.1 starts athigh.- Type
Step 5: Hand Fable 5.1 your hardest task
5 minFable 5.1 is built for long, hard, open problems, so give it a goal rather than a script.
- Run
/model fable, or start a session withclaude --model fable. - If Claude Code asks you to approve usage credits, read the prompt and accept.
- Pick a task harder than one you'd give other models, such as a bug nobody has pinned down.
- Paste the prompt below, fill in the brackets and send it.
Your promptI'm working on [THE PROJECT] for [WHO IT'S FOR]. They need [WHAT THE RESULT LETS THEM DO]. Goal: [THE OUTCOME YOU WANT]. Scope the work first and ask me any questions you need. Then do it end to end. Before you report back, check each claim against a test or command you ran, and say what you couldn't verify.
You should see a few scoping questions, then a plan, then Fable working through the task on its own.
A notice says your request moved to another model?
Safety checks flagged it, most often for cybersecurity or biology. Cyber requests re-run on Opus 4.8, biology on Opus 5. Run
/model fableto switch back.To be asked before a switch, run
/config, select Switch models when a message is flagged and choose Ask each time.- Run
Step 6: Pin a model for the project
2 minA shared settings file starts the whole team on the same model and effort.
- In your project, open or create
.claude/settings.json. - Add the keys below, with your team's alias:
opus,sonnet,haikuoropusplan. - Commit the file so teammates get it.
- Start a new session and run
/status. TheSetting sourcesline should list the project file.
Your config{ "model": "opusplan", "effortLevel": "medium" }You should see new sessions in this project starting on the model and effort you set.
A new session still starts on another model?
Something higher up wins. A personal
.claude/settings.local.json, the--modelflag orANTHROPIC_MODELall override the project file.Settings files are strict JSON, so a comment or trailing comma breaks them.
- In your project, open or create
You get
Claude Code running the right model at the right effort for each task, with Fable 5.1 ready for the hardest ones
Try next
Did this guide work for you?
Thanks. It helps us fix the steps.
Sources
0 of 6Next: Update Claude Code


