karanb192/claude-code-hooks
🪝 Claude Code hooks + an installable plugin marketplace: safety, cost, observability, productivity.
概述
claude-code-hooks 是一组即用型钩子，可插入Claude Code（Anthropic 旗下的 AI 助手软件，能够自主运行 shell 命令、编辑文件……甚至安装包）。这些钩子充当安全卫士和自动化助手，在代理操作之前或之后进行拦截，允许您阻止、修改或记录它们。该项目提供了一个包含 22 个独立插件的市场，您可以通过一条 Claude Code 命令安装。
项目提供的功能
| 功能 | 说明 | 使用方法 |
|---|---|---|
| 安全卫士 | 阻止危险命令（rm -rf ~、`curl |
sh`），防止读取机密文件，强制执行 git 分支规则，阻止测试隐藏技巧，保护代理自身配置，限制子代理生成等。 |
| 日志与审计 | 会话级 Markdown 日志、自动生成站会报告、个人失败飞行记录器、合规性记分卡、按文件统计的“上下文成本”排行榜。 | 安装如 session-logger 的日志插件，并查看生成的 Markdown 或命令行卡片。 |
| 自动化助手 | 自动暂存已编辑文件、编辑后自动格式化代码、在 PR 描述中标记来源信息、将仓库 TODO 转换为悬赏板任务。 | 安装助手插件并调用其斜杠命令（例如 /auto-stage）。 |
| 通知 | 当 Claude 需要用户许可时发送 Slack 警报。 | 安装 notify-permission 并配置 Slack Webhook。 |
| 开发者工具 | event-logger.py 可帮助您在构建自己的钩子时检查任何钩子事件的负载。 |
在 Claude 会话活动期间运行 Python 脚本。 |
所有钩子都是普通的 Node.js 脚本（*.js），在模型进程外部运行，因此提示注入攻击无法绕过它们。每个钩子都可以单独安装，或者针对七个核心守卫，通过 guard-pack 插件捆绑安装，实现单进程启动。
快速开始
- 添加市场（仅一次）：
/plugin marketplace add karanb192/claude-code-hooks - 安装您需要的钩子，例如：
/plugin install protect-secrets@claude-code-hooks - 重启 Claude Code 以激活钩子。
- 使用提供的斜杠命令（例如
/protect-secrets）或查看生成的日志/看板。
配置通过环境变量（如 HOOK_SAFETY_LEVEL=high 或 CONFIG_GUARD_ALLOW=true）进行，以放宽特定调用的守卫。
哪些人可能会发现此项目有用？
- 使用 Claude Code 的开发者：希望防止助手意外删除文件、泄露凭据或执行破坏性 git 操作。
- 有合规要求的团队：需要 AI 驱动代码变更的审计轨迹。
- 运维/安全工程师：希望在 CI/CD 管道中沙盒化 AI 代理。
- 任何构建自定义 Claude Code 扩展的人：可以复用提供的
event-logger和示例钩子作为模板。
限制/注意事项
- 守卫仅适用于能发出文档化钩子事件（
PreToolUse、PostToolUse等）的 Claude Code 版本。 - 启用
config-guard也会阻止插件管理器本身，因此您必须在开启它之前安装所有其他插件，或临时设置CONFIG_GUARD_ALLOW=true。 - 钩子作为独立进程运行；它们会增加少量开销（捆绑的
guard-pack每次调用约 35 毫秒）。 - 安全级别（
critical、high、strict）决定钩子是静默拒绝、发出警告，还是在继续前询问用户。
简而言之： claude-code-hooks 是一个实用的工具箱，为 Claude Code 代理带来最小权限、日志记录和自动化，让您安全地利用 AI 驱动的编码，同时严格控制模型在您机器上实际能执行的操作。
相关
- 项目
- 项目
- 项目
- 项目
- 项目