{"name":"model","slug":"model","family":"setting","title":"Settings keys","noun":"settings key","description":"Change the [model](\/docs\/en\/model-config#set-a-default-model-for-new-sessions) Claude Code starts with","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":null},"aliases":[],"entries":[{"version":"2.1.296","anchor":"set-model-gains-only-if-model-is-current-guard","heading":"set_model can swap the system prompt only if the expected model is running","line":"set_model gains only_if_model_is_current, which replaces the system prompt only if the session confirms it runs the named model","released_at":"2026-10-09 16:58:10","reason":"found in this entry's text"},{"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"},{"version":"2.1.282","anchor":"schedule-cloud-routines-skill-example-uses-the-resolved-so","heading":"Routine-scheduling example uses the current Sonnet model instead of a fixed one","line":"The example in the routine-scheduling skill now fills in whatever model \"sonnet\" currently points to rather than always naming claude-sonnet-5","released_at":"2026-09-24 15:56:22","reason":"found in this entry's text"},{"version":"2.1.281","anchor":"agent-definitions-may-have-an-empty-prompt","heading":"Agent definitions may have an empty prompt","line":"Agent definitions with an empty `prompt` are no longer rejected","released_at":"2026-09-23 17:01:17","reason":"found in this entry's text"},{"version":"2.1.281","anchor":"command-frontmatter-overrides-helper","heading":"Command frontmatter overrides helper","line":"Command overrides can now replace a command's description, argument hint, model and allowed tools, and plugin commands are merged into the list","released_at":"2026-09-23 17:01:17","reason":"found in this entry's text"},{"version":"2.1.280","anchor":"mcp-servers-can-now-hide-tools-from-the-model-via-metaui","heading":"MCP servers can now hide tools from the model via _meta.ui.visibility , live and wired","line":"MCP servers can now hide specific tools from Claude while still showing them to the human in mcp_status","released_at":"2026-09-22 15:44:39","reason":"found in this entry's text"},{"version":"2.1.277","anchor":"announcement-style-context-blocks-can-be-repositioned-to-jus","heading":"Announcement-style context blocks can be repositioned to just before the closing line","line":"Certain system announcements can now be moved to sit right before the closing line at session start","released_at":"2026-09-18 16:22:26","reason":"found in this entry's text"},{"version":"2.1.275","anchor":"advisor-model-api-errors-get-dedicated-recognition-includin","heading":"Advisor-model API errors get dedicated recognition, including org-entitlement case","line":"Advisor-model API errors are now specifically recognized, including when unavailable for an organization","released_at":"2026-09-17 20:20:31","reason":"found in this entry's text"},{"version":"2.1.269","anchor":"model-parameter-allowlist-changed-from-array-to-set","heading":"Model-parameter allowlist changed from array to Set","line":"Internal list of allowed API request fields switched from an array to a Set","released_at":"2026-09-11 18:12:49","reason":"found in this entry's text"},{"version":"2.1.268","anchor":"datadog-model-sanitization-now-runs-on-any-defined-model-val","heading":"Datadog model-sanitization now runs on any defined model value, not just strings","line":"Datadog telemetry now sanitizes any defined model value, not just string ones, dropping events it can't sanitize","released_at":"2026-09-10 18:41:11","reason":"found in this entry's text"}],"entries_total":47,"docs":[{"source":"claude-code","path":"settings-reference","title":"All settings","documented":true},{"source":"claude-code","path":"settings","title":"Claude Code settings","documented":true},{"source":"api","path":"about-claude\/additional-resources","title":"additional-resources","documented":false},{"source":"api","path":"about-claude\/api-credits-for-subscribers","title":"api-credits-for-subscribers","documented":false},{"source":"api","path":"about-claude\/glossary","title":"glossary","documented":false},{"source":"api","path":"about-claude\/model-deprecations","title":"model-deprecations","documented":false},{"source":"api","path":"about-claude\/models\/choosing-a-model","title":"choosing-a-model","documented":false},{"source":"api","path":"about-claude\/models\/migration-guide","title":"Or, for the model with the same capabilities and no access approval requirement:","documented":false},{"source":"api","path":"about-claude\/models\/model-ids-and-versions","title":"model-ids-and-versions","documented":false},{"source":"api","path":"about-claude\/models\/optimizing-for-cost-and-intelligence","title":"optimizing-for-cost-and-intelligence","documented":false}],"docs_total":14,"gates":[],"related":[],"url":"https:\/\/changelogs.core-directive.com\/reference\/setting\/model","family_url":"https:\/\/changelogs.core-directive.com\/reference\/setting.json"}