{"name":"permissionMode","slug":"permissionmode","family":"setting","title":"Settings keys","noun":"settings key","description":"SDK callers can let the CLI pick the permission mode from settings instead of forcing \"default\".","description_source":"entry","described_by":{"version":"2.1.225","anchor":"sdk-can-defer-permission-mode-resolution-to-the-cli"},"presence":{"first_seen":null,"removed_in":null,"in_current_build":false,"newest_mined":"2.1.319","builds":0,"mined_builds":159,"first_cited":{"version":"2.1.75","released_at":"2026-03-13 15:51:07","spans":5}},"aliases":[],"entries":[{"version":"2.1.301","anchor":"auto-mode-classifier-request-can-now-carry-a-classifierjudg","heading":"Auto mode safety check can be tagged outside auto mode","line":"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","released_at":"2026-10-15 14:34:23","reason":"found in this entry's text"},{"version":"2.1.296","anchor":"warning-for-unrecognized-agent-frontmatter-keys-with-did-yo","heading":"Plugin agents now warn about misspelled and unsupported settings","line":"Plugin agent files now log a warning for settings Claude Code does not recognize, suggest the likely intended name, and flag more ignored ones","released_at":"2026-10-09 16:58:10","reason":"found in this entry's text"},{"version":"2.1.292","anchor":"auto-mode-subagents-fall-back-to-parent-permission-mode-when","heading":"Subagents set to auto mode keep the parent's mode when auto is unavailable","line":"A subagent whose permissionMode is auto now keeps the main session's permission mode, with a warning, when auto mode is not available","released_at":"2026-10-06 17:10:31","reason":"found in this entry's text, named in this entry"},{"version":"2.1.281","anchor":"disallowedtools-forwarded-in-session-spec","heading":"disallowedTools forwarded in session spec","line":"Session launch settings now pass on the list of tools that are not allowed, along with permission mode, effort and model","released_at":"2026-09-23 17:01:17","reason":"found in this entry's text"},{"version":"2.1.278","anchor":"modelcwd-status-panel-now-shows-the-current-permission-mode","heading":"Model\/cwd status panel now shows the current permission mode","line":"The status panel that shows Model, MCP, and theme now also lists the current permission mode","released_at":"2026-09-19 01:48:59","reason":"found in this entry's text"},{"version":"2.1.277","anchor":"resume-now-also-validates-a-messages-turnorigin-field","heading":"Resume now also validates a message's turnOrigin field","line":"Resuming a session now also checks and strips invalid turnOrigin values from user messages","released_at":"2026-09-18 16:22:26","reason":"found in this entry's text"},{"version":"2.1.274","anchor":"slash-command-dispatched-user-messages-now-carry-an-explicit","heading":"Slash-command-dispatched user messages now carry an explicit permissionMode field","line":"Messages created from slash commands now explicitly carry the current permission mode","released_at":"2026-09-16 22:36:09","reason":"found in this entry's text"},{"version":"2.1.267","anchor":"new-workflow-keyword-trigger-setting-tracked-via-a-settings","heading":"New workflow keyword-trigger setting tracked via a settings change-log abstraction","line":"Settings toggles like verbose mode and a new keyword-trigger option now go through a unified change-log system","released_at":"2026-09-09 18:25:42","reason":"found in this entry's text"},{"version":"2.1.259","anchor":"proactivitylevel-plumbed-through-sessiontask-creation","heading":"proactivityLevel plumbed through session\/task creation","line":"A proactivityLevel field now flows through session creation, agent launch, config parsing and telemetry, with no UI or semantics yet.","released_at":"2026-09-02 21:21:42","reason":"found in this entry's text"},{"version":"2.1.259","anchor":"new-proactivitylevel-parameter-threaded-into-remoteteleport","heading":"New proactivityLevel parameter threaded into remote\/teleport session creation","line":"Remote session creation events accept a proactivityLevel field alongside permissionMode, ultraplan, title and thinking.","released_at":"2026-09-02 21:21:42","reason":"found in this entry's text"}],"entries_total":20,"docs":[{"source":"api","path":"managed-agents\/migration","title":"migration","documented":false},{"source":"claude-code","path":"agent-sdk\/agent-loop","title":"How the agent loop works","documented":false},{"source":"claude-code","path":"agent-sdk\/configuration","title":"Configure your agent","documented":false},{"source":"claude-code","path":"agent-sdk\/custom-tools","title":"Give Claude custom tools","documented":false},{"source":"claude-code","path":"agent-sdk\/file-checkpointing","title":"Rewind file changes with checkpointing","documented":false},{"source":"claude-code","path":"agent-sdk\/mcp","title":"Connect to external tools with MCP","documented":false},{"source":"claude-code","path":"agent-sdk\/permissions","title":"Configure permissions","documented":false},{"source":"claude-code","path":"agent-sdk\/python","title":"Agent SDK reference - Python","documented":false},{"source":"claude-code","path":"agent-sdk\/quickstart","title":"Quickstart","documented":false},{"source":"claude-code","path":"agent-sdk\/subagents","title":"Subagents in the SDK","documented":false}],"docs_total":12,"gates":[],"related":[],"url":"https:\/\/changelogs.core-directive.com\/reference\/setting\/permissionmode","family_url":"https:\/\/changelogs.core-directive.com\/reference\/setting.json"}