18장: 고급 활용 — 서브에이전트, 훅
서브에이전트: AI가 다른 AI에게 작업을 나눠 시키는 방법
지금까지는 Claude Code와 1:1로 대화하면서 작업했습니다. 서브에이전트는 Claude Code가 다른 AI 인스턴스를 만들어서 작업을 나눠 시키는 기능입니다.
예를 들어 "코드 리뷰하고 동시에 테스트도 작성해줘"라고 하면, Claude Code가 코드 리뷰 담당 AI와 테스트 작성 담당 AI를 각각 만들어서 동시에 작업하게 할 수 있습니다.
이 프로젝트에서 두 가지 작업을 동시에 해줘.
서브에이전트를 활용해도 좋아.
1. 코드 리뷰: 보안 문제와 에러 처리를 점검
2. 테스트 작성: 핵심 기능의 테스트 코드 작성
서브에이전트가 유용한 경우는 두 가지입니다.
독립적인 작업을 동시에 할 때. 코드 리뷰와 문서 작성처럼 서로 영향을 주지 않는 작업을 병렬로 처리합니다.
전문 역할을 나눌 때. "보안 전문가 관점에서 봐줘", "UI 전문가 관점에서 봐줘"처럼 각각 다른 시각으로 코드를 검토하게 할 수 있습니다.
단, 단순한 작업에 서브에이전트를 쓰면 오히려 느려질 수 있습니다. 작업이 복잡하지 않을 땐 그냥 Claude Code에게 직접 요청하는 게 빠릅니다. 처음에는 쓸 일이 많지 않습니다. 프로젝트가 커지고 작업이 복잡해지면 그때 활용하면 됩니다.
훅(Hooks): 특정 이벤트에 자동으로 반응하게 만들기
훅은 Claude Code가 특정 행동을 할 때 자동으로 무언가를 실행하는 기능입니다.
예를 들어 Claude Code가 파일을 수정할 때마다 코드 포맷을 자동으로 맞추거나, 작업이 끝났을 때 알림음을 울리는 것들을 설정할 수 있습니다.
훅의 작동 방식
훅은 이벤트 → 조건 → 실행의 구조입니다.
- Claude Code에서 특정 이벤트가 발생합니다 (파일 수정, 작업 완료, 권한 요청 등)
- 설정한 조건(matcher)에 맞는지 확인합니다
- 조건이 맞으면 지정한 명령어를 자동으로 실행합니다
주요 이벤트
| 이벤트 | 언제 발생하는가 |
|---|---|
Stop |
Claude Code가 응답을 마치고 멈출 때 |
PermissionRequest |
권한 승인이 필요할 때 |
PreToolUse |
도구(파일 수정, 명령 실행 등)를 사용하기 직전 |
PostToolUse |
도구를 사용한 직후 |
Notification |
알림을 보낼 때 |
실전 예시 1: 작업 완료 알림음
Claude Code가 긴 작업을 하는 동안 다른 일을 하고 있다면, 작업이 끝났을 때 소리로 알려주면 편합니다.
훅을 만들어줘.
Claude Code가 작업을 끝내면 알림음을 재생하는 훅이야.
내가 다른 앱을 보고 있을 때만 소리가 나면 돼.
실전 예시 2: 파일 수정 후 자동 포맷팅
훅을 만들어줘.
Claude Code가 코드 파일을 수정할 때마다 자동으로 prettier를 실행하는 훅이야.
실전 예시 3: 커밋 전 린트 체크
훅을 만들어줘.
Claude Code가 bash로 git commit을 실행하기 직전에
자동으로 린트를 먼저 실행하는 훅이야.
훅 관리하기
설정된 훅은 Claude Code에서 /hooks를 입력하면 확인하고 수정할 수 있습니다. 훅 설정은 ~/.claude/settings.json(전체 프로젝트 공통) 또는 .claude/settings.local.json(현재 프로젝트만)에 저장됩니다.
훅은 편리하지만, 잘못 설정하면 매번 쓸데없는 작업을 실행합니다. 처음에는 없어도 충분하니, 같은 불편을 자꾸 겪을 때 하나씩 추가하세요.
여기까지 왔다면
2장부터 여기까지 따라왔다면, 여러분은 이미 다음을 할 수 있습니다.
- Claude Code로 아이디어를 실제 웹 서비스로 만들기
- Supabase로 데이터를 저장하고 로그인 기능 구현하기
- 에러가 나도 AI와 함께 해결하기
- Vercel로 인터넷에 배포하고 링크 공유하기
- MCP와 CLI로 AI의 능력을 확장하기
- 스킬로 반복 작업을 자동화하기
- 훅으로 개발 흐름을 자동화하기
남은 건 하나입니다. 여러분만의 프로젝트를 만드는 것. AI가 코드를 짜는 시대에, 아이디어와 실행력을 가진 사람이 가장 빠릅니다.
✏️ 실습: 작업 완료 알림 훅 만들기
1단계: 작업 완료 알림 훅을 만들어달라고 요청합니다.
훅을 만들어줘.
Claude Code가 작업을 끝내면 알림음을 재생하는 훅이야.
내가 다른 앱을 보고 있을 때만 소리가 나면 돼.
2단계: 긴 작업을 하나 시켜보고 소리가 나는지 확인합니다.
이 프로젝트의 모든 파일을 훑어보고 코드 품질 리포트를 작성해줘.
작업이 끝나는 순간 알림음이 울리면 성공입니다.
3단계: /hooks를 입력해 등록된 훅을 확인하고, 필요 없으면 삭제해봅니다.