What
Even with the rollout flag on, the loader filters which plugins may contribute hooks. Two managed settings keys control it: disableAllHooks blocks every plugin, and allowManagedHooksOnly restricts loading to managed plugins.
Details
- Running with --bare disables hooks entirely.
- When two plugins share a name, only the first loads: the managed one, or otherwise the one from the earlier source.
- Every exclusion is logged with the reason it was excluded.
Evidence
only managed plugins run (allowManagedHooksOnly / disableAllHooks)
Strings lifted out of the shipped bundle, so the claim above can be checked against them.
The entry above is what we published on the day. These lines were added later, as Anthropic's own pages caught up, and they sit beside the original rather than replacing it.
Confirmed since
Anthropic's documentation has since written up disableAllHooks, on MCP, plugins, skills, and hooks.
Claude Code [managed settings](/docs/third-party/claude-desktop/code#interaction-with-claude-code%E2%80%99s-own-managed-settings) deployed on the device govern these hooks as they do in the Claude Code CLI: `disableAllHooks` turns them off…third-party/claude-desktop/extensions see the edit
Confirmed since
Anthropic's documentation has since written up allowManagedHooksOnly, on MCP, plugins, skills, and hooks.
Claude Code [managed settings](/docs/third-party/claude-desktop/code#interaction-with-claude-code%E2%80%99s-own-managed-settings) deployed on the device govern these hooks as they do in the Claude Code CLI: `disableAllHooks` turns them off…third-party/claude-desktop/extensions see the edit
Added since
A small documentation edit on CLI reference touched a line naming --bare after this was published.
If you start Claude Code in [bare mode](/docs/en/headless#start-faster-with-bare-mode), by passing `--bare` or setting `CLAUDE_CODE_SIMPLE=1`, recording stays off unless you pass `--system-prompt-snapshot on`. Before v2.1.268, sessions tha…cli-reference see the edit
Confirmed since
Anthropic's documentation has since written up --bare, on Modifying system prompts.
If you start Claude Code in [bare mode](/docs/en/headless#start-faster-with-bare-mode) by passing `--bare` through `extraArgs` or setting `CLAUDE_CODE_SIMPLE=1`, recording stays off unless you set `snapshot: true` on the object form of `sy…agent-sdk/modifying-system-prompts see the edit
One source agreesOne thing we can check says the same as this entry.
Anthropic's documentation agrees
Anthropic's documentation has since written up --bare, on Modifying system prompts.