Search the documentation
18 pages for defaultmode.
Titles and paths first, then pages whose text carries it. Each row opens that page as this site last read it.
Set up Claude Code for your organization
Claude Code CLI · in the page
admin-setup
…permission mode, or remove auto mode. The VS Code extension reads a `defaultMode` you set only on Pro, Max, and Team plans; [Switch permission modes](/docs/en/permission-modes#switch-permission-modes…
Agent SDK reference - TypeScript
Claude Code CLI · in the page
agent-sdk/typescript
…cute the admin-configured `policyHelper` subprocess. The `permissions.defaultMode` field is returned as-is from all tiers including project settings. In a live session, the CLI [ignores `defaultMode:…
Orchestrate teams of Claude Code sessions
Claude Code CLI · in the page
agent-teams
…definition's `model`. 4. The lead's current model. <Note> `teammateDefaultModel` was removed in v2.1.234; Claude Code ignores a leftover value. Name the model in your prompt or set `CLAUDE_CODE_SUB…
Claude Code changelog
Claude Code CLI · in the page
changelog
…I, `--help`, VS Code, and JetBrains; `--permission-mode manual` and `"defaultMode": "manual"` are accepted alongside `default` * Fixed a crash at startup when `disabledMcpServers` or `enabledMcpServ…
CLI reference
Claude Code CLI · in the page
cli-reference
…elp` lists it in place of `default`, and both values work. Overrides `defaultMode` from settings files. Without this flag or `--dangerously-skip-permissions`, a new session starts in the permission mo…
Desktop application
Claude Code CLI · in the page
desktop
…nual. To set a default mode for new local sessions, add `permissions.defaultMode` to your [settings file](/docs/en/settings#where-settings-live). The desktop app reads the same settings files as the…
Hooks reference
Claude Code CLI · in the page
hooks
…Permissions`, `--allow-dangerously-skip-permissions`, or `permissions.defaultMode: "bypassPermissions"` in settings, and the mode is not disabled by [`permissions.disableBypassPermissionsMode`](/docs/…
Automate actions with hooks
Claude Code CLI · in the page
hooks-guide
…Permissions`, `--allow-dangerously-skip-permissions`, or `permissions.defaultMode: "bypassPermissions"` in settings, and not disabled by [`permissions.disableBypassPermissionsMode`](/docs/en/permissio…
Deploy managed settings
Claude Code CLI · in the page
managed-settings
…, login pins such as `forceLoginOrgUUID`, `modelPicker`, `permissions.defaultMode` | | `env` | Merges per variable across admin sources under either setting, as…
Choose a permission mode
Claude Code CLI · in the page
permission-modes
…ou type the value, for example `claude --permission-mode manual` or `"defaultMode": "manual"`. The Manual label and the `manual` alias require Claude Code v2.1.200 or later. The desktop app's label do…
Configure permissions
Claude Code CLI · in the page
permissions
…for when to use each one. To change the mode sessions start in, set `defaultMode` in your [settings files](/docs/en/settings#where-settings-live). [Which mode a session starts in](/docs/en/permission…
Customize sessions in self-hosted environments
Claude Code CLI · in the page
self-hosted-environments-configuration
…evel `settings.json`, since that file isn't repository-committed. A `defaultMode` of `auto` is only honored from the image-wide or user-level settings file, so a checked-out repository can't grant it…
Manage sessions
Claude Code CLI · in the page
sessions
…ain, enable it at launch with one of its launch flags or `permissions.defaultMode: "bypassPermissions"` in [settings](/docs/en/settings-reference#permission-settings) | | `plan` | Termina…
Claude Code settings
Claude Code CLI · in the page
settings
…| `false` | | `teammateDefaultModel` | Removed in v2.1.234; Claude Code ignores a leftover value. See [Specify teammates and models](/docs/en/agent…
Claude Code settings reference
Claude Code CLI · in the page
settings-reference
…n settings | Any file | | [`permissions.defaultMode`](#permissions-defaultmode) | Set the [permission mode](/docs/en/permission-…
Week 13 · March 23–27, 2026
Claude Code CLI · in the page
whats-new/2026-w13
…claude/settings.json {3} theme={null} { "permissions": { "defaultMode": "auto" } } ``` <a className="digest-feature-link" href="/docs/docs/en/permission-modes">Permission modes…
Week 32 · August 3–7, 2026
Claude Code CLI · in the page
whats-new/2026-w32
…claude/settings.json {3} theme={null} { "permissions": { "defaultMode": "auto" } } ``` <p className="digest-feature-try">New sessions then show <code>auto mode on</code> in the…
Changelog
Claude Documentation · in the page
cowork/changelog
…ator appears while the connection is restored. * Fixed `permissions.defaultMode` in Claude Code settings being ignored for new sessions after a per-folder permission mode had been chosen. * Fixed…