5개 생명주기 훅(Lifecycle Hooks)
훅 | 실행 시점 | 주요 용도 |
SessionStart | Claude Code 세션 시작 시 | 환경 초기화, 컨텍스트 설정 |
UserPromptSubmit | 사용자가 프롬프트를 입력할 때 | 입력 검증·가공, 추가 컨텍스트 주입 |
PreToolUse | Claude가 도구를 실행하기 직전 | 실행 전 검증·차단·수정 |
PostToolUse | 도구 실행이 끝난 직후 | 결과 확인, 후처리, 로그 |
Stop | Claude의 작업이 끝날 때 | 종료 시 검사, 정리 작업 |
전체 흐름
Claude Code 실행
│
▼
SessionStart
│
▼
사용자 프롬프트 입력
│
▼
UserPromptSubmit
│
▼
Claude가 작업 계획
│
▼
PreToolUse ──→ 도구 실행 허용/차단
│
▼
Tool 실행
│
▼
PostToolUse ──→ 결과 후처리
│
▼
Claude 작업 종료
│
▼
Stop
Markdown
복사