처음으로
2알아 두기

훅이 도는 때

훅은 Claude Code가 정해진 때마다 실행하는 명령이에요. 자주 쓰는 때만 추리면 이래요.

이벤트 언제 막을 수 있나
SessionStart 세션을 새로 열거나 다시 열 때 못 막아요. 대신 훅이 찍은 평문이 Claude가 읽는 맥락에 들어가요
UserPromptSubmit 사람이 보낸 말을 Claude가 처리하기 전 막을 수 있어요
PreToolUse 셸 명령·파일 쓰기 같은 도구를 실행하기 직전 막을 수 있어요
PostToolUse 도구가 성공한 뒤 이미 실행된 뒤예요
Stop Claude가 답을 마칠 때 막으면 Claude가 멈추지 않고 이어서 일해요

이 밖에도 대화를 압축하기 전후, 하위 에이전트가 시작하고 끝날 때 같은 때가 더 있어요. 전체 목록은 아래 «근거»의 공식 문서에 있어요.

운영자 PC와 이 사이트 저장소에 걸린 훅을 도는 때별로 나눈 그림. 세션을 열 때 네 개, 명령 직전에 세 개, 답을 마칠 때 두 개가 돌아요.
운영자 PC와 이 사이트 저장소에 걸린 훅을 도는 때별로 나눈 그림. 세션을 열 때 네 개, 명령 직전에 세 개, 답을 마칠 때 두 개가 돌아요.

운영자가 쓰는 때는 세 가지뿐이에요. 막는 일은 명령 직전(PreToolUse)에, 치우는 일은 답을 마칠 때(Stop)와 세션을 열 때(SessionStart)에 해요.

차례로 돌아가기