Hook이 뭐예요?

Claude Code를 쓰다 보면
“이거 매번 똑같이 말해야 하나?” 싶은 순간이 생겨요.

예를 들면 세션을 시작할 때마다
디자인 시스템 파일을 읽어달라고 하거나,
작업이 끝나면 알림을 보내달라고 하거나,
항상 같은 규칙을 먼저 알려줘야 하는 경우가 있죠.

이럴 때 유용한 기능이 바로 Hooks예요.
Hook은 쉽게 말하면 특정 시점에 자동으로 명령을 실행하는 기능이에요.

반복해서 지시하지 않아도, 원하는 시점에 자동으로 특정 동작이 실행되게 만들 수 있어요.
디자이너 입장에서는 반복 업무를 줄이고, 작업 흐름을 훨씬 부드럽게 만들어주는 기능이라고 보면 돼요.

조건만 걸어두면 알아서 실행돼요

Hook은 “언제 실행할지”만 정해두면
그 시점에 맞춰 자동으로 동작해요.

Claude Code에서는 대표적으로 다섯 가지 조건에서 Hook을 걸 수 있어요.

1. SessionStart
대화가 시작되기 전마다 실행돼요.

2. PreToolUse
툴을 쓰기 전에 실행돼요.

3. PostToolUse
툴을 사용한 뒤에 실행돼요.

4. Stop
대화가 끝날 때 실행돼요.

5. Notification
알림이 올 때 실행돼요.

이걸 잘 활용하면
작업 시작, 도구 사용 전후, 작업 종료 같은 흐름마다
내가 원하는 자동화를 붙일 수 있어요.

지금부터 실제로 어떻게 활용 가능한지 알려드릴게요.

1. 세션 시작 시 디자인 시스템 자동 로드

디자이너라면 가장 먼저 떠올릴 수 있는 활용 방식이
세션 시작할 때 디자인 시스템을 자동으로 읽게 하는 것이에요.

보통 Claude로 디자인 작업을 할 때
컬러 토큰, 타이포 규칙, 컴포넌트 원칙 같은 내용을
먼저 알려줘야 할 때가 많잖아요.

근데 이걸 매번 다시 설명하는 건 꽤 번거로워요.
그래서 SessionStart Hook을 걸어두면
대화가 시작될 때마다 Claude가 자동으로
Design System.md 같은 파일을 읽고 시작할 수 있어요.

이렇게 해두면
매번 말 안 해도 우리 디자인 시스템을 기억하는 상태로 시작할 수 있어서
작업 속도도 빨라지고 결과도 더 일관돼져요.

2. 작업 끝나면 MacOS 알림 받기

또 정말 실용적인 예시는
작업이 끝났을 때 알림을 받는 것이에요.

Claude에게 뭔가 긴 작업을 시켜두면
그동안 다른 일을 하게 되잖아요.
근데 어느 순간 끝났는지 계속 확인하러 가는 것도 은근 번거로워요.

이럴 때 Hook으로 알림을 걸어두면
작업이 끝났을 때 MacOS 알림으로 바로 알려줄 수 있어요.
그래서 다른 일을 하고 있어도 부담이 훨씬 줄어요.

게다가 이런 알림은 Slack 같은 툴과도 연동할 수 있어서
조금 더 확장된 자동화 흐름으로 만들 수도 있어요.

.md파일이랑은 뭐가 다를까?

둘 다 Claude와 함께 작업할 때 자주 쓰이지만, 역할은 꽤 달라요.

먼저 .md 파일은
작업할 때 참고할 수 있는 문서예요.
업무 매뉴얼이나 디자인 시스템처럼
“이런 규칙으로 작업해줘”라고 알려주는 역할을 해요.
즉, 실행 결과물에 영향을 주는 기준 문서에 가까워요.

반면 Hook은
그 문서를 언제 읽고, 언제 알림을 보내고,
언제 특정 동작을 하게 할지를 정하는 자동화 장치예요.
즉, 실행 과정에 영향을 주는 시스템이라고 볼 수 있어요.

Hook 설정은 ClaudeCode에게 부탁하면 끝나요

Hook 설정 자체를 내가 일일이 복잡하게 외울 필요가 없어요.

원하는 동작을 자연어로 설명하면
Claude Code가 그에 맞는 Hook 설정을 도와줄 수 있어요.

“Claude가 알림을 보낼 때 macOS 알림이 뜨도록 Hook을 설정해줘.
~/.claude/settings.json에 추가해줘.”

또는

“Session이 시작될 때마다 Design System.md 파일을 읽는 Hook을 설정해줘.
~/.claude/settings.json에 추가해줘.”

이런 식으로 말하면
직접 복잡한 설정 구조를 다 기억하지 않아도
원하는 자동화를 꽤 쉽게 붙일 수 있어요.

결국 중요한 건
Hook 문법을 전부 외우는 게 아니라,
내가 어떤 반복을 줄이고 싶은지 먼저 아는 것이에요!