You'll noticeTier: how much it should matter to you
2Useful: my rating, 1 to 5
1Signal: worth watching, 1 to 5
ModelsArea: what it touches
ImprovementsKind: in v2.1.284,
ImprovementsSection of the release
Unclear It is not clear where the configured model list comes from or which features use this lookup.
What
When Claude Code has a configured list of models, it turns the aliases opus, sonnet and haiku into a model ID from that list. Each alias now maps to the first entry of that family in the list.
Before, Claude Code preferred the canonical ID of the family, such as a claude- name or a dated ID, and only fell back to other entries when no canonical one was present.
Why
If you use a custom model list, for example through a gateway, the order of the list now decides which model an alias like opus uses. Check that the model you want comes first in its family.
The entry above is what we published on the day. These lines were added later, as Anthropic's own pages caught up, and they sit beside the original rather than replacing it.
Added sinceA small documentation edit on Claude Code on Amazon Bedrock touched a line naming haiku after this was published.Entries with the `anthropic.` prefix are added as custom picker options, and the ones that match the Mantle format are routed to Mantle. Replace `anthropic.claude-haiku-4-5` with the model ID your account has been granted. See [Restrict mo…amazon-bedrocksee the edit
Confirmed sinceAnthropic's documentation has since written up haiku, on Agents.- `"claude-haiku-4-5"`api/beta/agentssee the edit
Added sinceA small documentation edit on Model configuration touched a line naming opus after this was published.When you set an `ANTHROPIC_DEFAULT_*_MODEL` variable, the `/model` picker shows one row for that model in place of the family's built-in rows, including any 1M context rows. To reach the 1M window without adding the suffix to that variable…model-configsee the edit
Confirmed sinceAnthropic's documentation has since written up sonnet, on Error reference.Model "Sonnet5" is not a recognized model id. Did you mean 'claude-sonnet-5'?errorssee the edit
Added sinceA small documentation edit on Model configuration touched a line naming sonnet after this was published.Administrators can use `availableModels` in [managed or policy settings](/docs/en/managed-settings) to restrict which models users can select. Entries match a model family such as `sonnet`, a version prefix such as `claude-sonnet-4-5`, or …model-configsee the edit