{"name":"effortLevel","slug":"effortlevel","family":"setting","title":"Settings keys","noun":"settings key","description":"Set a default [effort level](\/docs\/en\/model-config.md#adjust-effort-level) for models without a saved level of their own","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.309","builds":126,"mined_builds":150,"first_cited":{"version":"2.1.126","released_at":"2026-04-30 20:30:34","spans":7}},"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.287","anchor":"effort-level-settings-ignored-when-a-helper-says-so","heading":"Effort level setting is skipped in some cases","line":"Claude Code now sometimes skips applying an `effortLevel` setting, depending on a check of the model and level","released_at":"2026-10-01 16:59:25","reason":"found in this entry's text, named in this entry"},{"version":"2.1.287","anchor":"bridge-apply-flag-settings-skips-effortlevel-when-it-already","heading":"Effort level updates from a controlling program are skipped when unchanged","line":"When a controlling program sets an effort level that is already in effect, Claude Code now skips re-applying it","released_at":"2026-10-01 16:59:25","reason":"found in this entry's text, named in this entry"},{"version":"2.1.287","anchor":"set-effort-level-request-is-skipped-when-the-engine-state-al","heading":"Some effort level updates are now skipped instead of applied","line":"An update that sets effortLevel is now ignored, without being reported, when a new check on the model and its current state says so","released_at":"2026-10-01 16:59:25","reason":"found in this entry's text, named in this entry"},{"version":"2.1.280","anchor":"model-effort-level-resolution-changed-for-usersettings-sourc","heading":"Model effort-level resolution changed for userSettings source","line":"Model effort level from user settings alone is no longer always honored automatically","released_at":"2026-09-22 15:44:39","reason":"found in this entry's text"},{"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.277","anchor":"effort-level-command-validation-gains-a-dedicated-error-mess","heading":"Effort level command validation gains a dedicated error message","line":"New dedicated error message when update_settings is called with an invalid effortLevel","released_at":"2026-09-18 16:22:26","reason":"found in this entry's text, named in this entry"},{"version":"2.1.274","anchor":"org-admins-can-force-their-default-reasoning-effort-level-on","heading":"Org admins can force their default reasoning-effort level onto users","line":"Org admins can now force their default reasoning effort level onto all users","released_at":"2026-09-16 22:36:09","reason":"found in this entry's text"},{"version":"2.1.271","anchor":"new-remote-control-plane-commands-mcp-reconnecttoggle-ses","heading":"New remote-control-plane commands: MCP reconnect\/toggle, session titling\/renaming, task stop\/backgrounding, and flag settings","line":"Remote control connections can now reconnect\/toggle MCP servers, rename sessions, stop tasks, and set effort\/ultracode flags","released_at":"2026-09-14 19:45:19","reason":"found in this entry's text"},{"version":"2.1.242","anchor":"cloud-sessions-accept-only-seven-live-settings-changes","heading":"Cloud sessions accept only seven live settings changes","line":"Only seven settings can be changed mid-run against a cloud session; others are rejected by name.","released_at":"2026-08-24 19:16:14","reason":"found in this entry's text"}],"entries_total":23,"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":"cli-sdks-libraries\/libraries\/apple-foundation-models","title":"apple-foundation-models","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\/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-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}],"docs_total":14,"gates":[],"related":[],"url":"https:\/\/changelogs.core-directive.com\/reference\/setting\/effortlevel","family_url":"https:\/\/changelogs.core-directive.com\/reference\/setting.json"}