{"name":"switchModelsOnFlag","slug":"switchmodelsonflag","family":"setting","title":"Settings keys","noun":"settings key","description":"Switch models automatically or pause when a [safety classifier](\/docs\/en\/model-config.md#ask-before-switching) flags a request","description_source":"docs","described_by":{"doc":"claude-code\/settings-reference","title":"All settings"},"presence":{"first_seen":"2.1.160","removed_in":"2.1.284","in_current_build":false,"newest_mined":"2.1.309","builds":106,"mined_builds":150,"first_cited":{"version":"2.1.269","released_at":"2026-09-11 18:12:49","spans":2}},"aliases":[],"entries":[{"version":"2.1.301","anchor":"managed-settings-schema-expanded-settings-read-tool-returns","heading":"Organizations can push more settings remotely, and the output style is now reported","line":"Remotely managed settings now accept keys such as `effortLevel`, `outputStyle` and `attribution`, and Claude Code's settings report includes the output style","released_at":"2026-10-15 14:34:23","reason":"found in this entry's text"},{"version":"2.1.269","anchor":"switch-models-on-flag-setting-changed-from-boolean-toggle","heading":"'Switch models on flag' setting changed from boolean toggle to an explicit choice","line":"The 'switch models on flag' setting is now a named choice instead of a plain on\/off toggle","released_at":"2026-09-11 18:12:49","reason":"found in this entry's text, named in this entry"},{"version":"2.1.269","anchor":"new-telemetry-event-when-user-toggles-the-model-refusal-fall","heading":"New telemetry event when user toggles the model-refusal-fallback auto-switch setting","line":"Changing the automatic model-fallback-on-refusal setting now fires its own telemetry event and saves via userSettings","released_at":"2026-09-11 18:12:49","reason":"found in this entry's text, named in this entry"},{"version":"2.1.251","anchor":"refusal-fallback-model-switching-is-now-its-own-tracked-sett","heading":"Refusal-fallback model switching is now its own tracked setting","line":"The setting that switches models on a flagged refusal now records when you change it.","released_at":"2026-08-28 15:34:26","reason":"named in this entry, found in this entry's text"},{"version":"2.1.166","anchor":"model-switch-tip-now-points-to-config","heading":"Model-switch tip now points to \/config","line":null,"released_at":"2026-06-05 19:01:59","reason":"found in this entry's text"},{"version":"2.1.166","anchor":"improved-safety-filter-messaging","heading":"Improved safety-filter messaging","line":null,"released_at":"2026-06-05 19:01:59","reason":"found in this entry's text"},{"version":"2.1.163","anchor":"settings-panel-category-reorganization-in-development","heading":"Settings Panel Category Reorganization [In Development]","line":null,"released_at":"2026-06-04 17:56:01","reason":"found in this entry's text"}],"entries_total":7,"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":"model-config","title":"Model configuration","documented":false}],"docs_total":3,"gates":[],"related":[],"url":"https:\/\/changelogs.core-directive.com\/reference\/setting\/switchmodelsonflag","family_url":"https:\/\/changelogs.core-directive.com\/reference\/setting.json"}