Claude Code Hooks 사용법 이벤트별 자동 실행 설정

🪝

Claude의 기능들 5강

특정 상황이 되면 자동으로 작업을 실행시키는 기능입니다

Hooks란?

Hooks는 “이런 일이 생기면, 자동으로 이것도 해줘”라는 규칙입니다. Claude가 특정 작업을 할 때 전/후로 원하는 동작을 자동 실행합니다.

💡

비유: “문을 열면 자동으로 불이 켜지는 센서”와 같습니다. 매번 직접 스위치를 누를 필요 없이 자동으로 처리됩니다.

언제 자동 실행되나?

실행 전

작업 실행 전

Claude가 도구를 쓰기 직전

예: 위험한 명령 자동 차단

실행 후

작업 실행 후

Claude가 도구를 쓴 직후

예: 파일 저장 후 자동 정리

알림 시

알림 발생 시

알림이 발생할 때

예: 긴 작업 완료 시 알림 보내기

완료 시

응답 완료 시

Claude의 답변이 끝났을 때

예: 작업 완료 후 자동 검사

가장 쉽게 만드는 방법

직접 설정 파일을 편집할 필요 없이, Claude에게 대화로 요청하면 됩니다.

대화로 Hook 만들기

파일을 수정할 때마다 자동으로 코드 정리해주는 Hook을 만들어줘

더 구체적으로 요청하기

파일에 비밀번호나 API 키가 포함되면 자동으로 경고해주는 Hook을 설정해줘

Claude가 settings.json에 Hook 설정을 자동으로 추가해줍니다.

직접 설정하기

Hooks는 settings.json 파일 안에서 정의합니다. 별도의 폴더가 있는 것이 아닙니다.

예시: 파일 수정 후 자동으로 정리해주기

{
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "Write|Edit",
        "command": "npx prettier --write \"$CLAUDE_FILE_PATH\""
      }
    ]
  }
}

위 설정은 “Claude가 파일을 수정할 때마다, 자동으로 코드를 깔끔하게 정리해줘”라는 뜻입니다.

실용적인 활용

✨

자동 코드 정리

파일을 수정할 때마다 자동으로 줄 맞춤, 띄어쓰기 등을 깔끔하게 정리합니다.

🔔

완료 알림

오래 걸리는 작업이 끝나면 알림을 보내줍니다.

🔍

자동 검사

코드 변경 후 자동으로 오류가 없는지 확인합니다.

🛡️

보안 검사

파일에 비밀번호 같은 민감 정보가 실수로 들어가지 않았는지 확인합니다.

이전 강의Agents (서브에이전트)다음 강의MCP (외부 서비스 연결)

⚙️ Claude의 기능들5 / 9강