一、基本信息
| 项目 | 内容 | 数据来源 |
|---|---|---|
| 正式名称 | hookify(合集仓库子目录名) | 目录名 |
| 所属合集仓库 | anthropics/claude-plugins-official(Anthropic 官方维护的 Claude Code 插件市场) | GitHub API |
| 作者/维护者 | Anthropic 官方(plugin.json 具名 support@anthropic.com) | plugin.json |
| 来源链接 | https://github.com/anthropics/claude-plugins-official/tree/main/plugins/hookify | — |
| 许可证 | Apache License 2.0(插件目录内 LICENSE 文件实测)。⚠️ 插件 README 正文误标注为“MIT License”,与实际 LICENSE 文件不符,以文件为准 | GitHub API + 插件目录 LICENSE 文件 |
| 所属合集仓库整体 Stars/Forks | 32,217 / 3,590(注:该数字属整个插件市场,不代表本插件自身热度,仅供了解所属市场规模) | GitHub API |
| 该插件自身活跃度 | 最近一次功能性提交 2026-05-19(修复 hook 命令引号转义问题),约 2 个月前 | GitHub Commits API(路径限定查询) |
| 官方市场安装量 | 57,960 次安装,claude.com 插件页标记 Anthropic Verified | claude.com 官方插件详情页(实测抓取) |
| 最新版本 | plugin.json 未列独立 version 字段 | plugin.json |
| 安装方式 | 见第十章 | 仓库根 README |
二、功能介绍与亮点
Hookify 是 Anthropic 官方出品的自然语言 Hook 生成器:把 Claude Code 原本要手写 hooks.json 的行为守护规则,降级为一句话描述。核心能力:
- 一句话建规则:
/hookify 别在 TypeScript 里用 console.log即可生成对应的拦截/警告规则,无需理解 hooks 事件模型 - 零参数自动挖掘:不带参数运行时,自动分析最近对话,找出用户纠正过 Claude 的行为,反推生成规则
- 5 种触发事件 × 6 种匹配算子:覆盖 bash 命令、文件编辑、用户输入、会话结束等场景,支持正则与多条件组合判断
- 即时生效:规则是
.claude/下的 markdown 文件,改完立刻生效,无需重启 Claude Code - 零依赖:仅需 Python 3.7+ 标准库,不引入任何第三方包
亮点:官方出品 + Anthropic Verified 认证徽章;57,960 次官方市场安装量;把原本对初级用户门槛较高的 hooks 配置能力真正“降级”为自然语言操作。
三、适用场景
固定分类:元技能与 Agent 增强
适用于希望给 Claude Code 加“行为护栏”、但不想学习 hooks.json 语法的初中级用户:拦截危险 bash 命令(如 rm -rf)、提醒清理调试代码残留、警告在 .env 等敏感文件里写入明文密钥。也适合反复被同一类问题困扰、希望把“纠正 Claude 的经验”一次性沉淀为可复用规则的用户。
四、跨 Agent 兼容性
| Agent | 结论 | 依据 |
|---|---|---|
| Claude Code | 原生支持 | 官方 claude-plugins-official 市场一条命令安装;功能深度绑定 Claude Code 的 PreToolUse/PostToolUse/UserPromptSubmit/Stop 等 hook 事件与插件系统架构 |
| Codex | 不支持 | 仓库根 README 明确插件“专为 Claude Code 插件系统设计”,未见 Codex 兼容说明 |
| OpenClaw | 未验证 | 已抓取材料未提及,未为此单独搜索 |
| Hermes Agent | 未验证 | 已抓取材料未提及,未为此单独搜索 |
五、推荐理由
官方出品,一句话生成Claude Code护栏规则,免写hooks.json配置
六、评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 9 | 官方出品 + Anthropic Verified 认证 + claude.com 实测 57,960 次安装;合集仓库整体 stars 属整个市场、不代表本插件热度,故以插件自身安装量为依据 |
| 可用性 | 8 | 零依赖、自然语言一句话建规则、文档含故障排查表;但 GitHub 上有 65 条 issue 提及该插件,其中包含“prompt 事件规则永远不触发”(2026-06-02 仍未修复)等静默失效类真实缺陷,故未给满分 |
| 安全性 | 9 | 见下方安全检查清单 |
| 综合评分 | 8.7 | 三项均值 |
安全检查清单:
| 检查项 | 结果 |
|---|---|
| ① Shell 命令执行及权限范围 | 插件本身不执行任何命令,只对工具调用做模式匹配后放行/拦截/阻止 |
| ② 运行时联网外发数据 | 纯本地运行,README 明确声明“no phone home”,未见任何外联行为 |
| ③ API Key/凭据要求及存储方式 | 不需要任何 API Key 或凭据 |
| ④ 可疑指令/Prompt Injection 迹象 | 已抓取 README 全文及规则示例逐条审阅,未发现试图诱导执行额外操作或外发数据的文字;该插件本职即为拦截此类风险行为 |
| ⑤ 作者/组织信誉 | Anthropic 官方仓库,plugin.json 具名,claude.com 标记 Verified |
| ⑥ License 是否明确 | 插件目录 LICENSE 文件为 Apache-2.0,明确(README 文字误标注 MIT,已在第一章注明) |
| ⑦ 最近维护时间 | 2026-05-19 有功能性修复提交,约 2 个月前,非弃置项目 |
七、跟同类 Skills 相比的优势
claude-plugins-official 市场内的其他官方插件与本插件的定位差异:
| 插件 | 核心定位 | 是否执行代码/联网 | 与 hookify 的差异 |
|---|---|---|---|
| hookify(本推荐) | 自然语言生成 Claude Code 行为护栏规则 | 否,纯本地模式匹配 | — |
| commit-commands(同仓库) | git commit/push/PR 全流程自动化 | 是,执行 git 与 gh CLI,含推送到远端 | 面向日常提交流程,权限范围更广,且近 5 个月未见功能性提交 |
| pr-review-toolkit(同仓库) | 6 个专精 agent 做 PR 全方位评审 | 是,读写代码 | 面向“改完之后怎么审”,与代码复核类工具定位相近,不涉及行为护栏 |
| agent-sdk-dev / mcp-server-dev(同仓库) | 面向构建 Agent SDK 应用 / MCP 服务器的脚手架 | 是,生成新项目文件 | 面向“开发新应用”的进阶开发者,不解决日常使用 Claude Code 时的行为约束问题;mcp-server-dev 另与 mcp-builder(anthropics/skills)定位相近 |
差异化核心:在上述同市场插件中,hookify 是唯一“零代码执行、零联网”的方案;“用自然语言生成 hook 规则”这一形态目前也少见同类工具。
八、用户评价
已核实的评价来源如下:
- dev.to 独立技术博客(《One Open Source Project a Day (No. 70)》,作者对 claude-plugins-official 全仓库做系统性评测):明确评价 hookify“用自然语言消除了 Claude Code hooks 配置的摩擦”,并将其与 pr-review-toolkit 并列为该仓库中“体现了成熟架构思路”的代表性插件之一
- claude.com 官方插件页:仅含功能介绍与 57,960 安装量,未见具体使用者一手评分或引述
除此之外,Reddit、Hacker News 等公开渠道未见针对该插件的专门讨论帖。
九、其他补充
无。
十、安装使用方式
Claude Code 插件市场(唯一官方渠道)
/plugin marketplace add anthropics/claude-plugins-official
/plugin install hookify@claude-plugins-official
或在 Claude Code 内运行 /plugin,进入 Discover 浏览搜索 “hookify” 后选择安装。
安装后注意事项:
- 安装即生效,无需重启 Claude Code
- 规则文件默认存放在项目
.claude/hookify.*.local.md,随项目仓库管理(可按需 .gitignore) - 建议先用
action: warn观察规则是否按预期触发,确认无误后再切到action: block
十一、注意事项
- GitHub 上有多条已确认但仍处 open 状态的功能性缺陷,包括
prompt事件规则永远不触发(2026-06-02 提交,尚无修复)、部分 Windows 路径与非 ASCII 字符场景下规则静默失效(用户会误以为护栏生效,实际未生效)——用作安全护栏时建议先用/hookify:list结合实际触发情况验证规则确实生效 - 深度绑定 Claude Code 自身的插件与 hook 系统,对 Codex 不支持,对 OpenClaw / Hermes Agent 未验证,多 Agent 团队若需统一护栏工具链需自行确认
- README 中的 License 文字与实际 LICENSE 文件不一致(文字写 MIT,文件为 Apache-2.0),以文件为准,不影响可用性但反映文档维护存在疏漏