Issue Station
Sign In
Tools hereToolbox

claude-code - 💡(How to fix) Fix [DOCS] `allowManagedHooksOnly` docs incorrectly say all plugin hooks are blocked [1 participants]

Official PRs (…)
ON THIS PAGE

Recommended Tools

×6

Utilities matched from this issue’s tags and category — try them while you read without losing context.

GitHub issue graph ai analysis

Paste a GitHub issue URL. We fetch that issue, discover linked issues from bodies/comments/timeline, collect linked pull requests, and produce a structured English report.

The report is written in English Markdown for sharing and archival.

Helpful · Quick feedback

Loading…
GitHub stats
anthropics/claude-code#46387•Fetched 2026-04-11 06:21:37
View on GitHub
Comments
0
Participants
1
Timeline
4
Reactions
0
Author
coygeekcoygeek
Participants
coygeekcoygeek
Timeline (top)
labeled ×4

Error Message

Marketplace plugins force-enabled by managed settings are the only exception and cannot be overridden. The current docs are now incorrect because they say plugin hooks are categorically blocked. That misses the managed-plugin exception and makes it unclear which hooks enterprise admins should expect to execute.

  • the plugins docs already describe force-enabled plugins as a managed exception Update the settings and hooks docs to clarify the exception, for example: | https://code.claude.com/docs/en/plugins | Already documents force-enabled marketplace plugins as a managed-settings exception |

Root Cause

The current docs are now incorrect because they say plugin hooks are categorically blocked. That misses the managed-plugin exception and makes it unclear which hooks enterprise admins should expect to execute.

RAW_BUFFERClick to expand / collapse

Documentation Type

Incorrect/outdated documentation

Documentation Location

https://code.claude.com/docs/en/settings

Section/Topic

Hook loading behavior when allowManagedHooksOnly is enabled and plugins are force-enabled by managed settings

Current Documentation

The settings page currently defines allowManagedHooksOnly as:

allowManagedHooksOnly — (Managed settings only) Prevent loading of user, project, and plugin hooks. Only allows managed hooks and SDK hooks.

It also lists this behavior:

Behavior when allowManagedHooksOnly is true:

  • Managed hooks and SDK hooks are loaded
  • User hooks, project hooks, and plugin hooks are blocked

The hooks page repeats the same rule:

Enterprise administrators can use allowManagedHooksOnly to block user, project, and plugin hooks.

At the same time, the plugins page already documents that marketplace plugins force-enabled by managed settings are a special managed case:

Marketplace plugins force-enabled by managed settings are the only exception and cannot be overridden.

What's Wrong or Missing?

Claude Code v2.1.101 changed allowManagedHooksOnly so plugin hooks from plugins force-enabled by managed settings still run.

The current docs are now incorrect because they say plugin hooks are categorically blocked. That misses the managed-plugin exception and makes it unclear which hooks enterprise admins should expect to execute.

This is especially confusing for organizations that use managed settings to force-enable approved plugins:

  • the settings and hooks docs imply those plugin hooks will never run
  • the plugins docs already describe force-enabled plugins as a managed exception
  • there is no single place that explains how these rules combine

Suggested Improvement

Update the settings and hooks docs to clarify the exception, for example:

  • user hooks and project hooks are blocked
  • ordinary user-enabled plugins are blocked
  • plugin hooks from plugins force-enabled by managed settings still run because they are part of the managed configuration

A short matrix or example would help administrators understand which hook sources remain active when allowManagedHooksOnly is true.

Impact

Medium - Makes feature difficult to understand

Additional Context

Affected Pages:

PageContext
https://code.claude.com/docs/en/settingsallowManagedHooksOnly definition and hook behavior list currently say plugin hooks are blocked
https://code.claude.com/docs/en/hooksRepeats that allowManagedHooksOnly blocks plugin hooks
https://code.claude.com/docs/en/pluginsAlready documents force-enabled marketplace plugins as a managed-settings exception

Total scope: 3 pages affected

Source: Claude Code v2.1.101 release notes

Improved plugin hooks from plugins force-enabled by managed settings to run when allowManagedHooksOnly is set

extent analysis

TL;DR

Update the documentation for allowManagedHooksOnly to clarify that plugin hooks from plugins force-enabled by managed settings are still loaded.

Guidance

  • Review the current documentation on the settings and hooks pages to identify areas where the exception for force-enabled plugins is not clearly stated.
  • Update the documentation to explicitly state that plugin hooks from plugins force-enabled by managed settings will still run when allowManagedHooksOnly is enabled.
  • Consider adding a matrix or example to illustrate the combined rules for hook loading behavior.
  • Verify the changes by reviewing the updated documentation on all affected pages (settings, hooks, and plugins).

Example

A possible update to the documentation could include a table like this:

Hook TypeallowManagedHooksOnly = falseallowManagedHooksOnly = true
User HooksLoadedBlocked
Project HooksLoadedBlocked
Plugin Hooks (user-enabled)LoadedBlocked
Plugin Hooks (force-enabled by managed settings)LoadedLoaded

Notes

The update should ensure consistency across all affected pages and provide clear guidance for enterprise administrators on the expected behavior of allowManagedHooksOnly.

Recommendation

Apply a workaround by updating the documentation to reflect the correct behavior of allowManagedHooksOnly with respect to plugin hooks from force-enabled plugins, as this will help clarify the feature's functionality for users.

Vote matrix · Quick signals

Works
Did the solution work? Tap to confirm.
Easy Fix
Was it a quick fix?
Time Saver
Did it save you time?
Blocking
Was it severely blocking?
Common Issue
Are others likely hitting this too?
Flaky / Intermittent
Is it intermittent?
Verified / Reproducible
Can you reproduce it reliably?
Loading…
#database connection#vector store#embedding generation#cache error#pipeline error

Still need to ship something?

×6

Another batch ranked right after the header list — different links, same matching logic.

Back to top recommendations

TRENDING