{"name":"permissions.defaultMode","slug":"permissions-defaultmode","family":"setting","title":"Settings keys","noun":"settings key","description":"Set the [permission mode](\/docs\/en\/permission-modes.md#which-mode-a-session-starts-in) new sessions start in","description_source":"docs","described_by":{"doc":"claude-code\/settings-reference","title":"All settings"},"presence":{"first_seen":null,"removed_in":null,"in_current_build":false,"newest_mined":"2.1.309","builds":0,"mined_builds":150,"first_cited":null},"aliases":[],"entries":[{"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.283","anchor":"tengu-harbor-willow-now-defaults-on-sessions-can-start-in-a","heading":"Sessions can start in auto mode when the server sends no setting","line":"The built-in fallback for starting sessions in auto mode switched from off to on, so it applies unless the server turns it off","released_at":"2026-09-25 18:46:11","reason":"found in this entry's text, named in this entry"},{"version":"2.1.271","anchor":"bridge-child-auto-mode-permission-defaulting-gated-off","heading":"Bridge child auto-mode permission defaulting, gated off","line":"Bridge-spawned child sessions may be defaulted to auto permission mode, gated off","released_at":"2026-09-14 19:45:19","reason":"found in this entry's text"},{"version":"2.1.257","anchor":"bypasspermissionsauto-default-permission-mode-can-now-b","heading":"'bypassPermissions'\/'auto' default-permission-mode can now be set from local settings","line":"The auto and bypassPermissions default permission modes can now be set from local settings, not just project settings.","released_at":"2026-09-01 17:15:33","reason":"found in this entry's text, named in this entry"},{"version":"2.1.257","anchor":"new-tengu-settings-mode-widening-carry-ignored-telemetry-for","heading":"New tengu_settings_mode_widening_carry_ignored telemetry for settings-level widening","line":"Project or local settings can no longer widen the effective permission mode via defaultMode.","released_at":"2026-09-01 17:15:33","reason":"named in this entry"},{"version":"2.1.248","anchor":"permission-nudge-and-explainer-moved-not-changed","heading":"Permission nudge and explainer moved, not changed","line":"The auto permission-mode nudge and explainer moved in code but behave the same.","released_at":"2026-08-27 20:35:36","reason":"found in this entry's text"},{"version":"2.1.238","anchor":"carrying-and-reporting-your-local-permission-mode-in-remote-","heading":"Carrying and reporting your local permission mode in remote sessions is gated off","line":"Remote sessions could inherit your local permission mode and effort level, but no value is compiled in.","released_at":"2026-08-20 18:01:54","reason":"named in this entry, found in this entry's text"},{"version":"2.1.236","anchor":"one-time-prompt-offering-to-make-auto-mode-your-default-perm","heading":"One-time prompt offering to make auto mode your default permission mode","line":"Claude can offer once to make auto mode your default permission mode, switched off in this build.","released_at":"2026-08-19 18:45:14","reason":"found in this entry's text"},{"version":"2.1.225","anchor":"auto-default-nudge-actually-flips-the-mode-and-reports-the-o","heading":"Auto-default nudge actually flips the mode, and reports the outcome","line":"Saying yes to the auto-mode prompt now actually saves auto as your default permission mode.","released_at":"2026-08-07 23:08:56","reason":"named in this entry"},{"version":"2.1.225","anchor":"vs-code-owned-sessions-get-their-own-settings-defaultmode-ha","heading":"VS Code-owned sessions get their own settings defaultMode handling","line":"In VS Code sessions, unsafe default permission modes from settings are refused and fall back to normal.","released_at":"2026-08-07 23:08:56","reason":"named in this entry, found in this entry's text"}],"entries_total":11,"docs":[{"source":"claude-code","path":"settings-reference","title":"All settings","documented":true},{"source":"claude-code","path":"admin-setup","title":"Set up Claude Code for your organization","documented":false},{"source":"claude-code","path":"agent-sdk\/permissions","title":"Configure permissions","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":"changelog","title":"Claude Code changelog","documented":false},{"source":"claude-code","path":"desktop","title":"Desktop application","documented":false},{"source":"claude-code","path":"hooks","title":"Hooks reference","documented":false},{"source":"claude-code","path":"hooks-guide","title":"Automate actions with hooks","documented":false},{"source":"claude-code","path":"managed-settings","title":"Deploy managed settings","documented":false}],"docs_total":13,"gates":[],"related":[{"name":"permissions","slug":"permissions","description":"Set allow, ask, and deny rules and the starting [permission mode](\/docs\/en\/permission-modes.md)"},{"name":"permissions.additionalDirectories","slug":"permissions-additionaldirectories","description":"Give Claude file access to [directories outside the current one](\/docs\/en\/permissions.md#working-directories)"},{"name":"permissions.allow","slug":"permissions-allow","description":"Approve listed [tool uses](\/docs\/en\/permissions.md#permission-rule-syntax) without a prompt"},{"name":"permissions.ask","slug":"permissions-ask","description":"Always prompt before listed [tool uses](\/docs\/en\/permissions.md#permission-rule-syntax)"},{"name":"permissions.blockReadsOutsideWorkingDirectories","slug":"permissions-blockreadsoutsideworkingdirectories","description":"Make the file tools refuse reads outside the [working directories](\/docs\/en\/permissions.md#working-directories) in every permission mode"},{"name":"permissions.deny","slug":"permissions-deny","description":"Block listed [tool uses](\/docs\/en\/permissions.md#permission-rule-syntax), including reads of files that hold secrets"},{"name":"permissions.disableAutoMode","slug":"permissions-disableautomode","description":"Set `disableAutoMode` to \"disable\" to stop Claude Code ever falling back to auto permission mode."}],"url":"https:\/\/changelogs.core-directive.com\/reference\/setting\/permissions-defaultmode","family_url":"https:\/\/changelogs.core-directive.com\/reference\/setting.json"}