AI 도서관 · Claude · 하네스 설정 · Hooks

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 은 실수를 줄이는 보조 장치이지 보안 경계가 아닙니다.
   설정한 뒤에는 반드시 직접 시험해서 실제로 막히는지 확인하세요.

근거

유형
설정 가이드 — 지정된 파일이나 설정에 적용합니다
사용 환경
Claude Code (터미널) 전용
주의
exit 1 은 차단이 아닙니다. 차단은 exit 2 입니다.
공식 출처
https://code.claude.com/docs/en/hooks
확인일
2026-09-08 — 이후 바뀌었을 수 있습니다
도서관에서 열기 — 내 내용 넣고 복사하기