settings.json

allowManagedHooksOnly

型boolean記述場所管理者設定のみ

(管理設定のみ) ユーザー、プロジェクト、プラグイン独自のフック読み込みを禁止し、管理フックとSDKフックのみを許可します。

記述例

{
  "allowManagedHooksOnly": true
}

使い方・用途

  • 組織全体で信頼されたフックのみを実行させたい場合に使用し、ユーザーが勝手に追加したフックによる意図しない動作を防止します。
  • 管理者が enabledPlugins で強制有効化したプラグイン内のフックは例外として実行されるため、安全性を保ちつつ共通ツールを展開できます。
英語原文(公式ドキュメントより)

(Managed settings only) Prevent loading of user, project, and plugin hooks. Only allows managed hooks and SDK hooks. See https://code.claude.com/docs/en/settings#hook-configuration

関連ドキュメント

関連する変更履歴

v2.1.140(1件)

Fixed
disableAllHooks または allowManagedHooksOnly が設定されている場合に /goal が応答なしになる問題を修正し、明確なメッセージを表示するように改善
英語原文を表示
Fixed /goal silently hanging when disableAllHooks or allowManagedHooksOnly is set — now shows a clear message instead of an indicator that never resolves

変更後

管理者設定などによって特定の機能が使えない状況でも、原因が即座に分かるため、ユーザーの混乱を防げます。

関連ドキュメント

v2.1.101(1件)

Improved
管理設定で allowManagedHooksOnly が有効な場合でも、強制有効化されたプラグインのフックが実行されるよう改善
英語原文を表示
Improved plugin hooks from plugins force-enabled by managed settings to run when allowManagedHooksOnly is set

変更後

セキュリティを確保しつつ、組織で推奨される自動化ツールを確実に動作させることができます。

関連ドキュメント