Follow Discord
Sweep 22 Sep 2026 · 17:19Z Build v2.1.280 501 read Stable v2.1.267 Latest v2.1.280 Next v2.1.280 Feeds RSS JSON llms.txt Unofficial
Claude Code v2.1.257 ·

New model-catalog fallback/mapping error message for unrecognized models

An unrecognized model id now produces an error telling you to update or map it with behavesAs or modelOverrides.

TierYou'll noticehow much it should matter to you
Useful3my rating, 1 to 5
Signal3worth watching, 1 to 5
AreaModel Catalogwhat it touches
KindImprovementsin v2.1.257,
You'll notice

An unrecognized model id now produces an error telling you to update or map it with behavesAs or modelOverrides.

A new internal helper generates the error shown when a model id isn't described by the current build's model catalog, telling the user to update Claude Code or map the model via behavesAs/modelOverrides. This is part of a reworked served model catalog system that also handles masking, family-spelling verdicts, and behavesAs lookups for resolving models unknown to the client.

Read from
Names in the bundlebehavesAsmodelOverrides
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.

Confirmed since Anthropic's documentation has since written up modelOverrides, on Claude Code gateway compatibility guide. * **Capabilities**: to give a gateway alias the capabilities of the model behind it, map that model's Anthropic ID to your alias with a [`modelOverrides`](/docs/en/errors#unrecognized-model-id-on-a-request) entry in the settings you distri… llm-gateway-protocol see the edit
How sure we are
One source agreesOne thing we can check says the same as this entry.
Anthropic's documentation agreesAnthropic's documentation has since written up modelOverrides, on Claude Code gateway compatibility guide.

See this entry in the whole of v2.1.257 →

Feedback