{"name":"fallbackModel","slug":"fallbackmodel","family":"setting","title":"Settings keys","noun":"settings key","description":"Name [backup models](\/docs\/en\/model-config#fallback-model-chains) for when the primary is overloaded","description_source":"docs","described_by":{"doc":"claude-code\/settings-reference","title":"All settings"},"presence":{"first_seen":"2.1.166","removed_in":"2.1.284","in_current_build":false,"newest_mined":"2.1.308","builds":101,"mined_builds":149,"first_cited":{"version":"2.1.268","released_at":"2026-09-10 18:41:11","spans":2}},"aliases":[],"entries":[{"version":"2.1.292","anchor":"compaction-requests-pass-an-api-attempt-budget-and-fall-back","heading":"Conversation compaction limits its retries and picks a better fallback model","line":"When Claude Code compacts a conversation, it now passes a cap on API attempts and bases its fallback on the compaction model","released_at":"2026-10-06 17:10:31","reason":"found in this entry's text"},{"version":"2.1.283","anchor":"background-agents-go-back-to-the-primary-model-when-the-main","heading":"Background agents use the main model when your session is on a backup","line":"If the session has switched to a backup model, background agents now get the main model back when it is available","released_at":"2026-09-25 18:46:11","reason":"found in this entry's text, named in this entry"},{"version":"2.1.268","anchor":"gatewayinternalnetworks-added-to-managed-settings-merge-exce","heading":"gatewayInternalNetworks added to managed-settings merge exception list","line":"gatewayInternalNetworks added to the list of managed-settings fields that replace rather than merge","released_at":"2026-09-10 18:41:11","reason":"found in this entry's text"},{"version":"2.1.257","anchor":"new-sdkcli-option-inheritpermissionmode","heading":"New SDK\/CLI option inheritPermissionMode","line":"A new inheritPermissionMode option in the headless entrypoint lets a session take its parent's permission mode.","released_at":"2026-09-01 17:15:33","reason":"found in this entry's text"},{"version":"2.1.257","anchor":"managedsettings-merge-mode-composition-rules-made-explicit","heading":"managedSettings 'merge' mode composition rules made explicit and expanded","line":"Managed settings merge mode now documents which fields the helper replaces wholesale rather than merging.","released_at":"2026-09-01 17:15:33","reason":"found in this entry's text, named in this entry"},{"version":"2.1.242","anchor":"managed-settings-can-now-merge-across-sources-instead-of-the","heading":"Managed settings can now merge across sources instead of the top one winning","line":"Admins can set managedSourcesBehavior to merge managed settings sources instead of only the top one.","released_at":"2026-08-24 19:16:14","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.166","anchor":"fallbackmodel-setting-in-settings-json","heading":"fallbackModel setting in settings.json","line":null,"released_at":"2026-06-05 19:01:59","reason":"found in this entry's text"}],"entries_total":8,"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":"build-with-claude\/fallback-credit","title":"fallback-credit","documented":false},{"source":"claude-code","path":"admin-setup","title":"Set up Claude Code for your organization","documented":false},{"source":"claude-code","path":"agent-sdk\/configuration","title":"Configure your agent","documented":false},{"source":"claude-code","path":"agent-sdk\/typescript","title":"Agent SDK reference - TypeScript","documented":false},{"source":"claude-code","path":"cli-reference","title":"CLI reference","documented":false},{"source":"claude-code","path":"managed-settings","title":"Deploy managed settings","documented":false},{"source":"claude-code","path":"model-config","title":"Model configuration","documented":false},{"source":"claude-code","path":"whats-new\/2026-w24","title":"Week 24 \u00b7 June 8\u201312, 2026","documented":false}],"docs_total":11,"gates":[],"related":[],"url":"https:\/\/changelogs.core-directive.com\/reference\/setting\/fallbackmodel","family_url":"https:\/\/changelogs.core-directive.com\/reference\/setting.json"}