# permissions.defaultMode

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

**Field:** Artificial Intelligence  
**Category:** Claude Code  
**Also known as:** defaultMode, default permission mode

## Think of it like

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

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

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

## Example code

```json
{
  "permissions": {
    "defaultMode": "acceptEdits"
  }
}
```

Let Claude edit files without asking, from the start.

## Why it matters

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

## Common mistake

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

## Three principles

- **Starting mode.** Six values.
- **Unset uses default.** Built in.
- **Auto from user file.** Not the repo.

## Related terms

- [Permission Mode](https://learn.benibix.com/term/ai/permission-mode)
- [Auto Mode](https://learn.benibix.com/term/ai/auto-mode)
- [Bypass Permissions Mode](https://learn.benibix.com/term/ai/bypass-permissions-mode)

![Which settings files can start a session in each permission mode: auto and bypassPermissions only take effect from the user file.](https://learn.benibix.com/diagrams/default-mode-files.svg)

---

Source: https://learn.benibix.com/term/ai/default-mode-setting
Author: Behnia Zarei (a developer in Vienna, Austria, who builds and teaches data, AI and business intelligence at BENIBIX)
Publisher: BENIBIX Learn (https://learn.benibix.com/)
Last updated: 2026-11-17
Licence: CC BY 4.0 (https://creativecommons.org/licenses/by/4.0/). Quote freely with attribution.
