Claude Code의 hooks는 “언젠가 LLM이 알아서 하겠지”가 아니라, 특정 시점에 특정 검사를 반드시 실행하도록 만드는 장치입니다. 이 글은 공식 문서의 참조 스키마를 기준으로, 어떤 이벤트가 있고(언제 발화하고), matcher가 무엇을 필터링하며, 훅이 어떤 방식으로 Claude Code의 동작을 허용/차단/계속 작업 유도 할 수 있는지까지 한 번에 정리합니다.
핵심은 2가지입니다.
훅은 명령(Exit code) 과 구조화된 JSON 출력 두 축으로 동작을 제어합니다. “차단 가능 여부”는 이벤트마다 다릅니다. PreToolUse는 실행 전이라 차단이 되지만 PostToolUse는 실행 후라 차단이 아닌 피드백 으로 작동합니다.
더보기