Claude Code의 26가지 Hook 라이프사이클 전체 가이드

실용적 조언

Claude Code를 커스텀하거나 확장하려는 개발자는 PreToolUse와 PostToolUse Hook을 활용해 도구 실행 전후의 로직을 제어할 수 있다.

섹션별 상세

Claude Code는 SessionStart부터 FileChanged까지 총 26개의 Hook을 통해 에이전트의 동작을 제어한다. 각 Hook은 에이전트가 도구를 사용하거나 사용자 입력을 처리하는 특정 시점에 트리거되어 데이터를 주고받는다. 이 시스템을 통해 개발자는 에이전트의 실행 흐름에 개입하거나 상태를 모니터링하는 것이 가능하다.

Claude Code의 Hook 라이프사이클을 보여주는 플로우차트와 발표자의 모습이 담긴 스크린샷이다. — DiagramSessionStart에서 SessionEnd까지 이어지는 전체 흐름과 'Agentic Loop' 내의 세부 Hook(PreToolUse, PermissionRequest 등) 배치를 시각적으로 설명한다. 노란색 박스로 표시된 각 Hook의 실행 순서와 관계를 한눈에 파악할 수 있어 기술적 이해를 돕는다.

에이전트 루프(Agentic Loop) 내에서 PreToolUse, PermissionRequest, PostToolUse 등의 Hook이 순차적으로 실행된다. 도구 실행 전후로 권한을 요청하거나 결과를 처리하는 과정을 시각화하여 에이전트의 의사결정 단계를 명확히 나타냈다. 이는 복잡한 자율 코딩 작업의 투명성을 높이는 데 기여한다.

프로젝트의 모든 구성 요소인 GitHub 저장소, 오디오, 발표 자료는 Claude Code가 스스로 생성했다. 이는 AI 에이전트가 자신의 내부 로직을 설명하는 콘텐츠를 직접 제작할 수 있는 능력을 갖추었음을 입증한다. 사용자는 제공된 리포지토리를 통해 실제 구현 방식을 확인하는 것이 가능하다.

용어 해설

훅(Hook): — 프로그램의 특정 이벤트가 발생할 때 실행되는 코드 지점이다. Claude Code에서는 세션 시작이나 도구 사용 같은 이벤트에 Hook을 연결하여 에이전트의 동작을 확장하거나 데이터를 가공하는 용도로 사용된다.
라이프사이클(Lifecycle): — 소프트웨어나 프로세스가 시작되어 종료될 때까지 거치는 일련의 단계이다. 이 가이드에서는 Claude Code 에이전트가 사용자 요청을 받고 결과를 출력하기까지 거치는 26개 단계의 순서를 정의한다.
에이전트 루프(Agentic Loop): — AI 에이전트가 목표를 달성하기 위해 '생각-행동-관찰'을 반복하는 순환 구조이다. Claude Code의 Hook들은 이 루프의 각 단계에 배치되어 에이전트의 자율적인 작업 수행 과정을 제어한다.

언급된 도구

Claude Code추천

자율 AI 코딩 에이전트 CLI 도구

언급된 리소스

GitHubClaude Code Hooks GitHub Repository

DemoClaude Code Hooks Lifecycle Walkthrough Video