结论先说
- 格式化这种百分之百确定的机械动作,绝不该靠大模型自觉,而该挂在
PostToolUse钩子上:只要把matcher设为"Edit|Write",Claude 每改完一个文件,客户端外壳毫秒级自动帮你排整齐,零额外模型推理轮次开销。 - 团队共享配置放项目根
.claude/settings.json:提交进 Git 后全组同事拉下代码即刻生效;只想自己本机尝鲜则放~/.claude/settings.json。 - macOS / Linux 一行
jq + xargs就能搞定;Windows 推荐调十行 Python 小脚本免装jq:钩子通过标准输入(stdin)拿到包含被改文件绝对路径的 JSON。 - 日常主力用 Claude Code 写业务建议开通正式订阅免除按次计费焦虑:可在本站查看 Claude Code 订阅导航页 或直接前往自动发卡的 Claude Pro iOS 自助充值商品页。

图:本站根据 Claude Code 官方 Hooks 指南 整理的软规则与硬钩子对比图
本文根据 Anthropic Claude Code 官方文档《Get started with Claude Code hooks》(code.claude.com/docs/en/hooks-guide)整理,资料核对于 2026-11-18。配图为本站整理的示意图,不是软件截图。本站(bigolab.com)不是 Anthropic 官方网站。
适用于谁
- 代码库开了严格的 CI 格式卡点,烦透了智能体改完逻辑却因为单双引号或行尾分号不合规范把流水线跑红的开发者;
- 在
CLAUDE.md里叮嘱「每次改完跑npm run format」,结果每改一个文件都白白多耗一轮大模型调 Bash 的 Token 与等待秒数的人; - 同时写 TypeScript 前端和 Python 后端,想一套钩子按后缀名自动分流 Prettier 与 Ruff 的全栈工程师。
一、macOS / Linux 官方极简配法(一行 jq 搞定 Prettier)

图:本站根据 Claude Code Hooks 文档 整理的四步配置示意图
如果你主要在 macOS、Linux 或 WSL 里写前端项目,且系统已装有 jq(钩子全事件概念入门见本站 Claude Code Hooks 基础教程,提交前拦截跑单测见 提交前自动跑测试钩子实战),直接打开项目根目录的 .claude/settings.json 粘贴官方标准写法:
json
{
"hooks": {
"PostToolUse": [
{
"matcher": "Edit|Write",
"hooks": [
{
"type": "command",
"command": "jq -r '.tool_input.file_path // .tool_input.path' | xargs npx prettier --write --ignore-unknown"
}
]
}
]
}
}
这里加了一个很关键的参数 --ignore-unknown:万一 Claude 刚改的是 .env.example 或纯文本文件,Prettier 会安静跳过而不会抛出「不支持该文件后缀」的非零退出码干扰界面。
Claude Code 免上号订阅与高配额省心方案:在大仓库跑百万上下文、多子包重构或复杂慢查询排障时,固定月费订阅比纯按量 API 更容易锁死成本上限。本站支持支付宝、微信支付与 AlipayHK 卡密自助兑换 iOS 链路的 Claude Pro 自助充值、5 倍额度的 Claude Max 5x 与顶配 Claude Max 20x,无需交出账号密码。
二、跨平台全栈进阶版:Windows 通用 + 前端/Python 自动分流
在 Windows Git Bash 或 PowerShell 下经常没装 jq(Windows 常见路径坑见 Claude Code Windows 路径与终端避坑),而且全栈项目里既有 .tsx 又有 .py。最干净的做法是在仓库放一个 scripts/auto_fmt.py:
python
import sys, json, subprocess, os
data = json.load(sys.stdin)
ti = data.get("tool_input") or {}
fp = ti.get("file_path") or ti.get("path") or ""
if not fp or not os.path.isfile(fp):
sys.exit(0)
if fp.endswith((".ts", ".tsx", ".js", ".jsx", ".css", ".json", ".md")):
subprocess.run(["npx", "prettier", "--write", fp], check=False, shell=(os.name == "nt"))
elif fp.endswith(".py"):
subprocess.run(["ruff", "format", fp], check=False)
subprocess.run(["ruff", "check", "--fix", fp], check=False)
随后在 .claude/settings.json 里直接指向这个脚本(settings 完整结构见 Claude Code settings.json 配置详解):
json
{
"hooks": {
"PostToolUse": [
{
"matcher": "Edit|Write",
"hooks": [
{
"type": "command",
"command": "python scripts/auto_fmt.py"
}
]
}
]
}
}
这样一来,每当智能体写完 Python 文件就会秒级跑完 ruff format 和自动导包清理,写完 React 组件就秒级跑完 prettier,你点开 Diff 审阅时看到的永远是干干净净、只包含实质业务改动的对比视图。
常见问题
问:能不能在每次 Edit 后顺便把全量 tsc --noEmit 类型检查也塞进这个钩子里?
答:小项目可以,但在大型工程里全量跑一次 tsc 动辄要五到十秒,会让智能体连续改五个文件时每步都卡顿一下。高频逐文件 PostToolUse 建议只放亚秒级的单文件格式化(Prettier / Biome / Ruff),耗时的全量类型检查与单测更适合挂在完成收尾(Stop)或 Git 提交前钩子上。
问:格式化脚本直接在后台改了刚写完的文件,会让 Claude 下一步再改同一文件时行号对不上吗?
答:偶发大段折行重排时确实可能让旧行号偏移,但 Claude Code 的 Edit 工具在发现目标片段不完全匹配时会自动重读最新文件内容对齐,实际使用几乎无感。
问:配完 .claude/settings.json 怎么确认钩子有没有成功挂载?
答:重启一次 claude 会话或在交互框里输入 /hooks 查看当前已激活的钩子清单,随便让它改一行注释保存,看缩进有没有被自动拉齐即可验证。
问:团队里有人本地没全局装 ruff,配进共享 .claude/settings.json 会不会给前端同事一直刷报错?
答:直接裸调未安装的二进制确实可能打印找不到命令提示。跨职能共用同一个仓库配置时,可以在上面的 auto_fmt.py 脚本里先用 shutil.which("ruff") 判断当前机器环境是否安装了对应格式化工具——检测到本机存在 ruff 才执行 Python 排版,纯前端同事的电脑没装则安静跳过返回成功状态码,既不打断日常编码也不污染终端面板。
问:PostToolUse 和 PreToolUse 在改文件场景下怎么分工?
答:PreToolUse 在落盘前运行,适合拦截智能体试图修改只读生成目录(如自动生成的 SDK 代码或历史迁移文件);而 PostToolUse 在文件已经写进磁盘之后运行,专门负责代码美化、补齐结尾换行等无阻断收尾动作。
问:国内没有海外银行卡,怎么给 Claude Code 开通 Pro 或 Max 订阅最稳妥?
答:可在 Claude Code 订阅说明页 或 Claude Max 充值页 选择走苹果 iOS 官方内购链路的自助卡密,自己复制登录凭证提交即可到账,全程无需把密码交给他人;若账号偶发弹出身份核验,也可查看 Claude KYC 人工协助(失败不收费,封号不在质保范围)。
0 条评论
还没有评论,来抢沙发~