All settings changedsettings-reference
Nearest release: v2.1.287, published 5 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 22:58 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 23:07 UTC.
Upstream edited
Recorded here
Lines+11added
Lines−0removed
From line
4,014
where the diff opens
First seen
21 Aug 2026
this site's first read of the page
Recorded edits110to this page, all time
The whole hunk
from line 4014, old and new numbered
/
This page is larger than the 256 KiB this site keeps, so one side of the diff below stops where the stored text does.
from line 4014
40144014* **In managed settings**: Claude Code disables every configured hook, including managed ones, and keeps running the hooks the [Agent SDK](/docs/en/agent-sdk/overview) registers in process
40154015* **In any other settings file**: Claude Code disables user, project, local, and plugin hooks; managed hooks, Agent SDK hooks, and hooks from plugins force-enabled in managed [`enabledPlugins`](#enabledplugins) keep running
40164016
4017The key also stops [mods](/docs/en/plugins/mods/overview), which are plugins whose code registers hooks:
4018
4019* **In managed settings**: the mods in every installed plugin stop, your organization's included
4020* **In any other settings file**: the mods you installed stop, and [your organization's mods](/docs/en/plugins/mods/admin#install-your-organizations-mods) keep running
4021
4022Mods built into Claude Code keep running in both cases. Each has [its own switch](/docs/en/plugins/mods/overview#mods-built-into-claude-code).
4023
40174024Keeping Agent SDK hooks running when managed settings set this key requires Claude Code v2.1.242 or later.
40184025
40194026The [`/goal`](/docs/en/goal) command can't run while hooks are disabled, and the `/hooks` menu shows a notice instead of your hooks.
from line 4138
41314138Set the [agent count Claude aims for](/docs/en/workflows#set-a-size-guideline) in the dynamic workflows it writes. Claude Code sends the value to Claude as advice, not an enforced cap: `"small"` asks for fewer than 5 agents, `"medium"` fewer than 10, and `"large"` fewer than 50. Choose `"small"` when you want to bound what a workflow spends. Requires Claude Code v2.1.219 or later.
41324139
41334140* **Scope**: [`Any file`](#scopes). A value there takes precedence over the **Dynamic workflow size** choice in `/config`, which Claude Code stores in `~/.claude.json`, and Claude Code hides that row while a settings file sets the key.
4134* **Type**: string, one of:
4135 * `"unrestricted"`: no guideline, so Claude sizes the workflow to the task
4136 * `"small"`: Claude aims for fewer than 5 agents
4137 * `"medium"`: Claude aims for fewer than 10 agents
4138 * `"large"`: Claude aims for fewer than 50 agents
4139* **Default**: `"medium"`, or `"small"` when you're signed in on a Pro plan with Claude Code v2.1.271 or later
4140
4141```json settings.json theme={null}
4142{
4143 "workflowSizeGuideline": "small"
4144}
4145```
4146
4147Requires Claude Code v2.1.219 or later; on v2.1.202 through v2.1.218, set the guideline i
4141* **Type**: string, one o
No line in this hunk matches that.