Model switches return error codes and skip the server check for…

Unclear The finding does not say whether Claude Code retries this error automatically.

What

A failed model switch now returns a machine-readable code. The code is one of alias_1m_disabled, alias_1m_unsupported, restricted_by_org, unavailable_for_account, not_offered, check_failed or, when a hook blocked the switch, blocked_by_hook. A hook is a command you configure to run on events.
Error messages mention /model only where that command exists. Elsewhere, they say "Switch to a different model." or just "Try again." Before, they always said to run /model.
The "Couldn't confirm model" error is now marked retryable.
A model picked at launch, for example by the SDK or in print mode (-p), is no longer checked against the server. The switch passes confirmWithServer: false, which becomes serverProbe: false, and the model is accepted as valid. The server check is also skipped when no deadline is given.
The print and SDK session now reports when a pick is a launch pick (isLaunchModelPick).

Why

The SDK is the library for running Claude Code from your own programs, and programs that embed Claude Code often have no /model command. Those hosts now get messages that make sense and a code they can act on. Starting with a model chosen at launch no longer waits on a server check, which matters most on a slow network.

Read from

Names in the bundle/model

Since it was published

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 since 30 Sep 2026 A small documentation edit on Claude Code on Amazon Bedrock touched a line naming /model after this was published. The [setup wizard](#sign-in-with-bedrock) offers a 1M context option when it pins models. To enable it for a manually pinned model instead, append `[1m]` to the model ID. See [Pin models for third-party deployments](/docs/en/model-config#p… amazon-bedrock see the edit

Confirmed since 29 Sep 2026 Anthropic's documentation has since written up /model, on Configure cloud environments. | Your organization's [server-managed settings](/docs/en/server-managed-settings) | Yes, except in [Claude Tag](https://claude.com/docs/claude-tag/overview) sessions | Fetched from Anthropic's servers when the session starts. See [Surface … cloud-environments see the edit

How sure we are

Something disagreesSomething we can check disagrees with this entry, or the writer said they could not settle it.

The writer flagged doubtThe finding does not say whether Claude Code retries this error automatically.

Anthropic's documentation agreesAnthropic's documentation has since written up /model, on Configure cloud environments.

Anthropic's release notes agreeFixed /model showing the raw API error JSON and request ID when the API refuses the picked model; it now shows the server's message and says…

See this entry in the whole of v2.1.281 →

The build it came inv2.1.281

23 Sep 2026 · 1,065 entries, this one is #156.

Use it now72
You'll notice488
Nothing to try yet55
Under the hood450

Either side of it

v2.1.280Older
v2.1.282Newer

Open the release →

Names in this entry

slash/model
Switch the AI model and save it as your default for new sessions. For models that support it, use left/right arrows to adjust effort level. With no argument, opens a picker; press s on a row to switch for the current session only. See when Claude Code asks you to confirm the switch. Once you confirm the switch, if Claude Code asks, Claude Code applies the change without waiting for the current response to finish. Before v2.1.242, Claude Code decided from a feature flag it fetched from Anthropic whether to run the command mid-turn or queue it until the turn finished, and always queued it in a session that doesn't fetch feature flags, such as on a third-party provider. Also available in non-interactive mode (-p) with a model argument instead of the picker, where it applies to the current session only and isn't saved as your default; requires Claude Code v2.1.205 or later
settingcode
MCP auth and HTTP failures are classified more accurately, and cancelled tool calls no longer trigger slow-call warnings.

Anthropic's note

Upstream's own release notes for v2.1.281 name something this entry names, so the two are probably about the same change. Probably: the pairing is made on a shared name rather than on the words around it.

Fixed /model showing the raw API error JSON and request ID when the API refuses the picked model; it now shows the server's message and says the model was not changed

Is this right?