Hookify 是 Claude Code 官方提供的一个插件,用于简化自定义 Hooks(钩子)的创建和管理,让你无需手动编写复杂的 JSON 配置文件,而是通过自然语言或简单的 Markdown 格式来定义自动化规则。

核心功能

Hookify 让你能够创建"行为护栏"(guardrails),在特定事件发生时自动触发警告或阻止某些操作 。

主要用途:

  • 阻止危险命令(如 rm -rf
  • 警告调试代码(如 console.log 遗留)
  • 防止硬编码密钥提交到代码库
  • 自动格式化代码(保存后运行 Prettier/ESLint)
  • 提醒使用 tmux 运行长时间任务

安装与使用

/plugin install hookify@claude-plugins-official

主要命令 :

命令 功能
/hookify [描述] 用自然语言创建规则(如 “Warn me when I use rm -rf commands”)
/hookify 分析最近对话,自动发现需要改进的行为模式
/hookify:list 查看所有启用的规则
/hookify:configure 交互式启用/禁用规则

规则文件格式

Hookify 规则存储在项目目录的 .claude/hookify.{规则名}.local.md 文件中,使用 YAML frontmatter + Markdown 格式 :

---
name: block-dangerous-rm
enabled: true
event: bash
pattern: rm\s+-rf
action: block  # 可选:block(阻止)或 warn(警告)
---

⚠️ **Dangerous rm command detected!**

This command could delete important files.
- Verify the path is correct
- Make sure you have backups

支持的事件类型

事件类型 触发时机
bash 执行 Bash 命令时
file 编辑/写入文件时(Edit/Write/MultiEdit)
stop Claude 尝试结束会话时
prompt 用户提交提示时
all 所有事件

实际示例

阻止破坏性操作

---
name: block-destructive-ops
enabled: true
event: bash
pattern: rm\s+-rf|dd\s+if=|mkfs|format
action: block
---
🛑 **Destructive operation detected!** This command may cause data loss.

警告调试代码

---
name: warn-debug-code
enabled: true
event: file
pattern: console\.log\(|debugger;|print\(
action: warn
---
🐛 **Debug code detected** — remember to remove before committing.

与原生 Hooks 的区别

  • 原生 Hooks:需要手动编写 JSON 配置,较为复杂
  • Hookify 插件:通过对话式自然语言创建,使用 YAML + Markdown 格式,更易于维护和分享

Hookify 是 Claude Code 官方 13 个核心插件之一,特别适合需要快速建立安全规则或自动化工作流的团队使用 。

Logo

小龙虾开发者社区是 CSDN 旗下专注 OpenClaw 生态的官方阵地,聚焦技能开发、插件实践与部署教程,为开发者提供可直接落地的方案、工具与交流平台,助力高效构建与落地 AI 应用

更多推荐