{"name":"modelSettings","slug":"modelsettings","family":"setting","title":"Settings keys","noun":"settings key","description":"Keep a saved [effort level](\/docs\/en\/model-config#adjust-effort-level) or [auto-compact window](\/docs\/en\/model-config#set-the-auto-compact-window) per model, or cap one model's effort","description_source":"docs","described_by":{"doc":"claude-code\/settings-reference","title":"All settings"},"presence":{"first_seen":"2.1.239","removed_in":"2.1.284","in_current_build":false,"newest_mined":"2.1.308","builds":36,"mined_builds":149,"first_cited":{"version":"2.1.240","released_at":"2026-08-22 13:03:23","spans":1}},"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.300","anchor":"modelsettingsautocompactwindow-is-now-reported-as-a-setting","heading":"Claude Code now notes when a per-model auto-compact window is set","line":"Claude Code's list of settings in use now includes `autoCompactWindow` when it is set for any model under `modelSettings`","released_at":"2026-10-14 14:27:26","reason":"found in this entry's text"},{"version":"2.1.288","anchor":"per-model-autocompactwindow-setting","heading":"Auto-compact window can now be set separately for each model","line":"`autoCompactWindow` can now go under `modelSettings` for a single model, as a token count or `auto`","released_at":"2026-10-02 18:30:40","reason":"found in this entry's text, named in this entry"},{"version":"2.1.277","anchor":"update-settings-tool-can-now-target-more-than-localsettings","heading":"update_settings tool can now target more than localSettings, including userSettings.effortLevel","line":"The internal update_settings tool can now write userSettings.effortLevel, not just localSettings","released_at":"2026-09-18 16:22:26","reason":"found in this entry's text"},{"version":"2.1.267","anchor":"per-model-maxeffortlevel-cap-now-enforced-client-side-acro","heading":"Per-model \"maxEffortLevel\" cap now enforced client-side across settings","line":"maxEffortLevel now combines a global cap with per-model overrides across all settings files and clamps any explicit effort request","released_at":"2026-09-09 18:25:42","reason":"found in this entry's text"},{"version":"2.1.240","anchor":"saving-a-default-effort-level-can-now-scope-it-to-one-model","heading":"Saving a default effort level can now scope it to one model","line":"Your saved default effort could apply per model instead of everywhere, but that is off.","released_at":"2026-08-22 13:03:23","reason":"found in this entry's text"},{"version":"2.1.239","anchor":"new-modelsettings-config-key-holds-per-model-effort","heading":"New modelSettings config key holds per-model effort","line":"A new modelSettings config key stores an effort level per model, from low to xhigh.","released_at":"2026-08-21 17:18:54","reason":"named in this entry, found in this entry's text"},{"version":"2.1.239","anchor":"per-model-effort-level-in-settings-behind-a-gate","heading":"Per-model effort level in settings, behind a gate","line":"You could set an effort level per model in settings, but the lookup is gated off.","released_at":"2026-08-21 17:18:54","reason":"named in this entry, 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":"agent-sdk\/typescript","title":"Agent SDK reference - TypeScript","documented":false},{"source":"claude-code","path":"agent-view","title":"Manage multiple agents with agent view","documented":false},{"source":"claude-code","path":"cli-reference","title":"CLI reference","documented":false},{"source":"claude-code","path":"env-vars","title":"Environment variables","documented":false},{"source":"claude-code","path":"model-config","title":"Model configuration","documented":false},{"source":"claude-code","path":"settings-example","title":"Example settings files","documented":false},{"source":"claude-code","path":"vs-code","title":"Use Claude Code in VS Code","documented":false},{"source":"claude-code","path":"whats-new\/2026-w37","title":"Week 37 \u00b7 September 7\u201311, 2026","documented":false}],"docs_total":9,"gates":[],"related":[],"url":"https:\/\/changelogs.core-directive.com\/reference\/setting\/modelsettings","family_url":"https:\/\/changelogs.core-directive.com\/reference\/setting.json"}