AI 도서관 · Claude · 하네스 설정 · Hooks
AI 행동의 생명주기(세션 시작, 도구 실행 전/후, 응답 완료)에 끼워 넣는 자동 스크립트예요
📌 Hooks = AI 행동에 끼워 넣는 자동 개입 장치
[ 주요 Hook 시점 ]
• PreToolUse : 도구(Bash, 파일 수정 등) 실행 직전
• PostToolUse : 도구 실행 직후
• Notification : 알림이 발생할 때
• Stop : 응답이 완료될 때
[ 실전 활용 예시 ]
→ PreToolUse: rm -rf 감지 시 실행 차단
→ PostToolUse: 파일 수정 후 자동으로 prettier 실행
→ Stop: 작업 완료 시 테스트 자동 실행
📍 설정 위치: ~/.claude/settings.json (전역)
또는 .claude/settings.local.json (프로젝트)
[ 종료코드 — 여기서 대부분 틀립니다 ]
• exit 0 : 통과
• exit 1 : 그냥 오류로 처리되고 작업은 그대로 진행됩니다 (차단 아님)
• exit 2 : 차단. stderr 에 적은 내용이 사유로 전달됩니다
단, Stop 이벤트의 exit 2 는 '멈추지 말고 계속하라'는 뜻입니다
⚠️ 입력은 표준입력(stdin) JSON 으로 들어옵니다. 환경변수가 아닙니다.
Bash 명령은 .tool_input.command, 파일 경로는 .tool_input.file_path 입니다.
🚧 Hook 은 실수를 줄이는 보조 장치이지 보안 경계가 아닙니다.
설정한 뒤에는 반드시 직접 시험해서 실제로 막히는지 확인하세요.