Follow Discord
Sweep 22 Oct 2026 · 04:32Z Build v2.1.308 527 read Stable v2.1.308 Latest v2.1.308 Next v2.1.308 Feeds RSS JSON llms.txt llms-full.txt Unofficial
Home / Reference / Settings keys

permissions.defaultMode

setting never mined documented JSON

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.

First seen — never in a mined build
Last seen — never in a mined build
Builds0 / 149on this box, as of v2.1.308
Written about v1.0.54 first named in a changelog, 16 Jul 2025

In the changelogs

11

Releases whose published page names permissions.defaultMode.

  1. 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 autoCompactWindow when it is set for any model under modelSettings

    found in this entry's text

  2. 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

  3. 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

  4. 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

  5. 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

  6. 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

  7. 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

  8. 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

  9. 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

  10. 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

  11. v1.0.54
    Settings Configuration Improvements

    found in this entry's text

First cited

0

No 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

0

The 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.

Feedback