什么是 hookify

• hookify 是为 Claude Code 引入 零 JSON 配置的 Hook 创建方案，让开发者无需直接编辑复杂的 JSON 配置，就能通过自然语言命令或 Markdown 规则快速生成并启用 Hook 防护规则或自动化操作。

• 它简化了原生 Hooks（需手动编辑 .claude/settings.json）的使用流程，让添加规则变得像写一句自然语言命令一样，降低上手门槛。

• 比如，运行以下命令即可生成一个防止误删 Home 目录的 Hook：

  /hookify Block rm -rf commands with home paths
  

  系统据此生成 .claude/hookify.block-rm-rf.local.md 规则文件，无需重启即可生效。

工作原理与配置机制

• hookify 背后的机制是：自动生成特殊格式的 Markdown 规则文件，文件存放在 .claude/ 目录下，名称以 hookify.{rule-name}.local.md 形式保存。这些规则定义正则或匹配模式，并说明当匹配时的行为。

• 这些规则实际上会被 Claude Code 读取并映射为实际的 Hook 逻辑，无需用户手动编辑 JSON 或了解 Hook 引擎底层。

使用示例与推荐场景

• 防止危险命令：如 rm -rf ~ 等，使用 hookify 可快速生成防护规则。

• 防止 API Key 泄漏：可以制定禁写含有 “SECRET” 或关键字的代码片段，避免敏感信息被写入。

• 项目自动格式化：虽然这类 Hook 常用 JSON 配置实现，但可结合 hookify 快速设立规则，如编辑后自动跑 prettier、black 等格式化命令。

技术机制与 Hook 生命周期概览

• Hooks 类型与触发时机：
  Claude Code 支持多个 Hook 类型，包括 PreToolUse（工具执行前）、PostToolUse（工具执行后）、UserPromptSubmit（提交提示前）、Stop（响应结束时）等。

• 配置层级与生效机制：
  Hook 的配置一般存在以下几个位置：

  • 项目级：.claude/settings.json
  • 用户级：~/.claude/settings.json
  • 本地不共享：.claude/settings.local.json

  Hookify 生成的规则通常保存在项目目录，相应规则在保存后即时生效，无需重启。

• 安全与权限注意事项：
  Hooks 可执行任意 Shell 命令，拥有用户文件权限，意味着配置不当可能带来风险。Claude Code 会在设置文件变动后提示复审，以防恶意规则影响当前会话。

社区实战经验与反馈

• hookify已支持 6 种 Hook 类型，但社区希望添加更多事件类型以适应开发流程，更精细地自动化控制。

• Reddit 用户实践表明：使用 hookify 和 Hooks 组合，可实现自动提交 checkpoint、格式化、通知、审计等高级开发流程。例如：自动创建 git checkpoint 提交、最终 squash 成任务 commit，极大提升实验迭代效率。

使用建议与安全指南

• 建议先从简单规则入手：例如格式化 Hook 或简单的禁止操作 Hook，有可见的即时反馈，便于调试和验证。

• 审查自动生成的规则文件：即便是 hookify 生成，也建议检查生成内容确认正则或行为符合预期。

• 配置版本控制：将 .claude/hookify.*.local.md 纳入 Git 管理，在团队中共享规则的同时也可追溯修改历史。

• 注意执行时效与超时：Hook 默认执行超时为 60 秒，复杂命令可能需要拆分或优化。