Claude Code Hooks — 브리핑·검토게이트·자동 백업을
사람이 안 챙겨도 되게
Claude Code의 Hooks(훅)는 '정해둔 순간에 자동으로 실행되는 규칙'이에요. 세션을 켜면 어제 한 일을 브리핑하고, 결과를 내놓기 전에 자동 점검하고, 작업이 끝나면 자동 백업하는 걸 — 사람이 매번 기억해서 챙기지 않아도 시스템이 알아서 해줘요.
그래서 뭐가 좋아지나 — 깜빡할 일을 시스템이 챙긴다
앞선 편들(CLAUDE.md·서브에이전트·Skills)이 'AI가 무엇을·어떻게 하는지'를 정했다면, Hooks는 '언제 알아서 끼어들지'를 정해요. 가장 와닿는 장면 하나로 볼게요.
작업을 끝낼 때마다 '아 백업해야지', '빠진 거 없나 다시 봐야지'를 내가 기억해서 해야 해요. 바쁘면 깜빡하고 넘어가고, 나중에 "그때 그 버전 어디 갔지?" 하며 찾게 돼요.
작업이 끝나는 순간 Hook이 자동으로 결과를 백업하고, 빠진 게 없는지 점검해요. 내가 아무것도 기억하지 않아도, 매번 똑같이 챙겨져요.
핵심은 '사람의 기억력에 의존하던 일'을 '정해진 순간에 자동으로' 바꾸는 거예요. 한번 걸어두면 그다음부터는 신경 쓸 필요가 없어요.
Hook이란 — 정해둔 순간에 끼어드는 자동 규칙
Hook은 우리말로 '갈고리'예요. 작업 흐름의 특정 순간에 갈고리를 걸어두고, 그 순간이 오면 미리 정해둔 일이 자동으로 실행되게 하는 거예요. 비유하자면 현관 센서등 같은 거예요. 내가 스위치를 누르는 게 아니라, '문이 열리는 순간'이라는 조건에 불이 켜지도록 한 번 걸어둔 거죠.
Claude Code에서 갈고리를 걸 수 있는 대표적인 순간은 이런 거예요.
- 세션이 시작될 때 — Claude Code를 켜는 순간
- 내가 요청을 보낼 때 — 무언가를 시키는 순간
- 작업이 끝났을 때 — AI가 결과를 내놓고 마무리하는 순간
이 각각의 순간에 '무엇을 자동으로 할지'를 붙여두는 게 Hook이에요. 아래 그림으로 한 번의 작업이 흐르는 동안 어디에 어떤 갈고리가 걸리는지 보면 직관적으로 이해돼요.
실무에서 쓸 만한 대표 Hook 3가지
이론은 여기까지면 충분해요. 비개발 실무자가 바로 효과를 보는 세 가지만 콕 집어 볼게요.
1. 세션 브리핑 — 켜면 어제 맥락부터 요약
여러 날에 걸친 일이라면, 어제 어디까지 했는지 다시 떠올리는 데만 시간이 들어요. 세션이 시작될 때 자동으로 '지난번 진행 상황'을 요약해주게 걸어두면, 켜자마자 바로 이어서 일할 수 있어요. (SNS 마케팅처럼 캠페인이 며칠씩 이어지는 일에 특히 좋아요.)
2. 검토 게이트 — 결과 내놓기 전 자동 점검
3편에서 다룬 '검토 게이트'를 사람의 약속이 아니라 작업이 끝나는 순간 자동으로 한 번 더 돌게 만드는 거예요. 빠진 요구는 없는지, 처음 목표를 채웠는지를 결과를 주기 직전에 스스로 점검해요.
3. 자동 백업 — 작업 후 알아서 저장
작업이 끝날 때마다 그 시점의 결과를 자동으로 백업해두면, 나중에 "두 시간 전 버전으로 돌리고 싶다" 같은 상황에서 살아나요. 따로 '저장' 버튼을 누르는 습관을 들일 필요가 없어요.
중요 — Hook은 직접 짜지 말고 '시켜서 설정'하세요
Hook은 '내가 쓰는 글'이 아니라 '한 번 해두는 설정'에 가까워요. 그래서 비개발자는 코드를 직접 만들 필요 없이, Claude Code에게 말로 시켜서 설정하면 돼요. 무엇을·언제 자동화하고 싶은지만 말로 설명하면, 설정은 AI가 만들어줘요.
# 세션을 켜면 — 묻지 않아도 먼저
지난 작업 이어서 안내: 어제 'X 캠페인 카피' 3안까지
작성하고 검수 대기 중이었어요. 4안부터 이어갈까요?
# 작업을 끝내면 — 자동으로
결과 백업 완료 · 빠진 요구 점검 통과[ ] 같은 표시 없이도 돼요. 무엇을·어떤 순간에 자동으로 하고 싶은지만 한국어로 또렷이 말하면, 그게 곧 설정이 돼요.
참고로 이렇게 만든 hook 설정은 작업 폴더의 .claude/settings.json이라는 파일에 저장돼요. 어떤 hook을 걸어놨는지 보고 싶으면 "지금 걸려 있는 hook 설정 보여줘"라고 하면 정리해줘요.
출처: Claude Code 공식 문서(Hooks) — code.claude.com/docs
한 가지 주의 — 꼭 필요한 것만
편하다고 갈고리를 너무 많이 걸면, 매 순간 이것저것 자동 실행되느라 오히려 느려지고 정신없어져요. '없으면 자꾸 깜빡하는 일'에만 거는 게 좋아요. 보통은 위 세 가지(브리핑·검토·백업)면 충분하고, 쓰다가 "이건 매번 손으로 챙기네" 싶은 게 또 생기면 그때 하나씩 추가하면 돼요.
Hooks의 진짜 가치는 '자동화'라는 단어보다 '기억하지 않아도 됨'에 있어요. 우리가 일에서 실수하는 건 능력이 없어서가 아니라, 대부분 바쁠 때 한두 단계를 깜빡해서거든요. 그 깜빡임의 자리에 갈고리를 걸어두면, 바쁜 날에도 기본은 지켜져요.
그러니 거창하게 시작하지 마세요. '작업 끝나면 백업' 하나만 걸어둬도 일주일 뒤엔 "이걸 왜 이제야 했지" 싶어질 거예요.