用 PreToolUse hook 阻止危险命令

目标

为 Agent 工具循环添加确定性的执行前策略拦截。

步骤

1. 定义接收 input_data, tool_use_id, context 的异步 hook，并只检查目标工具字段。 [hooks]
2. 在 ClaudeAgentOptions(hooks={"PreToolUse":[HookMatcher(matcher="Bash", hooks=[...])]}) 注册，并确保 matcher 对准工具名。 [hooks]
3. 返回 hookSpecificOutput 中的 hookEventName="PreToolUse"、permissionDecision="deny" 与原因；用禁止和允许样例验证。 [hooks]

验证方式

禁止命令未执行且返回拒绝原因；安全命令仍经权限系统处理。

故障处理

若规则未拦截，确认 hook event 与 matcher 名称正确、回调返回结构合法；别只依赖脆弱的子串匹配。