{"name":"availableModels","slug":"availablemodels","family":"setting","title":"Settings keys","noun":"settings key","description":"[Restrict which models](\/docs\/en\/model-config#restrict-model-selection) people can pick","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.308","builds":126,"mined_builds":149,"first_cited":{"version":"2.1.175","released_at":"2026-06-12 02:10:22","spans":9}},"aliases":[],"entries":[{"version":"2.1.299","anchor":"gateway-supports-a-deniedmodels-denylist","heading":"Gateway blocks models listed in a role's deniedModels","line":"The gateway now rejects models in a role's `deniedModels` list and hides them from the model list, alongside the `availableModels` allowlist","released_at":"2026-10-14 00:23:19","reason":"found in this entry's text, named in this entry"},{"version":"2.1.287","anchor":"managed-settings-denial-message-for-model-checks","heading":"Claude Code explains when managed settings block a model","line":"A new message says when a model was skipped for a check, fallback or upgrade because managed settings do not allow it","released_at":"2026-10-01 16:59:25","reason":"found in this entry's text"},{"version":"2.1.285","anchor":"managed-settings-helper-merge-doc-allowedproviders-is-a-w","heading":"Managed settings docs: allowedProviders is replaced, not merged","line":"The settings description now says allowedProviders, like the other restriction allowlists, is taken whole from the helper and not merged","released_at":"2026-09-29 17:32:09","reason":"found in this entry's text, named in this entry"},{"version":"2.1.284","anchor":"gateway-config-validation-warns-about-empty-or-default-less","heading":"Gateway config checks warn about model lists that would reject every request","line":"Gateway checks now warn when availableModels is empty or leaves out the default model, both of which get requests refused","released_at":"2026-09-28 17:11:59","reason":"found in this entry's text, named in this entry"},{"version":"2.1.283","anchor":"new-managed-settings-deniedmodels-and-availablemodelsmatc","heading":"Admins can block specific models and require exact version matches","line":"Managed settings gain `deniedModels` to block models and `availableModelsMatch` to stop an allowed ID covering later versions","released_at":"2026-09-25 18:46:11","reason":"found in this entry's text"},{"version":"2.1.283","anchor":"switching-to-the-default-model-now-checks-managed-availablem","heading":"Switching to the default model now respects your organization's model rules","line":"Choosing the default model now checks availableModels and deniedModels and is refused if your organization's managed settings block it","released_at":"2026-09-25 18:46:11","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.283","anchor":"default-model-steps-down-to-an-allowed-model-when-managed-se","heading":"Claude Code picks an allowed model when admin settings block the default","line":"If managed settings block the default model, Claude Code now steps down to an allowed model, and reports a clear startup error when none is left","released_at":"2026-09-25 18:46:11","reason":"found in this entry's text, named in this entry"},{"version":"2.1.283","anchor":"managed-policy-deniedmodels-now-restricts-the-model-picker","heading":"Models denied by managed policy are hidden from the \/model picker","line":"When managed policy sets deniedModels, the \/model picker now leaves those models out instead of showing the full list","released_at":"2026-09-25 18:46:11","reason":"found in this entry's text, named in this entry"},{"version":"2.1.282","anchor":"empty-strictknownmarketplaces-array-now-counts-as-an-activ","heading":"An empty strictKnownMarketplaces list now counts as a restriction","line":"Setting `strictKnownMarketplaces` to an empty list is now treated as a restriction in force, like other managed allowlists","released_at":"2026-09-24 15:56:22","reason":"found in this entry's text"}],"entries_total":25,"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":"admin-setup","title":"Set up Claude Code for your organization","documented":false},{"source":"claude-code","path":"advisor","title":"Escalate hard decisions with the advisor tool","documented":false},{"source":"claude-code","path":"agent-sdk\/python","title":"Agent SDK reference - Python","documented":false},{"source":"claude-code","path":"agent-sdk\/typescript","title":"Agent SDK reference - TypeScript","documented":false},{"source":"claude-code","path":"agent-teams","title":"Orchestrate teams of Claude Code sessions","documented":false},{"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","title":"Claude apps gateway for Amazon Bedrock, Claude Platform on AWS, Google Cloud, and Microsoft Foundry","documented":false}],"docs_total":14,"gates":[],"related":[],"url":"https:\/\/changelogs.core-directive.com\/reference\/setting\/availablemodels","family_url":"https:\/\/changelogs.core-directive.com\/reference\/setting.json"}