Hooks

실무에서 뜻하는 것

훅은 “이 일이 일어나면 반드시 이것을 실행한다”는 자동 규칙입니다. 도구 실행 직전(PreToolUse), 직후(PostToolUse), 세션 시작(SessionStart), 응답 종료(Stop) 같은 시점에 셸 명령 등을 붙입니다. 설정은 settings.json에 적습니다. PreToolUse 훅이 종료 코드 2를 돌려주면 그 도구 호출은 실행되지 않습니다. 파일 편집 뒤 자동 포맷, 커밋 전 lint, 긴 로그에서 에러 줄만 남기기 같은 일에 씁니다.

리텐션에서 쓴 예

AI 에이전트에게 사업을 맡기는 대표가 놓치는 “Human In The Lead” 글에는 훅이 조용히 일을 막은 사례가 나옵니다. 주간 자동화가 파일을 stage까지만 하고 커밋하지 못했습니다. 원인은 rtk hook claude가 git commit을 조용히 차단한 것이었습니다. 첫 실행의 커밋은 사람이 직접 찍었습니다. 감사 에이전트는 90일 안에 자율 커밋이 실패할 확률을 0.90으로 봤습니다.

헷갈리기 쉬운 것

CLAUDE.md의 지침은 Claude가 판단해 따릅니다. 훅은 Claude의 판단과 상관없이 실행됩니다. 그래서 훅이 작업을 막아도 겉으로는 정상처럼 보일 수 있습니다. 메타 광고의 오프닝 훅이나 웹훅과는 다른 개념입니다.