Skip to content
BENIBIX Learn

permissions.defaultMode

AI⌨️ Claude CodeConfiguration

Also known as defaultMode, default permission mode

The key that sets which permission mode a new session starts in.

Think of it like

It is like the setting a door lock starts in each morning.

Example

Jack pressed Shift+Tab at the start of each session. Now he sets defaultMode to acceptEdits once.

Why it matters

The mode decides how often Claude stops to ask you, from the first turn.

Definition

permissions.defaultMode is a settings key. It sets the mode a new session starts in. The six values are default, acceptEdits, plan, auto, dontAsk and bypassPermissions. Left unset, the built-in default is used. Auto and bypass do not work from a repo file. Put them in your user file.

Example code

json
{
  "permissions": {
    "defaultMode": "acceptEdits"
  }
}
Let Claude edit files without asking, from the start.
A repo file cannot start you in auto or bypass mode.

Common mistake

Putting auto in a project file. It does not take effect from there, so it goes in your user file.

Key takeaways

  1. 1
    Starting mode. Six values.
  2. 2
    Unset uses default. Built in.
  3. 3
    Auto from user file. Not the repo.