modelOverrides
A Claude Code settings key, read out of the shipped bundle. It was in the build from v2.1.138 and was gone by v2.1.284.
Map model IDs to your provider's IDs, such as Bedrock ARNs
Anthropic's own wording. Read off All settings, captured 2026-10-23.
In the changelogs
10Releases whose published page names modelOverrides.
-
v2.1.288
Sensitive settings from the launch folder can now be dropped before they apply
Unless a launch-folder policy allows them, settings such as enabledPlugins and modelOverrides from the launch folder are now removed
found in this entry's text, named in this entry
-
v2.1.283
Managed model deny lists now also catch a managed provider's model IDs
Admin deny lists for models are now checked against the
modelOverridesof a host-managed provider, even whenavailableModelsis setfound in this entry's text, named in this entry
-
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.
found in this entry's text, named in this entry
-
v2.1.223
Auto-compact enforces an assumed context window for unrecognized models
Unknown model names now get an assumed context budget so auto-compact works instead of stalling.
named in this entry, found in this entry's text
-
v2.1.223
Model alias reverse-lookup only applies to recognized models
Model name overrides no longer swap in an alias pointing at a model the client doesn't know.
named in this entry, found in this entry's text
-
v2.1.223
Model entitlement check now resolves through model overrides
Model aliases pointing at models you lack access to are now correctly rejected.
found in this entry's text
-
v2.1.222
Host-managed provider sessions take model policy from the parent process
Setting CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST makes the parent process dictate your model settings, ignoring your settings file.
found in this entry's text
-
v2.1.219
Opus 5 replaces Opus 4.8 as the default Opus model
Opus 5 is now the default Opus, with a 1M-context option in the model picker.
found in this entry's text
-
v2.1.175
Organization-Enforced Model Allowlist (
enforceAvailableModels)found in this entry's text
-
v2.1.73
Model ID Override Mapping (Enterprise)
found in this entry's text
First cited
1The earliest release whose published evidence quoted modelOverrides was v2.1.223, 5 Aug 2026. That is the oldest release this project wrote about it, so it is a floor on the name's age and not the release that introduced it. It is not a presence reading: which builds carried the name is the table below.
Presence across releases
2Build by build
150One row per release since the first build this name was read out of. Absent means the build was read and the name was not in it, never mined means no bundle for that release was ever archived, and a declared type or a default is only ever what that release's own bundle stated.
Read out of the published npm bundle release by release, and out of Anthropic's own documentation as this site captured it. Nothing on this page is a description anybody here wrote about what the settings key does. All settings keys.