Hooks

https://code.claude.com/docs/ko/hooks

Hooks 참조 - Claude Code Docs

 

🛠️ Claude Code의 자동화 핵심 'Hooks'

안녕하세요! 오늘은 클로드 코드(Claude Code)를 훨씬 더 똑똑하게 만드는 비밀 병기, 훅(Hooks)에 대해 알아보겠습니다. 매번 반복되는 설정을 일일이 입력하기 귀찮으셨다면, 이 글이 큰 도움이 될 거예요! 😊

 

1. 훅(Hook)이란 무엇인가요? 🪝

클로드 코드에서 훅(Hook)은 특정 상황(이벤트)이 발생했을 때 시스템이 자동으로 실행하도록 미리 설정해둔 명령어나 스크립트를 말합니다.

💡 비유하자면?
"현관문이 열리면(이벤트) → 전등을 켜라(액션)"는 스마트 홈의 센서 등과 같은 원리입니다!

• 자동화 🤖: 일일이 명령하지 않아도 정해진 시점에 알아서 작동합니다.
• 일관성 📏: 새로운 세션을 시작할 때마다 프로젝트 정보를 클로드에게 자동으로 주입해 줍니다.

2. 가장 많이 쓰이는 훅: SessionStart 🚀

클로드 코드를 실행할 때 가장 먼저 만나는 훅입니다.

• 실행 시점: claude 명령어를 입력해 새로운 세션을 시작할 때 딱 한 번 실행됩니다.
• 주요 활용 예시:
  • git status를 확인하여 현재 작업 상태 파악
  • 최근 변경된 파일 목록 읽기
  • 사용자가 이전에 "기억해줘"라고 했던 메모를 컨텍스트에 자동 로드

3. 왜 훅을 사용해야 할까요? 🤔

가장 큰 이유는 '끊김 없는 개발 환경' 때문입니다.

1. 컨텍스트 유지: "변경사항을 반영해줘"라고 요청하면 클로드는 이를 훅 형태로 저장합니다.
2. 자동 로드: 다음번에 클로드를 켰을 때, 이전 메모를 자동으로 읽어옵니다.
3. 설명 생략: "지난번에 어디까지 했지?"라고 다시 설명할 필요가 없어집니다! ✨

4. 훅의 관제센터, /hooks 커맨드 🕹️

현재 내 클로드 코드에 어떤 자동화 규칙이 설정되어 있는지 궁금하다면 터미널에 /hooks를 입력해 보세요.

✅ 주요 기능

• 목록 확인: 등록된 모든 훅(예: SessionStart)을 한눈에 보여줍니다.
• 상태 체크: 각 훅이 현재 작동 중인지(On/Off) 확인합니다.
• 내용 열람: 실행될 구체적인 스크립트 내용을 미리 볼 수 있습니다.

💡 꿀팁: 수정했는데 적용이 안 된다면?

훅은 보통 '시작될 때' 작동합니다. 수정 사항을 즉시 반영하고 싶다면, 현재 세션을 종료(Ctrl+C 또는 /exit)하고 새로운 세션을 실행해 주세요!

 

5. 한눈에 보는 주요 훅 리스트 📋

훅 이름	주요 역할
SessionStart	시작 시 git status 확인, 할 일(TODO) 요약, 프로젝트 스택 브리핑
Context Memory	이전 세션의 메모나 변경 사항 자동 불러오기
Env Check	개발 환경(Node, Java 버전 등)이 프로젝트와 맞는지 자동 체크

 

🎯 요약하자면!

훅은 클로드 코드에게 미리 건네준 '자동 업무 체크리스트'입니다. 여러분의 개발 흐름을 방해하지 않고, 클로드가 항상 최신 문맥을 유지할 수 있게 도와주는 핵심 연결 고리죠.

지금 바로 터미널에 /hooks를 입력해 여러분의 자동화 목록을 확인해 보세요! 💻🔥