Claude Agent SDK新增拦截：钩子失败可阻止动作执行

Claude Agent SDK新增了一项与钩子（hook）失败相关的控制能力：当开发者配置的钩子回调执行失败时，SDK可以阻止对应的动作继续执行，而不是让流程带着未知状态往下走。

按OpenTools的整理，这项能力由matcher设置配合完成，matcher决定哪些动作会被纳入拦截范围；同时SDK会在流式输出中给出警告，提示某个回调失败。两者结合，让失败的钩子从一条日志，变成一次可被感知、可被阻断的运行时事件。

钩子是Agent开发中常见的扩展点：在模型调用工具前后、会话开始或结束时插入自定义逻辑，做权限检查、参数校验、审计记录或者外部策略查询。过去这类逻辑多为建议性的，即使检查失败，动作仍可能继续，结果取决于模型是否愿意听从。

把失败与拦截绑定，等于把一部分安全边界从提示词搬到代码执行链路上。对做企业级Agent的团队来说，这更接近传统中间件的失败关闭语义：策略服务不可用或校验报错时，宁可停下，也不要放行一个未经检查的工具调用。

这也解释了为什么这项改动值得关注。Agent系统最难的从来不是让模型多做事，而是在它做错事之前拦住它。钩子层面的阻断提供了确定性的刹车，不依赖模型对指令的服从程度，也不需要在每次调用后做事后审计。

代价是开发者要重新思考失败处理。哪些钩子允许失败后继续、哪些必须阻断、阻断后如何向用户或上游系统回报，都需要显式配置；matcher写得太宽会误伤正常动作，写得太窄又等于没有护栏。

接下来要看的是默认行为如何演进：如果SDK在更多场景下默认采用失败即阻断，现有的Agent实现可能需要调整错误处理路径；同时，钩子失败的流式警告如何被监控系统消费，也会影响这套机制在生产环境里的实际价值。