{"name":"modelOverrides","slug":"modeloverrides","family":"setting","title":"Settings keys","noun":"settings key","description":"[Map model IDs](\/docs\/en\/model-config.md#override-model-ids-per-version) to your provider's IDs, such as Bedrock ARNs","description_source":"docs","described_by":{"doc":"claude-code\/settings-reference","title":"All settings"},"presence":{"first_seen":"2.1.138","removed_in":"2.1.284","in_current_build":false,"newest_mined":"2.1.309","builds":126,"mined_builds":150,"first_cited":{"version":"2.1.223","released_at":"2026-08-05 22:51:13","spans":1}},"aliases":[],"entries":[{"version":"2.1.288","anchor":"launch-folder-settings-keys-stripped-before-merge","heading":"Sensitive settings from the launch folder can now be dropped before they apply","line":"Unless a launch-folder policy allows them, settings such as enabledPlugins and modelOverrides from the launch folder are now removed","released_at":"2026-10-02 18:30:40","reason":"found in this entry's text, named in this entry"},{"version":"2.1.283","anchor":"managed-deniedmodels-now-also-matches-the-host-managed-provi","heading":"Managed model deny lists now also catch a managed provider's model IDs","line":"Admin deny lists for models are now checked against the `modelOverrides` of a host-managed provider, even when `availableModels` is set","released_at":"2026-09-25 18:46:11","reason":"found in this entry's text, named in this entry"},{"version":"2.1.257","anchor":"new-model-catalog-fallbackmapping-error-message-for-unrecog","heading":"New model-catalog fallback\/mapping error message for unrecognized models","line":"An unrecognized model id now produces an error telling you to update or map it with behavesAs or modelOverrides.","released_at":"2026-09-01 17:15:33","reason":"found in this entry's text, named in this entry"},{"version":"2.1.223","anchor":"auto-compact-enforces-an-assumed-context-window-for-unrecogn","heading":"Auto-compact enforces an assumed context window for unrecognized models","line":"Unknown model names now get an assumed context budget so auto-compact works instead of stalling.","released_at":"2026-08-05 22:51:13","reason":"named in this entry, found in this entry's text"},{"version":"2.1.223","anchor":"model-alias-reverse-lookup-only-applies-to-recognized-models","heading":"Model alias reverse-lookup only applies to recognized models","line":"Model name overrides no longer swap in an alias pointing at a model the client doesn't know.","released_at":"2026-08-05 22:51:13","reason":"named in this entry, found in this entry's text"},{"version":"2.1.223","anchor":"model-entitlement-check-now-resolves-through-model-overrides","heading":"Model entitlement check now resolves through model overrides","line":"Model aliases pointing at models you lack access to are now correctly rejected.","released_at":"2026-08-05 22:51:13","reason":"found in this entry's text"},{"version":"2.1.222","anchor":"host-managed-provider-sessions-take-model-policy-from-the-pa","heading":"Host-managed provider sessions take model policy from the parent process","line":"Setting CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST makes the parent process dictate your model settings, ignoring your settings file.","released_at":"2026-08-04 20:37:17","reason":"found in this entry's text"},{"version":"2.1.219","anchor":"opus-5-replaces-opus-4-8-as-the-default-opus-model","heading":"Opus 5 replaces Opus 4.8 as the default Opus model","line":"Opus 5 is now the default Opus, with a 1M-context option in the model picker.","released_at":"2026-07-24 16:11:49","reason":"found in this entry's text"},{"version":"2.1.175","anchor":"organization-enforced-model-allowlist-enforceavailablemodels","heading":"Organization-Enforced Model Allowlist ( enforceAvailableModels )","line":null,"released_at":"2026-06-12 02:10:22","reason":"found in this entry's text"},{"version":"2.1.73","anchor":"model-id-override-mapping-enterprise","heading":"Model ID Override Mapping (Enterprise)","line":null,"released_at":"2026-03-11 17:39:34","reason":"found in this entry's text"}],"entries_total":10,"docs":[{"source":"claude-code","path":"settings-reference","title":"All settings","documented":true},{"source":"claude-code","path":"settings","title":"Claude Code settings","documented":true},{"source":"claude-code","path":"amazon-bedrock","title":"Claude Code on Amazon Bedrock","documented":false},{"source":"claude-code","path":"changelog","title":"Claude Code changelog","documented":false},{"source":"claude-code","path":"claude-apps-gateway-config","title":"Claude apps gateway configuration","documented":false},{"source":"claude-code","path":"google-vertex-ai","title":"Claude Code on Google Cloud's Agent Platform","documented":false},{"source":"claude-code","path":"llm-gateway-protocol","title":"Claude Code gateway compatibility guide","documented":false},{"source":"claude-code","path":"llm-gateway-rollout","title":"Roll out an LLM gateway for your organization","documented":false},{"source":"claude-code","path":"microsoft-foundry","title":"Claude Code on Microsoft Foundry","documented":false},{"source":"claude-code","path":"model-config","title":"Model configuration","documented":false}],"docs_total":10,"gates":[],"related":[],"url":"https:\/\/changelogs.core-directive.com\/reference\/setting\/modeloverrides","family_url":"https:\/\/changelogs.core-directive.com\/reference\/setting.json"}