본문으로 건너뛰기

"hooks" 태그로 연결된 1개 게시물개의 게시물이 있습니다.

모든 태그 보기

[Claude Code Plugin 만들기 #3] 훅으로 자동화 — 규칙은 한 번 정하면 자동으로

· 약 9분
Nam Young Kim
Data Fullstack Engineer

이 글은 Claude Code Plugin 만들기 시리즈의 세 번째 편입니다. Hooks의 구조, 이벤트 종류, exit code의 정확한 의미, 그리고 실전 디버깅 사례를 다룹니다.


TL;DR

  • Hooks는 hooks.json에 정의하는 자동 실행 규칙
  • 14가지 이벤트 중 PreToolUse, PostToolUse, SessionStart가 핵심
  • exit 0 = 성공, exit 2 = 의도적 차단, 그 외 = 에러
  • exit 1은 "차단"이 아니라 "에러" — 이 차이를 모르면 버그를 만든다
  • hook 타입: command(셸 명령), prompt(LLM 평가), agent(다중 턴 검증) 3가지