도구 호출 전후나 세션 시작 같은 시점에 실행되는 셸 명령입니다. 모델의 판단과 무관하게 무조건 돌기 때문에, '가끔 안 지키는 규칙'을 확실하게 만들 수 있습니다.
언제 쓰나
- 절대 어기면 안 되는 규칙이 있을 때 (생성 파일 수정 금지, 비밀값 커밋 금지)
- 매번 해야 하는 일이 있을 때 (저장 시 포맷터, 종료 전 테스트)
- 메모리에 적어도 자꾸 무시될 때 — 그때가 훅으로 옮길 신호입니다
주의할 점
- 느린 명령을 넣으면 모든 작업이 느려집니다.
- 훅 로그에 비밀값이 남지 않게 주의하세요.
- `$CLAUDE_TOOL_INPUT_FILE_PATH` 같은 환경변수는 없습니다. 도구 정보는 stdin으로 옵니다 — 없는 변수를 쓰면 값이 빈 문자열이 되어 조건이 안 맞고, 훅은 아무것도 막지 않으면서 막고 있는 것처럼 보입니다.
설정
{
"hooks": {
"PreToolUse": [{
"matcher": "Edit|Write",
"hooks": [{
"type": "command",
"command": "f=$(jq -r '.tool_input.file_path // empty'); case \"$f\" in */drizzle/*.sql) echo '마이그레이션은 직접 수정하지 않습니다' >&2; exit 2;; esac"
}]
}]
}
}