Text of code.claude.com › docs › en › model-config as Styx crawled it on Nov 20, 2026. The page may have changed since. Only its words are kept, without pictures or layout, and only the first part of a long page.

Open the live page

Model configuration - Claude Code Docs

Documentation Index Fetch the complete documentation index at: /docs/llms.txt Use this file to discover all available pages before exploring further. Skip to main content Assistant Responses are generated using AI and may contain mistakes. Available models For the model setting in Claude Code, you can configure either: A model alias A model name Anthropic API: a full model name Amazon Bedrock: an inference profile ARN Microsoft Foundry: a deployment name Google Cloud’s Agent Platform: a version name For guidance on which model and effort level fit different kinds of work, see Choosing a Claude model and effort level in Claude Code on the blog.

ANTHROPIC_BASE_URL changes where requests are sent, not which model answers them. To route Claude through an LLM gateway, see LLM gateways . Model aliases Use a model alias to select model settings without remembering exact version numbers: Model alias Behavior default Special value that clears any model override and reverts to the runtime default for your account . Not itself a model alias best Uses the same model as opus fable Uses the Fable model for your provider for your hardest and longest-running tasks sonnet Uses the latest Sonnet model for daily coding tasks opus Uses the latest Opus model for complex reasoning tasks haiku Uses the fast and efficient Haiku model for simple tasks sonnet[1m] Uses Sonnet with a 1 million token context window for long sessions.

No effect when sonnet already resolves to Sonnet 5.5 or Sonnet 5 with their native 1M window opus[1m] Uses Opus with a 1 million token context window for long sessions. No effect when opus already resolves to Opus 4.7 or later with its native 1M window opusplan Special mode that uses opus during plan mode, then switches to sonnet for execution The opus , sonnet , and haiku aliases resolve to the newest version on the Anthropic API and to an earlier version on some other providers: Provider opus sonnet haiku Anthropic API Opus 5.5 Sonnet 5.5 Haiku 5.5 Claude Platform on AWS Opus 5.5 Sonnet 4.6 Haiku 4.5 Claude Models on Google Cloud (Anthropic managed) Opus 5.5 Sonnet 5.5 Haiku 4.5 Amazon Bedrock, Google Cloud’s Agent Platform Opus 5.5 Sonnet 4.5 Haiku 4.5 Microsoft Foundry Opus 4.6 Sonnet 4.5 Haiku 4.5 Unless you set ANTHROPIC_DEFAULT_FABLE_MODEL , the fable alias resolves to Fable 5 in Claude apps gateway sessions and to Fable 5.2 everywhere else.

A gateway that isn’t configured to serve claude-fable-5-2 rejects requests for that model. To use Fable 5.2 through a gateway that serves it, select it with /model claude-fable-5-2 . Where opus or sonnet resolves to an older model, newer models are available by selecting the full model name explicitly or setting ANTHROPIC_DEFAULT_OPUS_MODEL or ANTHROPIC_DEFAULT_SONNET_MODEL . Earlier versions resolve these aliases to older models.

For the version at which each alias changed, see Version history . Aliases point to the recommended version for your provider and update over time. To pin to a specific version, use the full model name, for example claude-opus-5-5 , or set the corresponding environment variable like ANTHROPIC_DEFAULT_OPUS_MODEL . Sonnet 5.5 requires Claude Code v2.1.284 or later, and Opus 5.5 requires v2.1.280 or later. If a request for one of them from an older version fails, see Claude Code does not support this model .

Use v2.1.293 or later with Haiku 5.5. Run claude update to upgrade. Work with Fable Claude Fable models are the most capable models in Claude Code, suited to tasks larger than a single sitting. They sustain long autonomous sessions, investigate before acting, and verify their work more often than smaller models. No Fable model is the account-type default on any plan or provider. Select one explicitly: Fable 5.2 : run /model fable , or launch with claude --model fable .

In Claude apps gateway sessions, run /model claude-fable-5-2 instead. Fable 5.1 or Fable 5 : select it by model ID. On the Anthropic API, run /model claude-fable-5-1 or /model claude-fable-5 , or launch with claude --model claude-fable-5-1 . On other providers, use your provider’s model ID or pin it with ANTHROPIC_DEFAULT_FABLE_MODEL . On Pro, Max, Ultra, Team, and Enterprise plans, a claude-fable-5-1 model saved in your user settings moves to the fable alias: Pro, Max, or Ultra plan : the move happens the first time you run v2.1.321 or later.

In the terminal, the startup model line can show (auto-updated) once. Team or Enterprise plan : the move waits for your organization’s settings, so it can come at a later startup, or not at all. It applies from the next session, with no (auto-updated) line. To check your model, run /model . After the move, sessions start at Fable 5.2’s default effort unless you’ve set a level for it. Console accounts, third-party providers, and project, local, or managed settings keep claude-fable-5-1 .

Requests that a Fable model’s safety classifiers flag, most often in cybersecurity and biology domains, trigger automatic model fallback . To get the most from Fable: Describe the outcome, not the steps : hand it the result you want and let it plan the path. To keep it working toward that outcome, set a goal . Hand it ambiguous problems : root-cause investigations, outage debugging, and architecture decisions are where the extra investigation and verification pay off.

Skip the verification reminders : it verifies its own work with less prompting, so reminders to test or check are usually unnecessary. Size up larger tasks : give it work you would normally break into pieces. It holds long sessions without losing the thread. Fable 5.2 requires Claude Code v2.1.321 or later, and Fable 5.1 requires v2.1.257 or later. If a request for one of them from an older version fails, see Claude Code does not support this model .

Run claude update to upgrade. For availability under zero data retention, see Model availability under ZDR . On the Anthropic API, a Fable model appears in the /model picker unless availableModels or organization model restrictions exclude it. When your organization can’t use Fable at all, for example under zero data retention , the row stays in the picker grayed out, with a note on why. Fable and usage credits Depending on your plan and seat tier, Fable usage can bill to usage credits instead of drawing on your plan’s included limits.

When it does, the /model picker shows “Requires usage credits” on the Fable row. To manage usage credits, see Add usage credits to your subscription . In interactive sessions, Claude Code can show a Fable usage-credits consent prompt. You can continue on Fable using usage credits or switch to your default model. You can also dismiss the prompt: When you select a Fable model with /model , you keep your current model.

Mid-session, Claude Code continues the turn on your default model. After you choose to continue on Fable using usage credits, Claude Code doesn’t show the prompt again. In a session with Remote Control connected, a background session , or an agent team teammate’s session, nobody may be at the terminal, so Claude Code holds the mid-session consent prompt for the dialogExpiry deadline, five minutes by default. If nobody has answered by the deadline, Claude Code ends the turn without sending the request and adds a notice to the transcript, which the Remote Control client also shows.

Your model selection is unchanged, and Claude Code asks for consent again on your next message. What you can do while the prompt is waiting depends on the session: With Remote Control connected or in a teammate’s session, press any key at the terminal to cancel the deadline, and Claude Code waits for your answer. With Remote Control connected in an interactive terminal session, you can also answer on your connected device, and that answer lasts for that session.

Requires Claude Code v2.1.323 or later. In a background session, answer before the deadline. If you send a new message from the remote client before anyone has typed at the

The rest of this page is on the live site.