Claude Code 新技巧:Stop hook 借 exit code 2 实现检查失败自动重试
开发者 Lydia Hallie 分享 Claude Code 使用技巧:通过 Stop hook 在检查失败时让 Claude 自动重试,关键是以 exit code 2 退出,此时 hook 的 stderr 会回传给 Claude 触发重试;若用 exit 1 则为非阻塞,检查失败 Claude 也会直接结束。
在 Claude Code 的日常使用中,如何让模型在自动检查未通过时继续修正,一直是工作流设计上的关注点。开发者 Lydia Hallie 近日分享了一种基于 Stop hook 的实现思路,为这一环节提供了可直接套用的配置方法。
该技巧的核心在于 hook 的退出码选择。当 Stop hook 以 exit code 2 退出时,其 stderr 内容会被返回给 Claude,从而触发模型重新尝试;而若以 exit 1 退出,则该 hook 属于非阻塞性质,即使检查未通过,Claude 也会直接结束当前流程,不再重试。
换言之,exit code 2 与 exit 1 在这一场景下承担了截然不同的语义:前者构成阻断信号并携带反馈信息,后者仅作提示而不中断执行。开发者只需调整 hook 的退出方式,即可改变 Claude 在检查失败后的行为路径。
对于依赖 Claude Code 构建自动化流程的团队而言,这一细节意味着检查环节的失败反馈可以被模型直接消费,减少人工介入重试的需要。该方法不涉及额外工具,仅依托 hook 机制本身的退出码约定。
值得注意的是,该技巧的有效性取决于 hook 是否将失败信息写入 stderr,因为只有 exit 2 场景下的 stderr 才会被回传给 Claude。开发者在实际配置时需同时关注退出码与错误输出两处细节。