Configure permissions changedagent-sdk/permissions
Nearest release: v2.1.286, published 10 hours before upstream edited the page. Shown because the two are within 24 hours of each other. Nothing here says the release caused the edit.
Upstream edited this page at 1 Oct 2026 03:28 UTC, give or take a minute or two: the time comes from Anthropic’s own sitemap rather than from a commit. This site recorded the change at 1 Oct 2026 03:37 UTC.
Upstream edited
Recorded here
Lines+9added
Lines−0removed
From line
111
where the diff opens
First seen
14 Aug 2026
this site's first read of the page
Recorded edits16to this page, all time
The whole hunk
from line 111, old and new numbered
/
from line 111
111111
112112Permission modes provide global control over how Claude uses tools. You can set the permission mode when calling `query()` or change it dynamically during streaming sessions.
113113
114If you don't set one, Claude Code picks the starting permission mode by the rules in [Which mode a session starts in](/docs/en/permission-modes#which-mode-a-session-starts-in):
115
116* A `permissions.defaultMode` from the session's [settings files](/docs/en/settings#where-settings-live) when one applies
117* Otherwise the built-in default, which can be [auto mode](/docs/en/permission-modes#eliminate-prompts-with-auto-mode)
118
119A session that starts in auto mode drops broad allow rules such as a bare `Bash` entry, as [How auto mode evaluates actions](/docs/en/permission-modes#how-auto-mode-evaluates-actions) describes. If your application relies on the `default` mode or on such a rule, pass `default` explicitly.
120
121Before TypeScript Agent SDK v0.3.286, omitting `permissionMode` was the same as passing `default`.
122
114123### Available modes
115124
116125The SDK supports these permission modes:
No line in this hunk matches that.