Hooks
개요
Hooks는 Claude Code의 특정 이벤트에 반응하여 자동으로 실행되는 스크립트입니다. 도구 실행 전후나 특정 조건에서 커스텀 로직을 실행할 수 있습니다.
주요 특징
- 이벤트 기반 자동 실행
- 도구 실행 전/후 개입
- 검증 및 변환 로직 적용
- 워크플로우 자동화
사용 방법
훅 설정 위치
settings.json 파일에서 설정:
{
"hooks": {
"PreToolUse": [
{
"matcher": "Bash",
"command": "echo 'Bash 명령어 실행 전'"
}
],
"PostToolUse": [
{
"matcher": "Write",
"command": "echo 'Bash 명령어 실행 후'"
}
]
}
}
가장 기본적인 훅 타입
- PreToolUse: 도구 실행 전
- PostToolUse: 도구 실행 후
- Notification: 알림 발생 시
- Stop: Claude 응답 완료 후
예제
알림 훅
플러그인에 hook을 추가하여 설치하는 경우 CLAUDE_PLUGIN_ROOT 경로를 사용할 수 있습니다.
{
"hooks": {
"Stop": [
{
"hooks": [
{
"type": "command",
"command": "${CLAUDE_PLUGIN_ROOT}/hooks/stop-notification.sh"
}
]
}
]
}
}