settings.json

hooks.PermissionRequest

array

権限確認ダイアログが表示される際に実行されるフック。

使い方・用途

  • 特定の操作(例:プラン終了後の実行確認)を自動承認して対話の手間を省いたり、独自の権限チェックロジックを組み込んだりします。
  • 入力を書き換えた後の再チェックやバイパス禁止設定など、組織のセキュリティポリシーを遵守した権限制御が可能です。
英語原文(公式ドキュメントより)

Hooks that run when a permission dialog appears

関連ドキュメント

関連する変更履歴

v2.1.268(1件)

Fixed
--print モードで PermissionRequest hooks が発火しない問題を修正した。
英語原文を表示
Fixed PermissionRequest hooks not firing in --print mode

変更前

--print モードでは、PermissionRequest hooks が発火せず、権限確認のタイミングで hooks を実行できなかった。

変更後

--print モードであっても、PermissionRequest hooks が権限確認のタイミングで正しく発火するようになった。

ユーザーへの恩恵

ヘッドレス実行中も hooks による権限の自動許可・拒否が機能し、自動化処理を安全に制御できるようになる。

関連ドキュメント

v2.1.248(1件)

Fixed
PermissionRequest や PreToolUse フックが無効な回答を出力した際、バックグラウンドセッションが黙って待機していた問題を修正しました。claude agents の行にフック名とスキーマエラーが表示されるようになりました。
英語原文を表示
Fixed background sessions waiting silently when a PermissionRequest or PreToolUse hook prints an invalid answer: the claude agents row now names the hook and the schema error

変更前

PermissionRequest や PreToolUse フックが無効な JSON を出力した際、バックグラウンドセッションはエラーメッセージを表示せずに待機し続けました。ユーザーはどのフックが失敗したのか、何が問題だったのかを知ることができませんでした。

変更後

claude agents の行に、どのフックが無効な回答を出力したのか、そしてスキーマエラーの内容が表示されるようになりました。これにより、バックグラウンドセッションの問題を特定しやすくなりました。

ユーザーへの恩恵

フックのエラー原因を即座に特定できるようになり、バックグラウンドセッションの待機状態を解消できます。

関連ドキュメント

v2.1.141(1件)

Fixed
折りたたまれた読み取り/検索グループ内で、「PermissionRequestフックにより許可されました」というメッセージが各ツール呼び出しごとに重複して表示される問題を修正。
英語原文を表示
Fixed "Allowed by PermissionRequest hook" repeating once per tool call under a collapsed read/search group

v2.1.110(1件)

Fixed
PermissionRequestフックによる入力更新後にpermissions.denyルールが再チェックされない問題、およびバイパス設定が制限を無視できる問題を修正
英語原文を表示
Fixed PermissionRequest hooks returning updatedInput not being re-checked against permissions.deny rules; setMode:'bypassPermissions' updates now respect disableBypassPermissionsMode

変更前

フック機能で入力を書き換えた際、禁止ルールをすり抜けてしまう可能性がありました。また、管理ポリシーで禁止されている場合でも、フックから「バイパスモード」へ移行できてしまうセキュリティ上の懸念がありました。

変更後

更新された入力に対して再度厳格な権限チェックが行われ、管理者設定による「バイパス禁止」も常に尊重されるようになりました。

ユーザーへの恩恵

組織で設定したセキュリティポリシーをバイパスされるリスクが解消され、フック機能を安心して業務に組み込めます。

関連ドキュメント

v2.0.54(1件)

Changed
Hooks: Enable PermissionRequest hooks to process 'always allow' suggestions and apply permission updates

v2.0.45(1件)

Added
Added PermissionRequest hook to automatically approve or deny tool permission requests with custom logic

関連ドキュメント