permissionMode
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.
SDK callers can let the CLI pick the permission mode from settings instead of forcing "default".
Not Anthropic's. This is the line from the earliest changelog entry here that named it, v2.1.225.
In the changelogs
20Releases whose published page names permissionMode.
-
v2.1.301
Auto mode safety check can be tagged outside auto mode
The auto mode classifier's requests can now carry an extra tag, and when they do the auto mode value is sent whatever the permission mode
found in this entry's text
-
v2.1.296
Plugin agents now warn about misspelled and unsupported settings
Plugin agent files now log a warning for settings Claude Code does not recognize, suggest the likely intended name, and flag more ignored ones
found in this entry's text
-
v2.1.292
Subagents set to auto mode keep the parent's mode when auto is unavailable
A subagent whose permissionMode is auto now keeps the main session's permission mode, with a warning, when auto mode is not available
found in this entry's text, named in this entry
-
v2.1.281
disallowedTools forwarded in session spec
Session launch settings now pass on the list of tools that are not allowed, along with permission mode, effort and model
found in this entry's text
-
v2.1.278
Model/cwd status panel now shows the current permission mode
The status panel that shows Model, MCP, and theme now also lists the current permission mode
found in this entry's text
-
v2.1.277
Resume now also validates a message's turnOrigin field
Resuming a session now also checks and strips invalid turnOrigin values from user messages
found in this entry's text
-
v2.1.274
Slash-command-dispatched user messages now carry an explicit permissionMode field
Messages created from slash commands now explicitly carry the current permission mode
found in this entry's text
-
v2.1.267
New workflow keyword-trigger setting tracked via a settings change-log abstraction
Settings toggles like verbose mode and a new keyword-trigger option now go through a unified change-log system
found in this entry's text
-
v2.1.259
proactivityLevel plumbed through session/task creation
A proactivityLevel field now flows through session creation, agent launch, config parsing and telemetry, with no UI or semantics yet.
found in this entry's text
-
v2.1.259
New proactivityLevel parameter threaded into remote/teleport session creation
Remote session creation events accept a proactivityLevel field alongside permissionMode, ultraplan, title and thinking.
found in this entry's text
-
v2.1.257
Inherit-mode demotion gated by tengu_agentview_inherit_mode_demote
A gate decides whether an inherited permission mode is recorded as inherited or flattened away.
found in this entry's text
-
v2.1.257
Agent/settings permission-mode 'widening' now blocked with new telemetry
An agent definition's permissionMode can no longer widen the mode inherited from its parent context.
named in this entry, found in this entry's text
-
v2.1.257
Permission mode can now be explicitly marked as inherited
Dispatch now records whether a permission mode was set explicitly or inherited from the launcher.
found in this entry's text
-
v2.1.239
Deferred tool calls carry trace context to hooks
Deferred tool-call notifications now carry a traceparent so hook consumers can correlate them.
found in this entry's text
-
v2.1.235
Cloud/remote task creation carries an effort level, and teleport passes a permission mode
Remote/cloud task creation now carries an effort level and teleport passes a resolved permission mode
found in this entry's text
-
v2.1.234
Permission mode changes are announced on the stream-json output
Scripted sessions now get a stream-json status message whenever the permission mode changes.
found in this entry's text
-
v2.1.233
Proactivity level wired into API request telemetry but never set
Request telemetry has a slot for a proactivity level, but it is always empty.
found in this entry's text
-
v2.1.225
SDK can defer permission mode resolution to the CLI
SDK callers can let the CLI pick the permission mode from settings instead of forcing "default".
found in this entry's text
-
v2.1.75
Permission Mode Change Events
found in this entry's text
-
v2.1.70
Fork Agent [Feature-Flagged]
found in this entry's text
First cited
5The earliest release whose published evidence quoted permissionMode was v2.1.75, 13 Mar 2026. That is the oldest release this project wrote about it, so it is a floor on the name's age and not the release that introduced it. It is not a presence reading: which builds carried the name is the table below.
Presence across releases
0The 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.