claude-hooks for Mac 版
Claude Code 的挂钩系统
claude-hooks 是什么
claude-hooks 是一个面向 Claude Code 的 TypeScript 钩子系统,让你用熟悉的 TypeScript 语法定制 Claude Code 的行为。它解决了钩子开发中 payload 结构不清晰、数据类型缺失的问题——所有钩子类型(PreToolUse、PostToolUse、Notification、Stop)都配有强类型接口,写代码时有完整的类型检查和自动补全,不用再猜数据结构。
通过 CLI 初始化后,会生成一套可直接编辑的 TypeScript 环境:`.claude/settings.json` 负责钩子配置,`.claude/hooks/index.ts` 是主处理逻辑入口,`lib.ts` 提供类型定义和工具函数,`session.ts` 可选用于会话追踪,会话日志保存在 `/claude-hooks-sessions/`。你可以在其中自由使用 npm 包、async/await 等常规 TypeScript 能力。
运行钩子需要 Bun,CLI 本身要求 Node.js 18 以上。适合希望以类型安全方式扩展 Claude Code 行为、又不想被无类型数据困扰的开发者。项目采用 MIT 许可证。
通过 CLI 初始化后,会生成一套可直接编辑的 TypeScript 环境:`.claude/settings.json` 负责钩子配置,`.claude/hooks/index.ts` 是主处理逻辑入口,`lib.ts` 提供类型定义和工具函数,`session.ts` 可选用于会话追踪,会话日志保存在 `/claude-hooks-sessions/`。你可以在其中自由使用 npm 包、async/await 等常规 TypeScript 能力。
运行钩子需要 Bun,CLI 本身要求 Node.js 18 以上。适合希望以类型安全方式扩展 Claude Code 行为、又不想被无类型数据困扰的开发者。项目采用 MIT 许可证。
如何安装 claude-hooks
- 打开 终端(按 ⌘ + 空格,输入“终端”)。
- 如果还没安装 Homebrew,先运行下面这条安装命令。
- 运行下面这条命令:
最近 10 个版本记录
最近一次更新为 2025-08-01,当前版本 v2.4.0,共记录最近 10 个版本。
| 版本 | 发布日期 | 类型 | 大小 | macOS | Windows | Linux |
|---|---|---|---|---|---|---|
| v2.4.0 | 2025-08-01 | 稳定版 | — | — | — | — |
| v2.3.0 | 2025-08-01 | 稳定版 | — | — | — | — |
| v2.2.0 | 2025-07-29 | 稳定版 | — | — | — | — |
| v2.1.0 | 2025-07-28 | 稳定版 | — | — | — | — |
| v2.0.1 | 2025-07-28 | 稳定版 | — | — | — | — |
| v2.0.0 | 2025-07-28 | 稳定版 | — | — | — | — |
| v1.8.1 | 2025-07-28 | 稳定版 | — | — | — | — |
| v1.8.0 | 2025-07-28 | 稳定版 | — | — | — | — |
| v1.7.1 | 2025-07-28 | 稳定版 | — | — | — | — |
| v1.7.0 | 2025-07-25 | 稳定版 | — | — | — | — |
数据来自 GitHub Releases,稳定版优先,同类按发布时间排序。
二进制包支持平台
Homebrew 官方提供的预编译包(bottle)覆盖:
- all
⚠️ 未提供 Intel Mac 的预编译包,Intel 机型需要通过 brew install --build-from-source 从源码编译。
与同类应用对比
只对比公开元数据,不做主观推荐;需要逐项对比时见对比页。
| 应用 | 版本 | 许可证 | 架构 | 近 30 天安装 |
|---|---|---|---|---|
| claude-hooks | v2.4.0 | MIT | 命令行 | 4 |
| Sculptor | 0.7.0 | — | 通用二进制 | 5 |
| CC Pocket | windows/v1.163.1+307 | — | 通用二进制 | 4 |
| aiac | v5.3.0 | Apache-2.0 | 命令行 | 8 |