Claude Code 具备直接在本地终端执行命令的能力,经常会主动帮你执行 git push、强制推送、删除分支、覆盖提交这类高危操作,很容易出现代码误提交、硬覆盖远程仓库、泄露密钥等事故,这里有一段仅 20 行左右的 Git pre-push 钩子脚本,不用复杂工具,直接放在 Git 仓库里,在推送之前自动拦截 9 类危险命令,触发之后直接终止推送,同时给提示,不影响正常开发,适合用 Claude Code 做开发、害怕 AI 乱执行 Git 高危指令的开发者,原理就是在 git push 真正发往远程仓库前做一层校验,匹配黑名单关键词,拦截风险动作,给人留出确认时间。
一、这个 Git 钩子能拦截的 9 类危险命令清单
| 序号 | 危险命令类型 | 风险说明 |
|---|---|---|
| 1 | git push --force / --force-with-lease | 强制覆盖远程分支,丢提交记录 |
| 2 | git push + 分支名 | 简易强制推送写法,同样会覆盖远程 |
| 3 | git reset --hard | 硬回滚,丢弃本地未提交改动 |
| 4 | git rebase -i / 远程 rebase | 改写历史提交,多人协作容易冲突 |
| 5 | git push --delete | 直接删除远程分支 |
| 6 | git clean -fd | 批量删除未跟踪文件,容易删掉配置、密钥 |
| 7 | git filter-branch | 重写全仓库提交历史,风险极高 |
| 8 | git push 到 main/master 主分支 | 防止 Claude Code 直接往保护分支推送 |
| 9 | 携带密钥、token、私钥的提交推送 | 匹配常见密钥关键词告警 |
二、钩子工作流程
- 触发时机:执行 git push 的时候,Git 会优先运行 pre-push 钩子,还没和远程仓库传输数据
- 读取内容:读取本次推送相关命令、提交内容、目标分支
- 黑名单匹配:脚本正则匹配上面 9 类高危指令关键词
- 判断分支:额外校验是不是 main/master 等受保护分支
- 结果分支:命中危险指令 → 输出告警、exit 1,直接终止推送;没有命中 → exit 0,正常推送
- 附加提示:打印拦截原因,提醒开发者检查 Claude Code 生成的指令
三、部署步骤
- 进入你的 Git 仓库目录,找到 .git/hooks/ 文件夹
- 创建文件 pre-push,粘贴这段 20 行左右的 shell 脚本
- 赋予执行权限:chmod +x .git/hooks/pre-push
- 测试:手动执行 git push,或者让 Claude Code 执行 git push,触发高危命令就会被拦截
- 可选:团队统一,把脚本放到项目仓库,用配置同步给所有成员
四、优缺点
✅ 优点
- 代码很短,只有 20 行,轻量化,几乎无性能开销
- 只拦截推送环节,不影响本地 git add、git commit
- 不需要额外安装服务,原生 Git 能力,兼容所有终端、Claude Code
- 可以自己修改黑名单,按需增加需要拦截的命令
❌ 局限
- 只拦截git push阶段,Claude Code 在本地先执行 reset、clean 这类本地命令拦不住
- 是关键词匹配,不是语义识别,存在少量误杀情况
- 只能做基础防护,不能替代分支保护、Code Review、密钥扫描工具
五、使用注意事项
- 这是一层防护,不是万能锁,Claude Code 本地执行高危命令依然要肉眼确认
- 团队协作优先在 Git 服务端(Gitee/GitHub/GitLab)开启分支保护,双保险
- 如果确实需要强制推送,临时注释钩子,或者手动绕过,用完记得恢复
- 脚本只拦截关键词,复杂的变形绕过写法,需要持续更新正则规则
【相关 FAQ】
问题 1:这个 20 行 Git 钩子,能不能挡住 Claude Code 自动发起的 git push?
回答 1:这个 20 行 Git 钩子挂载在 pre-push 阶段,只要 Claude Code 调用 git push,脚本会先校验黑名单,命中危险命令就直接阻断推送,挡住 Claude Code 自动发起的高危 git push。
问题 2:这个 20 行 Git 钩子拦截 9 类危险命令,会不会影响正常的 git push 开发流程?
回答 2:这个 20 行 Git 钩子只拦截黑名单里的 9 类危险命令,普通正常 git push、普通分支提交推送不会被拦截,只有强制推送、删分支等高危动作才会触发阻断。
问题 3:除了这个 20 行 Git 钩子,还有什么办法约束 Claude Code 随便执行终端命令?
回答 3:除了这个 20 行 Git 钩子拦截 git push 类危险命令,还可以在 Claude Code 设置里关闭自动执行、开启人工确认模式,同时在 Git 平台配置远程分支保护,多层防护。
【参考资料】
[2026-11-20](Claude Code 总想 git push?一个 20 行钩子挡住 9 类危险命令)掘金
[2026-11-20](用 Git pre-push 钩子拦截危险推送,防止 AI 代码助手乱推送)InfoQ
[2026-11-19](Claude Code 终端执行权限安全最佳实践)GitHub 官方博客
[2026-10-08](Git Hooks pre-push 钩子使用教程)Git 官方文档
【免责声明】
本文 Claude Code 搭配 Git 钩子相关内容仅为开发安全方案分享,该脚本基于关键词匹配,存在被特殊写法绕过、误拦截的可能性;重要项目建议同时搭配远端分支保护、密钥扫描、人工审核,不要只依赖本地 Git 钩子防护,不代表可以完全规避 AI 自动执行命令带来的代码风险。
