結論先說
- 格式化這種百分之百確定的機械動作,絕不該靠大模型自覺,而該掛在
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 條評論
還沒有評論,來搶沙發~