Claude Code Toolkit Hooks深度指南20个生命周期钩子构建自动化质量门禁【免费下载链接】awesome-claude-code-toolkitThe most comprehensive toolkit for Claude Code -- 135 agents, 35 curated skills, 42 commands, 176 plugins, 20 hooks, 15 rules, 7 templates, 14 MCP configs, 26 companion apps, 52 ecosystem entries, and more.项目地址: https://gitcode.com/gh_mirrors/aw/awesome-claude-code-toolkitClaude Code Toolkit是目前最全面的 Claude Code 增强工具箱其Hooks钩子模块用20 个生命周期钩子帮你搭建一套自动化的质量门禁——在 AI 写代码的每个关键节点自动拦截危险操作、检查代码质量、保存会话状态。无需盯守质量与规范自动落地新手也能放心放手让 AI 干活。 什么是 Claude Code Hooks为什么需要质量门禁可以把Hooks钩子理解为 Claude Code 的安全拦截器 自动质检员。当 AI 准备执行某个动作写文件、跑命令、结束会话时钩子会在关键时刻自动插入完成检查、拦截或记录就像工厂流水线上的质检工位。一套完整的自动化质量门禁能帮你做到事前拦截阻止密钥泄漏、危险命令、乱建文件✅事后检查自动跑 Lint、类型检查、单元测试状态记忆跨会话保存上下文、学习日志规范约束提交信息、文档创建都符合团队标准一句话总结钩子让 AI 编码从自由发挥变成有护栏的自动化。 Hooks 的 8 类生命周期事件一览表Claude Code 提供8 类生命周期事件钩子可挂载到任意一类上。先看全局地图生命周期事件触发时机典型用途PreToolUse工具调用之前拦截危险命令、扫描密钥PostToolUse工具调用之后自动 Lint、跑测试、类型检查SessionStart会话启动时加载项目上下文、检测包管理器SessionEnd会话结束时保存状态、写学习日志PreCompact上下文压缩前抢救重要上下文StopAI 停止响应时提醒跑测试、检查未暂存改动Notification系统通知时记录通知供后续复查UserPromptSubmit用户提交提示词时检测模糊指令并给出澄清建议 20 个钩子脚本完整清单全部脚本位于 hooks/scripts/ 目录统一由 hooks/hooks.json 配置调度。下面是 20 个脚本的职责全景钩子脚本生命周期事件一句话职责session-start.jsSessionStart检测包管理器、加载上次会话信息context-loader.jsSessionStart读取 CLAUDE.md、Git 分支、待办任务smart-approve.pyPreToolUse (Bash)拆解复合命令逐条对照允许/拒绝规则block-dev-server.jsPreToolUse (Bash)阻止 tmux/screen 外运行开发服务器pre-push-check.jsPreToolUse (Bash)push 前检查分支与远程警告强推block-md-creation.jsPreToolUse (Write)拦截文档目录外乱建 .md 文件commit-guard.jsPreToolUse (Bash)校验提交信息是否符合 Conventional Commitssecret-scanner.jsPreToolUse (Write/Edit)写入前扫描并拦截密钥泄漏post-edit-check.jsPostToolUse (Write/Edit)编辑后自动运行 Linterlint-fix.jsPostToolUse (Write/Edit)自动修复可修复的 Lint 问题type-check.jsPostToolUse (Write/Edit)对 .ts/.tsx 跑类型检查auto-test.jsPostToolUse (Write/Edit)编辑后自动运行相关测试bundle-check.jsPostToolUse (Write)修改前端资产后检查打包体积suggest-compact.jsPostToolUse (Bash)按编辑次数提示压缩上下文pre-compact.jsPreCompact压缩前快照保存关键上下文session-end.jsSessionEnd保存会话状态供下次使用learning-log.jsSessionEnd提取会话学习点写入每日日志stop-check.jsStop提醒跑测试、检查 git statusnotification-log.jsNotification记录系统通知供事后复查prompt-check.jsUserPromptSubmit检测模糊提示词并建议澄清️ 质量门禁四阶段拆解从会话启动到结束理解这 4 个阶段你就能看懂整套门禁如何运转。阶段一会话启动 —— 加载项目上下文会话一开启session-start.js 会自动识别你用的是npm / pnpm / yarn / bun / poetry等哪种包管理器并把上次的会话信息带回来。紧接着 context-loader.js 会读取CLAUDE.md 行数、当前 Git 分支、改动文件数、待办任务甚至发现缺.env时主动提醒。AI 一上来就了解项目避免答非所问。阶段二工具调用前 —— 拦截危险操作核心门禁这是质量门禁的大脑。在你以为 AI 要执行某个动作时PreToolUse钩子先拦一道密钥拦截secret-scanner.js 能识别 AWS Access Key、GitHub Token、私钥、数据库连接串、JWT 等 8 类敏感信息命中即阻断写入并给出具体行号。命令审批smart-approve.py 会把a b | c这类复合命令拆成子命令逐条比对settings.json里的允许/拒绝规则确保没有夹带危险操作。提交规范commit-guard.js 强制提交信息符合 Conventional Commits如feat: xxx长度、大小写、句尾标点都管。阶段三工具调用后 —— 自动检查与修复文件一旦写完PostToolUse钩子立刻接手形成写完即检的闭环post-edit-check.js 按语言选对 LinterESLint / ruff / go vet / clippy跑检查lint-fix.js 把能自动修复的问题直接修掉type-check.js 对 TypeScript 文件跑tsc --noEmitauto-test.js 自动找到对应测试文件并执行覆盖 TS/JS/Python/Go/Rust 效果AI 改完代码你几乎不用手动敲npm test门禁已经把写→检→修→测一条龙跑完。阶段四会话结束 —— 保存状态与学习日志结束时session-end.js 保存状态、learning-log.js 把本次会话的要点和最近提交写进按日期归档的学习日志stop-check.js 还会在最后提醒改动了 5 文件记得跑测试别忘了git status。下次打开会话一切都能无缝衔接。⭐ 新手必装的 3 个钩子如果一时吃不下 20 个优先启用这 3 个投入产出比最高钩子解决什么痛点secret-scanner.js防止 AI 不小心把密钥、Token 写进文件commit-guard.js提交信息格式统一Git 历史更专业smart-approve.py危险命令自动审批减少反复点确认 一键安装 Claude Code Hooks 的 3 种方法方法一手动拷贝最直接git clone https://gitcode.com/gh_mirrors/aw/awesome-claude-code-toolkit cp hooks/hooks.json .claude/hooks.json cp -r hooks/scripts/ .claude/hooks/scripts/方法二交互式安装脚本运行 setup/install.sh它会引导你克隆仓库、建立软链接并安装插件适合想一次性配好整套工具箱的用户。方法三按需精简只复制hooks.json里你需要的几条配置把对应脚本放进.claude/hooks/scripts/即可实现轻量级门禁。⚠️ 注意脚本运行依赖 Node.js / Python3 环境请确保已安装。❓ 常见疑问 FAQQ1钩子会不会拖慢 AI 速度大部分钩子只做文件读取或轻量命令毫秒级返回auto-test.js 这类会设超时上限约 30 秒不会卡死会话。Q2钩子拦截了我能跳过吗可以。PreToolUse是建议 拦截你仍可在 Claude Code 里手动确认覆盖但建议先看清拦截原因再决定是否放行。Q320 个钩子会互相冲突吗不会。同类事件按注册顺序依次执行各自职责独立一个扫密钥、一个查提交互不干扰。Q4没有密钥扫描需求可以关掉 secret-scanner 吗可以。删除 hooks/hooks.json 中对应条目即可其余钩子照常工作。 小结Claude Code Toolkit 的20 个生命周期钩子覆盖了从SessionStart到SessionEnd的完整链路把密钥拦截、命令审批、自动质检、提交规范、状态记忆编织成一套自动化质量门禁。你只需一次性安装配置之后就能放心让 AI 高速编码——规范、安全、质量由钩子替你守好每一关。想深入细节可打开 hooks/hooks.json 查看完整调度配置或逐个阅读 hooks/scripts/ 下的脚本源码。【免费下载链接】awesome-claude-code-toolkitThe most comprehensive toolkit for Claude Code -- 135 agents, 35 curated skills, 42 commands, 176 plugins, 20 hooks, 15 rules, 7 templates, 14 MCP configs, 26 companion apps, 52 ecosystem entries, and more.项目地址: https://gitcode.com/gh_mirrors/aw/awesome-claude-code-toolkit创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考