Claude Code에서 특정 이벤트 전후에 자동으로 실행되는 셸 명령. 프롬프트가 아니라 운영체제가 직접 실행하므로 100% 확실하게 동작한다.

훅이란

Claude가 파일을 수정하거나 명령을 실행할 때, 그 전후에 자동으로 셸 스크립트를 실행시키는 메커니즘이다. 중요한 점은 LLM이 해석하는 프롬프트가 아니라 운영체제가 직접 실행하는 스크립트라는 것이다. "prettier 돌려줘"라고 부탁하는 게 아니라, 파일이 수정되면 무조건 prettier가 돌아간다.

사용 예시

settings.json에서 이벤트별로 훅을 등록한다. PostToolUse 훅에 prettier를 걸면 파일 수정 후 자동으로 포맷팅이 적용된다. PreToolUse 훅으로 rm -rf나 DROP TABLE이 포함된 명령을 차단하면 위험한 실행을 원천 봉쇄할 수 있다.

멀티에이전트와 조합하면 더 유용하다. 여러 에이전트가 동시에 코드를 건드려도 훅이 매번 린트와 타입 체크를 돌려서 코드 스타일이 깨지지 않는다. 하네스 엔지니어링 관점에서 훅은 에이전트의 행동을 감싸는 가드레일 역할을 한다.