1. 为什么你的 Claude Code 每天还在重复劳动
Claude Code 现在已经是很多开发者日常写代码的主力工具,但绝大多数人只用了它最表层的能力:对话、改文件、跑命令。真正被低估的是 Hooks——它允许你在 Claude Code 的运行周期里挂载自定义 shell 脚本,让格式化、测试、通知、权限拦截这些动作自动发生。
一句话解释:Hooks 是在 Claude Code 特定时机自动执行的 shell 命令。比如 Claude 改完一个文件后,你想自动跑 prettier,正常流程是你手动敲 npx prettier --write xxx.js;用 Hook 的话,只要在配置里写一条规则,Claude 每次改完文件就自动格式化,你什么都不用管。
它支持的触发时机包括:PreToolUse(工具调用前,可拦截)、PostToolUse(工具调用后,可格式化)、Notification(Claude 等你输入时,可发通知)、Stop(一轮回答结束,可跑测试)、SessionStart(会话启动,可加载环境)、PostCompact(上下文压缩后,可重新注入关键信息)。
这篇聚焦落地配置,围绕 settings.json 骨架与 shell 脚本,给你 6 个可直接复制的自动化钩子,并逐条给出验证动作,帮你在本地复现并确认每个 Hook 真的生效。适合已经在用 Claude Code、想进一步减少重复操作的开发者。如果你还没配好模型接入,可以先用 TaoToken 的模型对话快速验证脚本逻辑,再落到本地配置。
2. 前置准备:settings.json 骨架与 TaoToken 接入
Hooks 的配置写在 ~/.claude/settings.json 里,最外层是 hooks 对象,每个事件名对应一个数组,数组里每个元素包含 matcher(匹配条件)和 hooks(要执行的命令列表)。骨架长这样:
{
"hooks": {
"事件名": [
{
"matcher": "匹配条件",
"hooks": [
{
"type": "command",
"command": "要执行的命令"
}
]
}
]
}
}
在动手之前,先把两个依赖装好,否则后面所有 Hook 都会静默失败:
# macOS
brew install jq
# Ubuntu / Debian
sudo apt install jq
# 确认版本
jq --version
jq 是刚需,因为 Hooks 的输入输出都走 JSON,stdin 会收到一段结构化数据,你需要用 jq 把字段提取出来。没有它,命令会报错但界面不一定提示。
如果你本地还没接好 Claude Code 的模型通道,可以先用 TaoToken 的 API 做一次连通性验证。它的接口地址是 https://taotoken.net/api,在控制台生成 API Key 后,用一条 curl 确认能正常返回:
curl https://taotoken.net/api/v1/models \
-H "Authorization: Bearer $TAOTOKEN_API_KEY"
能列出模型列表,说明通道没问题,再继续配 Hooks。API Key 在控制台的 API Keys 页面生成,接入文档里有完整的参数说明。这一步不是必须,但能帮你排除“Hook 没生效其实是模型没连上”这类误判。
3. 六个可复制的自动化 Hook 配置
下面每个 Hook 都给出完整 JSON 片段和验证动作。建议先单独配一个,验证通过后再合并到同一个 settings.json。
3.1 保存即格式化:PostToolUse + prettier
这是用得最多的场景。Claude 改完代码文件,你不想每次手动跑 prettier 或 eslint --fix。
{
"hooks": {
"PostToolUse": [
{
"matcher": "Edit|Write",
"hooks": [
{
"type": "command",
"command": "jq -r '.tool_input.file_path' | xargs npx prettier --write 2>/dev/null || true"
}
]
}
]
}
}
matcher 设成 Edit|Write,意思是只在 Claude 用 Edit 或 Write 工具改文件时触发。stdin 收到 JSON,里面有 tool_input.file_path 字段,用 jq 提取后传给 prettier。末尾加 || true 是因为有些文件 prettier 不认(比如 .md),报错也不该中断流程。
验证动作:让 Claude 改一个 .js 文件,故意把缩进写乱,改完后打开文件看是否被自动格式化。实测下来这个 Hook 每次执行不到 200ms,基本感觉不到延迟。
3.2 保护关键文件:PreToolUse 拦截
项目里总有些文件不能随便动:.env.production、docker-compose.yml、CI 配置。用 PreToolUse Hook 拦截:
{
"hooks": {
"PreToolUse": [
{
"matcher": "Edit|Write",
"hooks": [
{
"type": "command",
"command": "jq -r '.tool_input.file_path' | grep -qE '(\\.env\\.production|docker-compose\\.yml|\\.(github|gitlab)/|Makefile)' && echo '{\"decision\": \"block\", \"reason\": \"受保护文件,请确认后手动修改\"}' || echo '{\"decision\": \"allow\"}'"
}
]
}
]
}
}
原理:从 stdin 读文件路径,用 grep 匹配保护列表,命中就返回 {"decision": "block"},Claude 会收到拒绝信息,不执行这次修改。
验证动作:让 Claude 尝试改 .github/workflows/deploy.yml,观察它是否被拦下并提示“受保护文件”。我试过在项目里加上这条之后,Claude 再也没有误改过 CI 配置。
3.3 任务完成桌面通知:Notification
Claude 跑复杂任务要几分钟,你切到别的窗口干活,不知道它什么时候完事。加个通知 Hook。
macOS 版:
{
"hooks": {
"Notification": [
{
"matcher": "",
"hooks": [
{
"type": "command",
"command": "osascript -e 'display notification \"Claude Code 任务完成,等你回来\" with title \"Claude Code\"'"
}
]
}
]
}
}
Linux 版把 command 换成:
notify-send 'Claude Code' 'Claude Code 任务完成,等你回来'
matcher 设为空字符串表示所有通知都触发。验证动作:让 Claude 执行一个需要等待的任务,切走窗口,看是否弹出系统通知。
3.4 每轮结束自动跑测试:Stop
Claude 改完代码后自动跑一遍测试,挂了马上就知道:
{
"hooks": {
"Stop": [
{
"matcher": "",
"hooks": [
{
"type": "command",
"command": "cd \"$(jq -r '.cwd')\" && npm test --silent 2>&1 | tail -20 | jq -Rs '{output_to_claude: .}'"
}
]
}
]
}
}
Stop 事件在 Claude 完成一轮回答时触发。这里做了三件事:cd 到项目目录跑 npm test,取最后 20 行输出,把结果通过 output_to_claude 字段反馈给 Claude。如果测试挂了,Claude 会看到失败信息,你可以直接让它修复,形成闭环。
验证动作:故意改坏一个测试用例,让 Claude 跑一轮,看它是否主动提到测试失败。注意:如果测试超过 30 秒,建议只跑受影响文件的测试,不要全量跑。
3.5 压缩后恢复关键信息:PostCompact
对话长了会压缩上下文,有时压缩完会“忘记”项目约定。PostCompact Hook 可以在压缩后自动注入关键上下文:
{
"hooks": {
"PostCompact": [
{
"matcher": "",
"hooks": [
{
"type": "command",
"command": "cat .claude/project-context.txt | jq -Rs '{output_to_claude: .}'"
}
]
}
]
}
}
把项目约定写在 .claude/project-context.txt 里,比如“本项目使用 TypeScript strict 模式,所有函数必须有返回类型声明;API 路由在 src/routes/ 下”。压缩后自动重新喂给 Claude。
验证动作:开一个长对话,触发压缩后问 Claude“本项目用什么模式”,看它是否答出 strict。加了这个 Hook 之后,长对话中“跑偏”的频率降了不少。
3.6 会话启动加载环境:SessionStart
每次开新会话都要交代项目背景?用 SessionStart Hook 自动搞定:
{
"hooks": {
"SessionStart": [
{
"matcher": "",
"hooks": [
{
"type": "command",
"command": "echo '{\"output_to_claude\": \"Node: '$(node -v)', Branch: '$(git branch --show-current)', 最近3条commit: '$(git log --oneline -3 | tr '\\n' '; ')'\"}'"
}
]
}
]
}
}
这样 Claude 一启动就知道你在哪个分支、用什么版本、最近改了什么。验证动作:新开一个会话,直接问“当前在哪个分支”,看它是否答对。
4. 合并配置与逐条验证请求
把上面 6 个 Hook 合到同一个 settings.json,只展示 hooks 部分:
{
"hooks": {
"PostToolUse": [
{
"matcher": "Edit|Write",
"hooks": [
{
"type": "command",
"command": "jq -r '.tool_input.file_path' | xargs npx prettier --write 2>/dev/null || true"
}
]
}
],
"PreToolUse": [
{
"matcher": "Edit|Write",
"hooks": [
{
"type": "command",
"command": "jq -r '.tool_input.file_path' | grep -qE '(\\.env\\.production|docker-compose\\.yml|\\.(github|gitlab)/)' && echo '{\"decision\": \"block\", \"reason\": \"受保护文件\"}' || echo '{\"decision\": \"allow\"}'"
}
]
}
],
"Notification": [
{
"matcher": "",
"hooks": [
{
"type": "command",
"command": "osascript -e 'display notification \"Claude Code 等你回来\" with title \"Claude Code\"'"
}
]
}
],
"Stop": [
{
"matcher": "",
"hooks": [
{
"type": "command",
"command": "cd \"$(jq -r '.cwd')\" && npm test --silent 2>&1 | tail -20 | jq -Rs '{output_to_claude: .}'"
}
]
}
],
"PostCompact": [
{
"matcher": "",
"hooks": [
{
"type": "command",
"command": "cat .claude/project-context.txt | jq -Rs '{output_to_claude: .}'"
}
]
}
],
"SessionStart": [
{
"matcher": "",
"hooks": [
{
"type": "command",
"command": "echo '{\"output_to_claude\": \"Node: '$(node -v)', Branch: '$(git branch --show-current)'\"}'"
}
]
}
]
}
}
合并后建议按顺序验证,每条单独确认:
| 序号 | Hook | 验证动作 | 预期结果 |
|---|---|---|---|
| 1 | PostToolUse | 让 Claude 改乱一个 js 文件 | 文件被自动格式化 |
| 2 | PreToolUse | 让 Claude 改 CI 配置 | 被拦截并提示 |
| 3 | Notification | 跑一个等待任务并切走 | 弹出系统通知 |
| 4 | Stop | 改坏一个测试用例 | Claude 提到测试失败 |
| 5 | PostCompact | 长对话压缩后问项目约定 | 答出约定内容 |
| 6 | SessionStart | 新会话问当前分支 | 答对分支名 |
如果某条没生效,先看第 5 节的排查清单。想快速验证脚本本身逻辑,可以先用 TaoToken 的模型对话把命令跑通,再贴回配置。
5. 本篇常见错排查
用 Hooks 这几个月踩过一些坑,按出现频率排一下。
jq 没装或版本太老。 Hooks 输入输出走 JSON,jq 是刚需。没装的话 Hook 会静默失败,排查半天找不到原因。先跑 jq --version 确认。
命令超时默认 10 秒。 如果 Hook 执行时间长(比如全量跑测试),可能被杀掉。长任务建议用异步 Hook 或只跑增量测试。
stderr 输出被吞掉。 Hook 的 stderr 不会显示在 Claude 界面里。调试时把 stderr 重定向到文件:
your_command 2>/tmp/hook-debug.log
配置改完没重启。 修改 settings.json 后,当前会话不会自动加载新 Hook,需要退出重新进。
路径问题。 Hook 里的相对路径是相对于 Claude Code 启动目录的,不是 settings.json 的位置。跨项目用的 Hook 建议写绝对路径。
matcher 写错。 Edit|Write 是正则,别写成 Edit,Write。空字符串表示匹配所有。
JSON 转义踩坑。 命令里嵌套 JSON 时引号容易出错,建议先在终端单独跑一遍命令,确认输出是合法 JSON 再贴进配置。
6. 把重复操作交给 Hook,把注意力留给逻辑
Hooks 的思路很简单:把重复的操作自动化,把危险的操作拦住,把重要的信息自动喂给 Claude。上面 6 个配置覆盖了最常见的场景,你可以直接复制到自己的 settings.json,改改路径和命令就能用。
如果你还在调模型接入,建议先用 TaoToken 的模型对话把脚本逻辑验证一遍,再落到本地 Hook;长期做编码和 Agent 任务的话,Coding Plan 更适合持续跑;需要生成和管理 Key 就去控制台 API Keys 页面,接入细节看接入文档。把配置跑通之后,每天省下的那 30 分钟,才是真正属于你自己的时间。



被折叠的 条评论
为什么被折叠?



