hooks.PermissionRequest

settings.json型array

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

使い方・用途

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

Hooks that run when a permission dialog appears

関連ドキュメント

関連する変更履歴

v2.1.319(1件)

クラウドセッションが新しいワーカーに移動する際、PermissionRequest フックが追加するものなどのセッションスコープの deny ルールや ask ルールが失われる問題を修正した
英語原文を表示
Fixed cloud sessions losing session-scoped deny and ask permission rules, such as those a PermissionRequest hook adds, when the session moves to a new worker

関連ドキュメント

v2.1.310(1件)

Windows: Git Bash が存在せず、フックのコマンドが引用符で囲まれた文字列のみ(引用符付きパスなど)の場合に、PreToolUse フックと PermissionRequest フックがツール呼び出しを通過させてしまう問題を修正した
英語原文を表示
Windows: Fixed PreToolUse and PermissionRequest hooks letting a tool call through when Git Bash is missing and the hook's command is only quoted strings, such as a quoted path

変更後

Git Bash がインストールされていない Windows 環境でも、引用符で囲んだパスだけで構成された PreToolUse や PermissionRequest フックが正しく評価され、意図したとおりにツール実行を制御できるようになる。

関連ドキュメント

v2.1.309(1件)

PowerShell で実行されるフックが、フックのプログラムが終了コード 2 で終了してもブロックされない問題を修正した。また、Windows において Git for Windows がインストールされていない場合に、'shell': 'powershell' を指定した PreToolUse および PermissionRequest フックがフェイルオープンする問題を修正した。
英語原文を表示
Fixed hooks that run in PowerShell not blocking when the hook's program exits with code 2, and on Windows PreToolUse and PermissionRequest hooks with "shell": "powershell" failing open when Git for Windows isn't installed

関連ドキュメント

v2.1.300(2件)

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 は適用されず、承認内容が意図どおり反映されるようになった。

関連ドキュメント

フックを変更した: 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件)

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 フックの失敗時に、ツールの実行を確実にブロックできるようになる。

関連ドキュメント

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件)

マッチ処理に失敗した場合やツールの入力を 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件)

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件)

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

v2.1.248(1件)

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件)

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

v2.1.110(1件)

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件)

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

v2.0.45(1件)