Clooks

嗨 Product Hunt 👋

在 Playbook，我们在整个团队中运行复杂的智能代理工作流。但即便最完善的工作流也无法 always 适配每个个体的工作偏好——最终催生了各种奇怪的变通方案，或是大家无奈接受。

Claude Code Hooks 是硬编码在 JSON 中的 shell 命令：无需手动编写、无需组合，但如果你的工作流和团队默认配置不完全一致，就没有好办法对其进行适配。更糟糕的是，如果 Claude Hook 崩溃，操作仍会漏过——糟糕，那个破坏性命令就因为你的 bash 脚本有 bug 溜进去了。（Claude 默认会忽略抛出错误的钩子。）

Clooks 正是为解决这个痛点诞生的：为 Claude Code Hooks 提供更强大的 TypeScript 运行时。

钩子可以存放在你的代码仓库中，和代码一起提交，因此只要你的团队安装了 Clooks，所有人都会自动运行相同的防护规则。你也可以全局安装 Clooks，这样你的个人钩子可以在你电脑上的所有 Claude Code 会话中通用。

当发生崩溃时，Clooks 会捕获错误、拦截操作并通知 Claude。钩子支持完整类型标注，可独立测试、可组合，因此 Claude 可以通过自动补全帮助编写和验证钩子，而不用像写 shell 脚本那样全靠猜。

Clooks 为你提供：

崩溃拦截

- 如果钩子出错，默认会终止操作。Claude 会等待你处理。

带类型标注的 TypeScript 钩子

- 上下文类型化——不用再猜文档，直接相信类型系统就好。

内置测试能力

- Claude 可以生成真实载荷，直接通过 clooks 对代码进行测试

仓库级 + 全局钩子

- 为你的团队或仅为你自己编写完整的钩子工作流或防护规则

分层配置

- 复用并分层配置，你可以调整到最适合自己的状态

有序与并行流水线

- 搭建更复杂的流程，在不中断智能代理注意力的前提下动态重写命令

热重载

- 配置和新增钩子立即生效，无需重启会话

市场 + 插件安装

- 如果你看到一组喜欢的钩子，可以通过 clooks 安装，或是像安装 Claude 插件一样安装，clooks 会自动检测并复制钩子

Clooks 采用 MIT 许可，完全开源。

长期来看，我的目标是打造一个完整的通用智能代理生态系统：我们一次写好钩子，它们就能在所有平台运行——无论你用的是 Claude Code、Codex、OpenCode 还是未来出现的任何新工具。

你只需要用这一行命令就能安装，之后 Claude 会引导你完成：

claude plugin marketplace add codestripes-dev/clooks-marketplace && claude plugin install clooks@clooks-marketplace && claude /clooks:setup

然后尝试安装推荐的内置钩子，或是让 Claude 帮你创建一个，比如：

/clooks:create-hook 帮我写一个钩子，用来跟踪子代理执行的每一条 bash 命令。

我还有很多更多的功能想法，希望能把它打造成所有人都能用的最佳工具。我非常欢迎经常使用 Claude Code 钩子的用户提供反馈：你搭建了哪些防护规则，原生钩子在哪些地方仍然让你觉得难用？