
클로드에게 일을 맡겨 놓고 '다 됐나?' 싶어서 화면을 몇 번씩 확인하고 계시진 않나요?
제 경험을 먼저 말씀드릴게요. 보고서 초안이나 엑셀 정리를 클로드코드에 시켜 두고 메일 업무로 넘어갔다가 돌아오면, 클로드가 파일을 고쳐도 되는지 허락을 구한 상태로 그대로 서 있는 경우가 많았습니다. CLAUDE.md에 원본은 손대지 말라고 분명히 써 두었는데도 마음 한구석이 늘 불안했고요.
화면을 계속 들여다봐야 하는 답답함도, 원본 파일이 걱정되는 불안함도 한 번에 풀어 준 게 클로드코드의 훅(Hooks) 기능이에요. 이름만 들으면 개발자 전용 기능 같지만, 실제로는 클로드에게 우리말로 요청하는 것만으로 충분히 설정할 수 있었습니다. 코딩을 모르는 제가 직접 걸어 두고 효과를 본 알림, 보호, 점검 훅을 차례로 소개할게요.
매뉴얼은 '부탁', 훅은 '자동 장치'예요
공식 문서에 따르면 훅은 사용자가 미리 정해 둔 명령이고, 클로드코드가 일하는 도중 특정 시점이 되면 저절로 실행됩니다. 핵심은 AI가 상황을 보고 할지 말지 고르는 게 아니라는 점이에요. 조건이 맞으면 정해 둔 동작이 매번 빠짐없이 일어납니다.
CLAUDE.md와 나란히 놓고 보면 차이가 선명해져요.
- CLAUDE.md는 클로드가 읽고 따르는 업무 지침서입니다. 대체로 잘 지키지만, AI가 스스로 판단해서 지키는 약속에 가깝습니다.
- 훅은 정해진 순간이 오면 예외 없이 작동하는 장치입니다. 예컨대 클로드가 내 응답을 기다리는 순간마다 알림창을 띄우는 식이에요.
그래서 둘 중 하나를 고를 필요는 없어요. 평소 일하는 방식은 CLAUDE.md에 적어 두고, 절대 놓치면 안 되는 일만 훅으로 묶어 두면 서로 빈틈을 채워 줍니다.
알림 훅: 클로드가 기다리면 바로 알려 줘요
처음 시작하는 분께 가장 권하고 싶은 건 알림 훅입니다. 공식 문서에서도 클로드가 입력을 기다릴 때 알림을 받는 방법을 대표 사례로 소개하고 있어요. 클로드가 허락을 요청하거나 제 답을 기다리는 순간 화면에 알림창이 나타나게 하는 방식이죠.
저는 클로드코드에 이렇게 요청했습니다.
- "공식 문서에 있는 Notification 훅 예시를 참고해서, 네가 내 확인을 기다릴 때마다 윈도우 알림창이 뜨게 내 사용자 설정에 훅을 넣어 줘. 다 하고 나면 무엇이 바뀌었는지 쉬운 말로 알려 줘."
클로드가 알아서 설정 파일을 열고 훅을 추가해 줬어요. 그 뒤로는 다른 프로그램에서 일하다가 알림창이 뜰 때만 돌아가 답하면 됩니다. 공식 문서 설명으로는 클로드가 응답을 끝낸 뒤 제가 아무 입력도 하지 않으면 약 60초가 지나서도 알림이 온다고 해요. 덕분에 괜히 창을 들락날락하는 일이 눈에 띄게 줄었습니다.
한 가지 팁을 더하면, 공식 문서에는 윈도우용 명령이 작은 대화상자를 띄우는 형태라 터미널 창 뒤쪽에 가려져 열릴 수도 있다고 적혀 있어요. 설정을 마쳤다면 클로드에게 "알림이 제대로 뜨는지 테스트해 줘"라고 한 번 시켜 보시길 권합니다.
보호 훅: 원본 폴더에는 손대지 못하게
다음으로 건 훅은 소중한 원본 파일을 지키는 용도예요. 공식 문서에는 클로드가 파일을 수정하기 바로 앞 단계에서 검사를 해서, 보호 대상으로 지정된 파일이라면 수정을 막아 버리는 예시가 실려 있습니다.
저는 거래처 원본 데이터를 모아 둔 폴더에 이 장치를 달았어요. 요청은 이렇게 했습니다.
- "이 프로젝트의 '원본' 폴더에 있는 파일은 고치거나 덮어쓸 수 없게 막는 훅을 만들어 줘. 공식 문서의 보호 파일 예시를 참고하고, 막혔을 때는 이유를 알려 주는 메시지도 나오게 해 줘."
다만 알고 쓰셔야 할 부분이 있어요. 공식 문서에 따르면 이 훅은 클로드가 파일 편집 도구를 사용할 때 작동하는 방어선이라, 다른 명령을 통해 파일이 바뀌는 경우까지 전부 차단하지는 못합니다. 그래서 문서에서도 권한 설정에 해당 파일 수정을 거부하는 규칙을 같이 넣으라고 권해요. 저 역시 "권한 설정에도 같은 폴더 수정 금지 규칙을 추가해 줘"라고 이어서 부탁했습니다. 그리고 무엇보다 원본을 따로 백업해 두는 습관이 가장 든든한 안전장치라는 점도 잊지 마세요.
윈도우 환경이라면 이런 검사형 훅이 Git Bash 같은 프로그램을 필요로 할 수 있습니다. 설치나 설정 단계에서 막힌다면 "이 훅이 내 컴퓨터에서 실제로 돌아가는지 확인하고, 안 되면 원인을 설명해 줘"라고 클로드에게 넘기시면 돼요.
점검 훅: 끝내기 전에 빠진 것 확인하기
클로드가 "작업을 마쳤습니다"라고 했는데 막상 열어 보면 뭔가 빠져 있던 적, 있으시죠? 공식 문서에는 클로드가 응답을 마무리하려는 시점에 다른 클로드 모델이 요청한 일이 정말 끝났는지 판단하게 하는 프롬프트 기반 훅이 소개돼 있어요. 아직 덜 됐다고 판단되면 그 이유를 근거로 클로드가 작업을 다시 이어 갑니다.
저는 매주 쓰는 보고서 작업 폴더에 이렇게 적용했어요.
- "작업을 마치기 전에 내가 요청한 표, 요약, 출처가 전부 들어갔는지 확인하는 Stop 훅을 이 프로젝트에 넣어 줘."
주의할 점은, 공식 문서 기준으로 이 훅이 전체 작업이 끝날 때 한 번만 도는 게 아니라 클로드가 응답을 마칠 때마다 실행된다는 거예요. 그러니 확인 기준은 짧고 명확하게 정해 두는 편이 좋습니다. 기준이 모호하면 클로드가 필요 없는 작업을 계속 붙잡고 있을 수 있거든요.
처음 쓰는 분을 위한 안전 수칙
직접 써 보며 얻은 노하우를 모아 봤어요.
- 설정 파일은 손으로 고치지 말고 클로드에게 말로 맡기세요. 이때 "바꾼 내용을 쉽게 설명해 줘"라는 한마디를 꼭 붙이시고요.
- 클로드코드에서 /hooks 를 입력하면 현재 적용된 훅을 종류별로 확인할 수 있어요. 틈틈이 열어 보며 점검해 두면 안심이 됩니다.
- 알림처럼 어디서나 쓸 훅은 사용자 설정에, 원본 보호나 보고서 점검처럼 특정 업무용 훅은 해당 프로젝트 설정에 넣어 달라고 나눠서 요청하세요.
- 허락 요청에 자동으로 승인해 버리는 훅도 만들 수는 있지만, 공식 문서는 적용 범위를 가능한 한 좁히라고 경고합니다. 익숙해지기 전까지는 쓰지 않는 쪽을 추천드려요.
- 뭔가 이상하다 싶으면 "훅을 전부 잠깐 꺼 줘"라고 말씀하세요. 공식 문서에 모든 훅을 한꺼번에 끄는 설정이 마련되어 있습니다.
돌이켜 보면 훅은 대단한 자동화 시스템이라기보다, 제가 놓치기 쉬운 부분을 묵묵히 챙겨 주는 든든한 비서 같은 존재였어요. 알림 훅 하나만 걸어 두어도 클로드에게 일을 맡기는 마음이 한결 가벼워지니, 오늘 바로 첫 훅부터 걸어 보시길 바랍니다.
참고 자료
- Claude Code 공식 문서, 훅 가이드: https://code.claude.com/docs/en/hooks-guide
- Claude Code 공식 문서, 훅 레퍼런스: https://code.claude.com/docs/en/hooks
#클로드코드 #클로드코드훅 #업무자동화 #비개발자 #AI활용 #ClaudeCode #AI비서 #클로드
'AI' 카테고리의 다른 글
| 코딩 몰라도 CLAUDE.md 하나로 클로드코드 업무 매뉴얼 완성했어요 (0) | 2026.11.19 |
|---|---|
| 코딩 몰라도 클로드코드 스킬로 우리 팀 업무 방식을 자동화했어요 (0) | 2026.11.18 |