permissions.defaultMode
A Claude Code settings key, read out of the shipped bundle. No mined inventory carries it: everything below comes from what this site has written about it.
Set the permission mode new sessions start in
Anthropic's own wording. Read off All settings, captured 2026-10-22.
In the changelogs
11Releases whose published page names permissions.defaultMode.
-
v2.1.300
Claude Code now notes when a per-model auto-compact window is set
Claude Code's list of settings in use now includes
autoCompactWindowwhen it is set for any model undermodelSettingsfound in this entry's text
-
v2.1.283
Sessions can start in auto mode when the server sends no setting
The built-in fallback for starting sessions in auto mode switched from off to on, so it applies unless the server turns it off
found in this entry's text, named in this entry
-
v2.1.271
Bridge child auto-mode permission defaulting, gated off
Bridge-spawned child sessions may be defaulted to auto permission mode, gated off
found in this entry's text
-
v2.1.257
'bypassPermissions'/'auto' default-permission-mode can now be set from local settings
The auto and bypassPermissions default permission modes can now be set from local settings, not just project settings.
found in this entry's text, named in this entry
-
v2.1.257
New tengu_settings_mode_widening_carry_ignored telemetry for settings-level widening
Project or local settings can no longer widen the effective permission mode via defaultMode.
named in this entry
-
v2.1.248
Permission nudge and explainer moved, not changed
The auto permission-mode nudge and explainer moved in code but behave the same.
found in this entry's text
-
v2.1.238
Carrying and reporting your local permission mode in remote sessions is gated off
Remote sessions could inherit your local permission mode and effort level, but no value is compiled in.
named in this entry, found in this entry's text
-
v2.1.236
One-time prompt offering to make auto mode your default permission mode
Claude can offer once to make auto mode your default permission mode, switched off in this build.
found in this entry's text
-
v2.1.225
Auto-default nudge actually flips the mode, and reports the outcome
Saying yes to the auto-mode prompt now actually saves auto as your default permission mode.
named in this entry
-
v2.1.225
VS Code-owned sessions get their own settings defaultMode handling
In VS Code sessions, unsafe default permission modes from settings are refused and fall back to normal.
named in this entry, found in this entry's text
-
v1.0.54
Settings Configuration Improvements
found in this entry's text
First cited
0No release's published evidence quotes this name. The ledger indexes the Evidence lines of every changelog on this site, so this says nobody here has ever quoted it; it says nothing about how old the name is.
Presence across releases
0The miner has never read a build containing this name. It is here because a changelog entry of ours names it, which is evidence that it existed and not evidence of which releases carried it. The inventory starts at v2.1.138 and everything older than that was never mined.
Read out of the published npm bundle release by release, and out of Anthropic's own documentation as this site captured it. Nothing on this page is a description anybody here wrote about what the settings key does. All settings keys.