10 Hooks、GitHub Actions 与团队化：把 Claude Code 放进工程流程
学到这里，你已经能安装 Claude Code、读项目、改代码、写 CLAUDE.md、设置权限、做 Skills、接 MCP、用 Subagents。最后一篇讲工程化：Hooks 和 GitHub Actions。
这部分不要急着上生产。它的价值很大，但也最需要边界。
Hooks 解决什么问题
Hooks 是事件触发器。官方 Hooks 文档里说明，hook handler 可以是 shell 命令、HTTP endpoint、MCP tool、LLM prompt 或 agent，并在匹配事件时运行。
你可以把它理解成：当 Claude Code 做了某个动作，就触发一段固定流程。
常见用途：
- 文件修改后自动运行格式化。
- 改到特定目录后提醒跑测试。
- 触碰
.env、配置、迁移文件时给出警告。 - 每次结束前写一份变更摘要。
- 将重要操作写入本地日志。
新手最适合的第一个 hook，不是自动部署，而是自动提醒和自动检查。
一个安全的 Hooks 思路
比如你想防止误碰环境文件，可以让 hook 关注 .env、.envrc 这类文件，触发时只做提醒或记录，不直接执行破坏性动作。
项目级 hooks 可以放在 .claude/settings.json 里，团队可以一起维护。但越是自动化，越要写清楚作用范围。不要把生产部署、数据库写操作、删除文件这类行为轻易放进 hook。
我的建议是分三档：
- 提醒类：最安全，适合先上。
- 检查类：例如 lint、format、测试，适合本地项目。
- 执行类：例如部署、发通知、改远程状态，要谨慎。
GitHub Actions：让 Claude Code 进入协作流程
Claude Code GitHub Actions 可以把 Claude Code 放到 GitHub 工作流里。官方文档里介绍，它可以在 issue 或 PR 里响应 @claude，也可以在 workflow 中运行，用于分析代码、创建 PR、实现功能或修 bug。
官方 quick setup 提到，可以在 Claude Code 终端里运行：
/install-github-app
这个命令会引导配置 GitHub App 和需要的 secrets。需要注意的是，你必须是仓库管理员，GitHub App 会请求内容、issue、PR 等读写权限。
团队里不要一上来全自动
我更推荐从半自动开始：
- 先让 Claude 在 PR 评论里做审查。
- 再让它根据 issue 生成草稿 PR。
- 再考虑固定 workflow。
- 最后才考虑更自动化的合并前检查。
不要第一天就让它看到所有仓库、拥有所有权限、自动改所有分支。团队流程里最重要的是可追踪：谁触发、改了什么、通过了哪些检查、谁最终合并。
一份最小团队规则
如果你要在团队里推 Claude Code，我建议先写 5 条：
- 所有项目必须有
CLAUDE.md。 - 生产部署、数据库、密钥相关任务必须人工确认。
- Claude 生成的 PR 必须有人 review。
- CI 不通过不能合并。
- 所有自定义 Skills、Subagents、Hooks 都要进仓库 review。
这 5 条比“我们要拥抱 AI 编程”更有用。
这套教程的最终目标
Claude Code 真正适合做的是：把工程里的重复认知劳动变少，把定位问题、阅读代码、整理上下文、执行验证这些环节串起来。它不能替你负责产品判断，也不能替你承担生产事故。
把它当成会动手的工程搭档，你会越用越顺。把它当成无人驾驶上线按钮，迟早会出问题。
参考资料：
Continue