본문으로 건너뛰기

빌더 스택 · 강제

훅 (Hooks)

설득이 아니라 차단 — 반드시 실행되는 스크립트

도구 호출 전후나 세션 시작 같은 시점에 실행되는 셸 명령입니다. 모델의 판단과 무관하게 무조건 돌기 때문에, '가끔 안 지키는 규칙'을 확실하게 만들 수 있습니다.

언제 쓰나

  • 절대 어기면 안 되는 규칙이 있을 때 (생성 파일 수정 금지, 비밀값 커밋 금지)
  • 매번 해야 하는 일이 있을 때 (저장 시 포맷터, 종료 전 테스트)
  • 메모리에 적어도 자꾸 무시될 때 — 그때가 훅으로 옮길 신호입니다

주의할 점

  • 느린 명령을 넣으면 모든 작업이 느려집니다.
  • 훅 로그에 비밀값이 남지 않게 주의하세요.
  • `$CLAUDE_TOOL_INPUT_FILE_PATH` 같은 환경변수는 없습니다. 도구 정보는 stdin으로 옵니다 — 없는 변수를 쓰면 값이 빈 문자열이 되어 조건이 안 맞고, 훅은 아무것도 막지 않으면서 막고 있는 것처럼 보입니다.

설정

.claude/settings.jsonjson
{
  "hooks": {
    "PreToolUse": [{
      "matcher": "Edit|Write",
      "hooks": [{
        "type": "command",
        "command": "f=$(jq -r '.tool_input.file_path // empty'); case \"$f\" in */drizzle/*.sql) echo '마이그레이션은 직접 수정하지 않습니다' >&2; exit 2;; esac"
      }]
    }]
  }
}

훅은 도구 정보를 표준입력(stdin)으로 JSON 받습니다 — 환경변수가 아닙니다. 그래서 jq로 꺼내 씁니다. 종료 코드 2로 끝내면 해당 도구 호출이 차단되고, stderr에 쓴 메시지가 이유로 전달됩니다.

공유

관련해서 올라온 자료

최근 60일 동안 수집된 뉴스·저장소 중 이 주제와 겹치는 것들입니다.