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.
What it is
Set the [permission mode](/docs/en/permission-modes#which-mode-a-session-starts-in) new sessions start in
Anthropic's own wording. Read off Claude Code settings reference, captured 2026-08-28.
Presence across releases
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.
Changelog entries naming it
-
v2.1.238Carrying 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
-
v2.1.225Auto-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.225VS 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
Documentation pages
- Claude Code settings reference reference table Claude Code CLI
- Set up Claude Code for your organization mentions it Claude Code CLI
- Agent SDK reference - TypeScript mentions it Claude Code CLI
- Desktop application mentions it Claude Code CLI
- Hooks reference mentions it Claude Code CLI
- Automate actions with hooks mentions it Claude Code CLI
- Deploy managed settings mentions it Claude Code CLI
- Choose a permission mode mentions it Claude Code CLI
- Manage sessions mentions it Claude Code CLI
- Changelog mentions it Claude Documentation
A reference table page is one whose own table defines this name, and it is where the description above came from. A page that mentions it carries the name somewhere in its text and may say nothing about it at all. Every page carrying it.
Names beside it
Every settings key in the inventory starting permissions, up to twelve of them.
permissionsSet allow, ask, and deny rules and the starting [permission mode](/docs/en/permission-modes) 2.1.138
permissions.additionalDirectoriesGive Claude file access to [directories outside the current one](/docs/en/permissions#working-directories) never mined
permissions.disableAutoModeSet disableAutoMode to "disable" to stop Claude Code ever falling back to auto permission mode. 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.