settings.json

hooks.PermissionRequest

型array

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

使い方・用途

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

Hooks that run when a permission dialog appears

関連ドキュメント

関連する変更履歴

v2.1.300(2件)

Changed
Cowork クラウドセッションの PermissionRequest フックを変更した: フックの allow 内での setMode 更新は現在無視され、承認の残りの部分は引き続き適用される
英語原文を表示
Changed PermissionRequest hooks in Cowork cloud sessions: a setMode update in a hook's allow is now ignored; the rest of the approval still applies

変更後

Cowork のクラウドセッションでも、PermissionRequest フックによる権限更新が通常の Claude Code と同じ一貫した挙動に揃い、フックの allow 内の setMode は適用されず、承認内容が意図どおり反映されるようになった。

関連ドキュメント

Changed
フックを変更した: PreToolUse および PermissionRequest フックからの updatedInput が Claude 自身の入力と同様に検証されるようになり、未知のキーは破棄され、ツールが拒否する入力はその呼び出しを拒否する
英語原文を表示
Changed hooks: updatedInput from PreToolUse and PermissionRequest hooks is now validated like Claude's own input: unknown keys are dropped, and input the tool rejects denies the call

変更後

フックが返す updatedInput が、Claude 本体のツール入力と同じ検証を受けるようになり、不正な引数が権限評価前に弾かれて、予期しない入力でツールが実行されるのを防げる。

v2.1.299(2件)

Changed
Windows: Git for Windows がインストールされていない環境で、シェルを指定しない PreToolUse フックや PermissionRequest フックがフェイルオープンする問題を修正した。失敗したガードは現在呼び出しをブロックする
英語原文を表示
Windows: Fixed PreToolUse and PermissionRequest hooks that set no shell failing open when Git for Windows isn't installed; a guard that fails now blocks the call

変更後

Git for Windows がインストールされていない環境でも、シェルを指定していない PreToolUse フックや PermissionRequest フックの失敗時に、ツールの実行を確実にブロックできるようになる。

関連ドキュメント

Changed
Cowork クラウドセッションの auto モードを変更した。PermissionRequest フックはシェルコマンドやサブエージェントを承認できなくなった。それらのプロンプトは待機するか拒否される
英語原文を表示
Changed auto mode in Cowork cloud sessions: a PermissionRequest hook can no longer approve shell commands or subagents; those prompts wait or are denied

変更後

Cowork クラウドセッションの auto モードで、PermissionRequest フックによるシェルコマンドやサブエージェントの自動承認ができなくなり、重要な操作は人の確認待ちになるか拒否されるようになる。これにより、フックの設定ミスで意図しないコマンドが無人で実行されるリスクを減らせる。

関連ドキュメント

v2.1.288(1件)

Fixed
マッチ処理に失敗した場合やツールの入力を JSON にシリアライズできなかった場合に、PreToolUse フックと PermissionRequest フックがスキップされる問題を修正した。現在はその呼び出しをブロックする
英語原文を表示
Fixed PreToolUse and PermissionRequest hooks being skipped when matching them failed or the tool's input could not be serialized to JSON; the call is now blocked

関連ドキュメント

v2.1.280(1件)

Changed
PermissionRequest フックを変更し、エージェントタイプのフックはそこで実行されなくなった。その回答はリクエストの許可・拒否に使えないためで、現在はコマンドまたは http フックを案内するエラーを表示する
英語原文を表示
Changed PermissionRequest hooks: an agent-type hook no longer runs there, since its answer could never allow or deny the request; it now shows an error pointing to command or http hooks

変更後

PermissionRequest フックからエージェント型フックが実行されなくなり、許可・拒否の判定に反映されない無駄な実行を防げる。誤って設定している場合は、コマンド型や HTTP 型のフックを使うようエラーで案内される。

関連ドキュメント

v2.1.268(1件)

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

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

関連ドキュメント

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

関連ドキュメント