Repolode
karanb192

karanb192/claude-code-hooks

为 Claude Code 提供的可安装钩子集合,用于在工具调用前后做安全拦截、自动化、成本统计和通知。

Star
576
Fork
49
未关闭 Issue
6
最近提交
5天前

这是什么?

claude-code-hooks 是一组可直接使用的 Claude Code 钩子,以插件市场的形式提供 22 个可安装插件。钩子运行在 PreToolUse、PostToolUse 等事件点上,可以允许、拒绝或修改工具调用,并把原因反馈给智能体。由于钩子作为独立进程运行在模型之外,提示词注入无法绕过它们。

安全类插件可拦截读取或外传 .env 等敏感文件、管道执行远程脚本(curl | sh)、对主目录执行 rm -rf、强制推送 main 分支,以及修改钩子和配置文件本身。其他插件提供会话日志(Markdown 格式)、每日站会生成、防止篡改测试、自动 git 暂存、使用 ruff 和 prettier 自动格式化、上下文成本统计,以及需要用户输入时发送 Slack 通知。多数守卫支持可配置的安全级别,并提供“询问”模式,以提示代替直接拦截。

每个插件都可通过一条斜杠命令安装,脚本也可在 settings.json 中独立注册使用。项目在 Node 18、20、22 上运行测试,并提供了对照 OWASP LLM Top 10 2026 的安全映射。

核心功能

  • 01拦截危险的 shell 命令,如对主目录执行 rm -rf、fork 炸弹和 curl | sh。
  • 02阻止读取或外传 .env 文件、SSH 密钥和云凭证。
  • 03防止智能体在会话中篡改自身的守卫配置。
  • 04当 Claude Code 需要用户输入时发送 Slack 提醒。
  • 05将每次会话记录为 Markdown 日志,并根据智能体活动生成每日站会内容。
  • 06可通过 Claude Code 插件市场逐个安装,也可作为独立脚本使用。

适用场景

  • 为自主编程智能体加上防护,避免其删除文件或强制推送到 main 分支。
  • 在包含 .env 文件的仓库中,防止智能体读取密钥。
  • 为每天使用 Claude Code 的团队记录会话活动和 token 成本。
  • 长时间运行的智能体会话等待审批时,通过 Slack 收到提醒。

快速上手

  1. 1

    在 Claude Code 中添加插件市场(只需一次)

    /plugin marketplace add karanb192/claude-code-hooks
  2. 2

    安装你需要的钩子(示例为 context-hogs,可替换为其他名称)

    /plugin install context-hogs@claude-code-hooks
  3. 3

    重启 Claude Code 使钩子生效

使用前须知

  • config-guard 默认的 high 级别也会阻止 claude plugin install、uninstall 和 disable,因此应先安装其他插件,或在该次调用前设置 CONFIG_GUARD_ALLOW=true。
  • Config-Change 的载荷结构没有官方文档,因此 config-watch 对其进行防御式解析。

收录于专题

标签

常见问题

claude-code-hooks 是什么?
为 Claude Code 提供的可安装钩子集合,用于在工具调用前后做安全拦截、自动化、成本统计和通知。 claude-code-hooks 是一组可直接使用的 Claude Code 钩子,以插件市场的形式提供 22 个可安装插件。钩子运行在 PreToolUse、PostToolUse 等事件点上,可以允许、拒绝或修改工具调用,并把原因反馈给智能体。由于钩子作为独立进程运行在模型之外,提示词注入无法绕过它们。
claude-code-hooks 可以免费使用吗?用的什么许可证?
claude-code-hooks 以 MIT 许可证开源。用于商业产品前,请先确认许可证条款。
claude-code-hooks 还在维护吗?
活跃维护中。claude-code-hooks 最近一次提交是在 2026年11月2日。
claude-code-hooks 适合用来做什么?
为自主编程智能体加上防护,避免其删除文件或强制推送到 main 分支。 在包含 .env 文件的仓库中,防止智能体读取密钥。 为每天使用 Claude Code 的团队记录会话活动和 token 成本。 长时间运行的智能体会话等待审批时,通过 Slack 收到提醒。
claude-code-hooks 怎么安装和运行?
在 Claude Code 中添加插件市场(只需一次): /plugin marketplace add karanb192/claude-code-hooks 安装你需要的钩子(示例为 context-hogs,可替换为其他名称): /plugin install context-hogs@claude-code-hooks 重启 Claude Code 使钩子生效
在哪里获取 claude-code-hooks?
源代码和安装说明在 GitHub 上:https://github.com/karanb192/claude-code-hooks

概要由 AI 根据项目 README 生成;GitHub 数据每日更新。

相关项目