Choose a permission mode changedpermission-modes
Nearest release: v2.1.242, published under an hour before this site recorded the change. Shown because the two are within 24 hours of each other. Nothing here says the release caused the edit.
Recorded here
Lines+2added
Lines−18removed
From line
185
where the diff opens
First seen
14 Aug 2026
this site's first read of the page
Recorded edits92to this page, all time
The whole hunk
from line 185, old and new numbered
/
from line 185
185185
186186 A mode you pick in the mode selector is remembered per folder and takes precedence over `defaultMode` for that folder. Plan is the exception: picking it applies to the current session only.
187187
188 This example sets Plan mode as the default for new local sessions:
189
190 ```json theme={null}
191 {
192 "permissions": {
193 "defaultMode": "plan"
194 }
195 }
196 ```
188 For where `defaultMode` goes in a settings file, see the example under [Start in a different permission mode](#start-in-a-different-mode).
197189 </Tab>
198190
199191 <Tab title="Web and mobile">
from line 251
259251
260252### Set plan mode as the default
261253
262To make plan mode the default for a project's terminal sessions, set `defaultMode` in `.claude/settings.json`. Conversations the [VS Code extension](/docs/en/vs-code) starts don't read project settings for the starting permission mode. There, set `claudeCode.initialPermissionMode` to `plan` in your VS Code user settings instead. This example sets the project default:
263
264```json theme={null}
265{
266 "permissions": {
267 "defaultMode": "plan"
268 }
269}
270```
254To make plan mode the default for a project's terminal sessions, set `defaultMode` to `plan` in `.claude/settings.json`, placed as the example under [Start in a different permission mode](#start-in-a-different-mode) shows. Conversations the [VS Code extension](/docs/en/vs-code) starts don't read project settings for the starting permission mode. There, set `claudeCode.initialPermissionMode` to `plan` in your VS Code user settings instead.
271255
272256<h2 id="eliminate-prompts-with-auto-mode">
273257 Eliminate permission prompts with auto mode
No line in this hunk matches that.