# Hooks

> 출처: https://retn.kr/glossary/hooks/ · 수정 2026-10-26 · 리텐션 주식회사

**정의:** Claude Code 작업 흐름의 정해진 시점에 자동으로 실행되는 사용자 정의 명령으로, 도구 실행을 막을 수도 있다.

**다른 이름:** 훅, Claude Code hooks

## 실무에서 뜻하는 것

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

## 리텐션에서 쓴 예

[AI 에이전트에게 사업을 맡기는 대표가 놓치는 "Human In The Lead"](/blog/ai-eijeonteuege-saeobeul-matgineun-daepyoga-nohcineun-human-in-the-lead-a2ae-du-beon-geolrin-nal/) 글에는 훅이 조용히 일을 막은 사례가 나옵니다. 주간 자동화가 파일을 stage까지만 하고 커밋하지 못했습니다. 원인은 `rtk hook claude`가 `git commit`을 조용히 차단한 것이었습니다. 첫 실행의 커밋은 사람이 직접 찍었습니다. 감사 에이전트는 90일 안에 자율 커밋이 실패할 확률을 0.90으로 봤습니다.

## 헷갈리기 쉬운 것

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