훅(Hook)이란? AI 코딩 도구가 명령을 자동 실행하는 원리

AI에게 “웹사이트를 고쳐 줘”라고 부탁하면 코드를 수정해 줍니다. 그런데 파일을 고친 다음 매번 “코드 형식을 정리해 줘”, “테스트 결과도 확인해 줘”라고 다시 부탁하는 게 번거로울 때가 있죠. 이때 개발 도구에서 자주 등장하는 단어가 훅(Hook)입니다. 훅은 특정 사건이 일어났을 때 미리 정해 둔 작업을 자동으로 실행하도록 연결해 놓은 규칙입니다. 예를 들어 AI가 파일 수정을 마친 직후 간단한 검사를 실행하거나, 명령을 실행하기 전에 위험한 요청인지 확인하도록 만들 수 있습니다. 하지만 훅이 자동으로 실행된다는 사실은 편리함인 동시에 위험이기도 합니다. 잘못 만든 훅은 원하지 않는 명령을 반복 실행하거나, 사용자의 승인 흐름에 영향을 줄 수 있기 때문입니다. 이번 글에서는 훅의 뜻 → AI 코딩에서 언제 실행되는지 → 실제 설정 형식 → 안전한 첫 예제 → 오류 해결 → 보안 점검 순서로 살펴보겠습니다. 이 글은 2026년 10월 16일 Claude Code 공식 문서를 바탕으로 작성한 설명형 가이드입니다. 실제 컴퓨터에서 아래 설정을 실행해 검증한 체험기가 아니므로, 직접 적용할 때는 현재 버전·실행 환경에서 점검해야 합니다.

훅(Hook)이란 · 핵심 흐름훅(Hook)이란의 주요 개념과 확인 순서를 네 단계로 정리한 자체 제작 도식.훅(Hook)이란 · 핵심 흐름1훅 은 무슨 뜻인가요?영어 hook은 고리나 갈고리라는 뜻입니다.2AI에게 지시하는 것과 훅을 만드는 것은…AI 채팅에서는 보통 이렇게 말합니다.3Claude Code 훅은 언제 실행되나…Claude Code 공식 문서에는 여러 종 류의 훅 이벤트가…4훅은 어디에 설정하나요 ?Claude Code는 설정 파일의 hook s 항목에 훅을…설명용 요약 도식입니다. 제품의 현재 기능·조건은 본문과 공식 문서를 확인하세요.EMFLS AI · 자체 도식
자체 제작 개념도 · EMFLS AI

이 글의 순서

1. 훅(Hook)은 무슨 뜻인가요?

영어 hook은 고리나 갈고리라는 뜻입니다. 프로그램에서는 어떤 일이 벌어지는 시점에 다른 동작을 연결하는 지점을 의미할 때 사용합니다. 예를 들어 스마트폰에서 사진을 찍으면 자동으로 앨범에 저장되는 흐름을 떠올려 보세요. 사진을 찍는 사건이 발생했을 때, 미리 정해 둔 저장 작업이 실행되는 모습과 비슷합니다. AI 코딩 도구에서도 같은 생각을 적용할 수 있습니다.

AI가 파일을 수정했다 → 훅이 실행된다 → 수정 후 검사 명령을 호출한다. 그렇다고 훅이 모든 코딩 도구에 동일한 이름과 설정으로 존재하는 것은 아닙니다. 어떤 도구가 어떤 사건을 지원하고, 어떤 명령을 허용하는지는 제품마다 다릅니다. 이 글에서는 초보자가 구체적으로 이해할 수 있도록 Claude Code의 훅 기능을 대표적인 사례로 사용합니다.

2. AI에게 지시하는 것과 훅을 만드는 것은 무엇이 다른가요?

AI 채팅에서는 보통 이렇게 말합니다. 파일을 수정한 다음 코드 형식도 확인해 줘. 이것은 AI에게 어떤 작업을 하라고 지시하는 문장입니다. 도구가 실제로 언제 명령을 실행할지는 AI의 판단과 승인 절차, 사용할 수 있는 기능에 달려 있습니다. 반면 훅은 특정 사건이 일어났을 때 실행할 동작을 미리 등록합니다. 예를 들어 Claude Code에서 PostToolUse 훅을 특정 편집 도구에 연결하면, 해당 도구의 작업이 성공한 뒤 등록한 훅을 실행할 수 있습니다. 둘의 차이를 간단히 비교해 보겠습니다.

구분 AI에게 작업 지시 훅 설정
시작 조건 사용자가 입력한 요청 도구에서 발생한 특정 이벤트
예시 “수정한 뒤 검사해 줘” 파일 편집 뒤 검사 명령 실행
목적 이번 작업의 방향 제시 반복적 절차의 자동화
확인할 것 AI가 실제로 무엇을 수행했는가 훅이 언제, 어떤 명령으로 실행됐는가
주요 위험 지시 누락·오해 예상치 못한 자동 실행·권한 확대

중요: 훅은 AI에게 새로운 지식을 주는 문서나 설명 글이 아닙니다. 특정 사건에 연결된 실행 또는 판단 절차입니다.

3. Claude Code 훅은 언제 실행되나요?

Claude Code 공식 문서에는 여러 종류의 훅 이벤트가 안내되어 있습니다. 초보자가 자주 만날 만한 것만 먼저 살펴보겠습니다.

PreToolUse: 도구를 실행하기 전

PreToolUse는 Claude Code가 특정 도구를 호출하려고 할 때 실제 실행 전에 호출될 수 있는 이벤트입니다. 예를 들어 특정 파일을 수정하지 못하게 하거나, 어떤 명령을 실행하려는지 점검하는 규칙에 사용할 수 있습니다. 하지만 훅이 있다고 해서 운영체제 수준에서 모든 파일 접근을 봉쇄하는 완전한 보안 장벽이 생긴 것은 아닙니다.

PostToolUse: 도구 작업이 성공한 뒤

PostToolUse는 해당 도구 호출이 성공적으로 마무리된 다음 실행되는 이벤트입니다. 예를 들어 파일 편집 작업이 성공한 뒤 코드 포맷 검사나 간단한 상태 기록을 할 때 사용할 수 있습니다. 도구가 실패한 경우를 다루는 별도 이벤트도 있으므로 실패한 작업까지 자동으로 PostToolUse가 실행된다고 가정하지 마세요.

SessionStart: 작업을 시작하거나 다시 이어갈 때

SessionStart는 세션을 시작하거나 재개하는 등의 시점에 동작하는 훅입니다. 프로젝트의 규칙을 다시 보여 주거나, 새로운 세션에서 필요한 맥락을 전달하는 용도로 활용할 수 있습니다.

PermissionRequest: 승인을 요청하려 할 때

PermissionRequest는 명령 실행 등의 권한을 요청하는 순간에 관련 동작을 연결할 수 있는 이벤트입니다. 특정 요청을 승인하거나 거절하는 처리에 영향을 줄 수도 있으므로 잘못 설정하면 사용자가 직접 확인해야 할 위험한 동작까지 자동 허용될 수 있습니다. 이번 초보자 실습에서는 승인 자동화를 사용하지 않습니다.

Stop: AI 응답을 마무리하려 할 때

Stop은 Claude Code가 답변을 끝내려고 하는 시점에 호출될 수 있는 이벤트입니다. 다만 모든 도구·모델·에이전트에서 동일한 사건 목록을 제공한다고 생각하면 안 됩니다. 현재 사용 중인 제품의 공식 훅 목록을 확인해야 합니다.

4. 훅은 어디에 설정하나요?

Claude Code는 설정 파일의 hooks 항목에 훅을 등록할 수 있습니다. 공식 문서가 안내하는 대표적인 위치는 다음과 같습니다.

  • 사용자 설정: ~/.claude/settings.json
  • 프로젝트 설정: 작업 프로젝트의 .claude/settings.json 두 위치의 의미가 다릅니다. 사용자 설정은 일반적으로 해당 사용자의 Claude Code 작업에 적용할 규칙을 저장하는 곳이고, 프로젝트 설정은 특정 저장소와 함께 관리할 규칙을 담는 곳입니다. 초보자가 알아둘 점은 다른 사람의 프로젝트를 열면 그 프로젝트의 설정에도 훅이 포함되어 있을 수 있다는 것입니다. 따라서 낯선 GitHub 저장소를 가져왔을 때는 .claude/settings.json 같은 설정을 살펴보는 습관이 필요합니다. 특히 파일 삭제, 외부 서버 전송, 설치 스크립트 다운로드, 비밀키 접근을 수행하는 명령이 있다면 출처와 필요성을 확인하기 전에는 함부로 활성화하지 마세요. 또한 이미 설정 파일에 hooks 객체가 있다면, 새 설정을 추가하려고 파일 전체를 덮어쓰지 않는 것이 중요합니다.

5. 처음에는 실행 결과만 확인하는 훅부터 만들어 보세요

처음 배우는 사람에게는 실제 소스 코드를 자동 수정하거나 파일을 삭제하는 훅보다, 작업이 끝났음을 알리는 텍스트만 출력하는 예제가 적합합니다. 아래는 Claude Code의 현재 문서 형식을 바탕으로 작성한 간단한 교육용 JSON입니다.

{
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "Edit|Write",
        "hooks": [
          {
            "type": "command",
            "command": "printf 'Hook: edit tool finished\\n'"
          }
        ]
      }
    ]
  }
}

설정의 핵심은 세 부분입니다. ① PostToolUse 작업이 성공한 후라는 시점을 가리킵니다. ② matcher: "Edit|Write" Claude Code가 제공하는 편집 도구 중 Edit 또는 Write에 해당하는 호출을 대상으로 삼는 조건입니다. ③ command 해당 이벤트가 발생했을 때 실행할 명령입니다. 여기서는 단순히 정해 둔 문구를 출력할 뿐, 파일을 변경하거나 외부로 데이터를 보내지는 않습니다. 실행 환경 주의: printf 명령은 일반적인 Unix 계열 셸에서 사용할 수 있습니다. Windows에서 실행 중인 셸이나 설치 환경에 따라 명령을 조정해야 할 수 있습니다. 또한 훅 명령이 문자를 출력하더라도 그 결과가 반드시 데스크톱 알림 팝업으로 표시된다고 생각하면 안 됩니다. 제품이 출력 결과를 처리하는 방식과 디버그 로그를 확인해야 합니다. 이 예제는 구조를 이해하기 위한 것으로, 작성자가 실제 Claude Code에서 실행 성공을 확인한 결과가 아닙니다.

6. 훅 설정을 확인하는 방법

설정을 저장했다면 다음 단계에서 등록됐다는 사실과 실제 실행됐다는 사실을 구분해야 합니다. Claude Code 공식 문서는 /hooks 명령으로 훅 목록을 확인할 수 있다고 설명합니다. 확인 순서는 다음과 같습니다.

  1. 설정 파일의 JSON 문법을 확인합니다.
  2. Claude Code의 훅 목록에서 설정한 이벤트 이름을 찾습니다.
  3. 선택한 훅의 도구 조건(matcher)과 명령(command)이 의도대로 등록됐는지 봅니다.
  4. 연습용 프로젝트에서 승인된 Edit·Write 작업을 실제로 수행합니다.
  5. 훅의 디버그 정보나 출력에서 실행 여부를 확인합니다.
  6. 마지막으로 기대한 파일 변경과 추가 동작이 일치하는지 검토합니다. 공식 안내에 따르면 /hooks 메뉴는 현재 훅을 살펴보는 읽기 전용 화면입니다. 이 메뉴에서 모든 훅 설정을 직접 편집하거나 삭제하는 것은 아닙니다. 설정 변경은 해당 파일을 수정해야 합니다. 한 가지 실수도 조심하세요. 파일을 읽기만 한 경우에는 Edit/Write 도구를 실제로 실행한 것이 아닐 수 있습니다. 그러면 위의 PostToolUse 예제가 실행되지 않는 것이 자연스럽습니다.

7. 훅으로 자동화할 수 있는 작업에는 무엇이 있나요?

Claude Code 공식 안내에는 다양한 자동화 예제가 있습니다. 예를 들어 다음과 같은 작업입니다. 파일을 수정한 뒤 코드 형식 정리 AI가 특정 파일을 바꾸고 나면 별도 포맷터를 실행해 들여쓰기와 스타일을 정리할 수 있습니다. 단, 포맷터의 설치 여부와 적용 범위를 확인해야 합니다. 수정해서는 안 되는 파일 보호 AI가 특정 중요한 파일을 수정하려 할 때 경고하거나 차단하도록 설정할 수 있습니다. 단순 파일 이름 문자열 확인으로 모든 우회 경로까지 차단할 수 있는 것은 아닙니다. 사람의 입력이 필요할 때 알림 Claude Code가 사용자 승인이나 입력을 기다리는 순간 알림을 전달하도록 설정할 수 있습니다. 새 세션을 열 때 작업 규칙 전달 프로젝트의 최근 결정이나 테스트 기준을 새 작업 시작 시점에 참고하도록 할 수 있습니다. 하지만 모든 자동화가 안전하거나 바람직한 것은 아닙니다. 예를 들어 “파일이 바뀌는 즉시 GitHub에 자동으로 강제 푸시하기”, “권한 요청을 모두 자동 승인하기” 같은 동작은 실수의 영향을 키울 수 있습니다. 처음에는 결과를 기록하거나 검사만 하는 작은 훅부터 익히는 편이 좋습니다.

8. 훅과 권한 설정은 어떻게 다른가요?

초보자가 가장 많이 헷갈리는 부분 중 하나입니다. 훅은 언제 무엇을 자동 실행할지 연결하는 규칙입니다. 권한 설정은 파일을 읽거나 수정하고 명령을 실행할 때 어느 범위까지 허용할지 결정하는 정책입니다. 둘이 만나는 지점도 있습니다. 예를 들어 PreToolUse 훅이 특정 도구 호출을 막을 수 있고, PermissionRequest 훅은 승인 절차에 관여할 수 있습니다. 그러나 다음 사실을 구분해야 합니다.

  • 훅이 있다고 모든 파일 접근이 자동 차단되는 것은 아닙니다.
  • 훅이 한 도구 호출을 거부했다고 모든 다른 도구·플러그인 경로까지 완전히 통제하는 것은 아닙니다.
  • 훅으로 승인 과정을 자동화할 수 있어도, 그것이 사용자에게 안전한 선택이라는 뜻은 아닙니다.
  • 코드 검사 훅이 통과했다는 사실은 사람의 최종 코드 리뷰·배포 승인을 대신하지 않습니다. Claude Code 공식 자료는 하나의 이벤트에 여러 훅이 연결돼 있으면 동작을 병렬로 실행할 수 있다고 설명합니다. 즉 한 훅이 어떤 동작을 거부하더라도 옆에 등록된 다른 훅의 부작용까지 반드시 막는 것은 아닙니다. 따라서 훅을 프로젝트의 유일한 보안장치라고 생각해서는 안 됩니다.

9. 다른 사람이 만든 훅을 설치할 때 주의하세요

훅은 반복적인 일을 자동화하므로 생산성을 높이는 데 도움을 줄 수 있습니다. 그러나 정확히 그 이유 때문에 잘못된 설정을 가져오면 위험할 수 있습니다. 예를 들어 다음과 같은 설정이 있다고 가정해 보세요.

파일을 열 때마다 외부 주소로 내용을 보내도록 만든 자동 명령. 사용자가 평소처럼 AI에게 파일을 읽어 달라고 요청했을 뿐인데, 훅이 설정되어 있다면 사용자가 예상하지 않은 외부 전송이 발생할 위험이 있습니다. 특히 플러그인을 설치할 때 다음 사항을 확인해야 합니다. 어느 사건에 연결돼 있나요? 모든 도구 호출인지, 특정 편집 도구만인지 확인합니다. 무슨 명령을 실행하나요? 다운로드, 외부 서버 연결, 파일 삭제, Git 작업, 환경변수 읽기 같은 명령이 있는지 살펴봅니다. 어떤 파일에 접근하나요? 프로젝트 폴더만 필요하다면서 홈 디렉터리나 비밀키 파일을 읽으려 하지는 않는지 확인합니다. 언제 중지할 수 있나요? 기존 훅을 제거할 위치와 실행 기록을 확인할 수 있는지 알아둡니다. 누가 만든 도구인가요? 공식 공급사의 기능인지, 독립 개발자가 만든 플러그인인지 구분합니다. 프로젝트에 직접 설정한 훅과 외부 플러그인이 등록한 훅이 함께 존재할 수 있습니다. 설정 하나만 보고 전체 자동화가 확인됐다고 생각하지 마세요.

10. Context Mode에서 말하는 훅도 같은 뜻인가요?

AI 코딩 관련 글을 읽다 보면 Context Mode라는 플러그인에서 훅이라는 단어를 볼 수 있습니다. Context Mode 제작자의 문서에서는 Claude Code 같은 도구에서 SessionStart, PreToolUse, PostToolUse, PreCompact 등의 이벤트를 이용해 작업 맥락과 도구 출력을 다루는 구성을 안내합니다. 예를 들어 긴 도구 출력이 대화 화면에 그대로 쏟아지지 않도록 다른 처리 경로로 보내거나, 세션이 이어질 때 필요한 정보를 다시 제공하는 흐름입니다. 이때 훅은 그 기능이 작동할 시점을 연결하는 장치로 이해할 수 있습니다. 하지만 주의해야 합니다. Context Mode 플러그인 자체의 기능과 Claude Code 훅의 일반적인 기능은 다른 것입니다. 모든 훅이 자동으로 토큰 비용을 줄이거나 장기 기억을 제공하는 것은 아닙니다. 또한 플러그인의 성능 통계는 실제 사용 환경·버전·작업 종류에 따라 달라질 수 있습니다. 단순히 설치했다고 특정 비율만큼 항상 토큰이 줄어든다고 보장할 수 없습니다. 다른 AI 코딩 도구에서도 비슷한 자동 이벤트 기능을 제공할 수 있지만, 이벤트 이름과 JSON 형식, 실행 권한이 동일하다고 가정하지 마세요.

11. 훅이 실행되지 않는다면 확인할 것

설정 파일에 훅을 적었는데 아무 동작도 일어나지 않는다면 다음 순서로 점검해 보세요.

현상 우선 확인할 것
/hooks에 안 보임 올바른 settings.json 위치·JSON 형식
등록됐는데 실행 안 됨 이벤트 이름과 matcher 조건
실행 명령을 못 찾음 설치된 실행파일·셸·PATH
파일 편집 뒤 동작하지 않음 정말 Edit/Write 도구가 성공했는지
실패 메시지만 보임 훅 명령의 실제 종료 상태·에러 출력
원치 않은 순간 반복 실행 이벤트 범위가 너무 넓지 않은지
여러 번 실행됨 중복 등록된 사용자·프로젝트·플러그인 훅

실제 원인을 찾을 때는 정확한 이벤트 이름, 어떤 도구가 실행됐는지, 실행한 명령, 에러 로그를 구분해 살펴보는 것이 좋습니다. 예를 들어 PreToolUse 이벤트로 등록해 놓고 실행 후 기록이 나오기를 기대한다면 시점부터 잘못 이해한 것일 수 있습니다. 반대로 PostToolUse가 등록돼 있지만 편집 도구가 실패했다면 해당 성공 후 이벤트가 발생하지 않았을 수 있습니다. 설정 형식은 제품 업데이트로 달라질 수 있으므로 사용 중인 Claude Code 버전과 공식 Hooks Reference를 확인해야 합니다.

12. 훅의 실행 결과를 신뢰해도 될까요?

훅이 실제로 실행됐다는 사실과 원하는 검사가 통과했다는 사실은 구분해야 합니다. 예를 들어 테스트 명령을 실행하도록 훅을 설정했다고 생각해 보세요. 확인해야 할 단계는 적어도 세 가지입니다. 첫째, 훅이 실행됐는가? 연결한 이벤트와 조건에 따라 명령이 호출됐는지 확인합니다. 둘째, 검사 자체가 실행됐는가? 테스트 프로그램이 실제로 시작됐는지, 중간에 실패하거나 건너뛴 항목이 없는지 확인합니다. 셋째, 검사 결과가 무엇인가? PASS, FAIL, NOT RUN을 구분합니다. 훅 실행 성공 = 모든 테스트 통과 = 최종 배포 승인으로 이어진다고 생각하면 안 됩니다. 특히 개인정보·결제·사용자 계정 같은 기능을 변경하는 경우에는 AI 코딩 도구가 자동 실행한 테스트 외에 별도의 검증과 사람의 승인이 필요할 수 있습니다.

13. 훅과 함께 쓰기 좋은 초보자용 체크리스트

프로젝트에 훅을 추가하려면 다음 순서로 생각해 보세요.

  1. 자동화할 일을 한 가지로 좁히기: 파일 편집 뒤 상태 기록처럼 범위가 작은 작업으로 시작합니다.
  2. 정확한 시점 선택: 실행 전 검사인지, 성공 후 검사인지, 세션 시작 시 알림인지 정합니다.
  3. 실행할 명령 확인: 코드 수정·외부 연결·파일 삭제가 없는지 먼저 검토합니다.
  4. 적용 범위 제한: 가능한 한 필요한 도구만 matcher로 선택합니다.
  5. 등록 여부와 실제 실행을 분리해 확인: /hooks 목록 확인 뒤 안전한 예제로 실행 여부를 확인합니다.
  6. 권한·보안은 별도로 관리: 승인 정책과 보안상 중요한 파일 보호는 훅 외의 수단도 검토합니다.
  7. 실패 시 되돌릴 방법 확보: 변경 전 설정 사본을 안전하게 보관하고 문제가 생기면 이전 구성으로 복구할 수 있게 합니다. 자동화가 잘된다는 것은 많은 명령이 자동으로 실행된다는 뜻이 아니라, 원하는 동작만 예측 가능하게 일어난다는 뜻입니다.

14. 자주 묻는 질문(FAQ)

Q1. 훅을 사용하려면 코딩을 반드시 잘해야 하나요?

처음에는 전문적인 코딩 지식이 없어도 개념을 이해할 수 있습니다. 하지만 실행할 명령이 실제로 무슨 일을 하는지는 확인할 수 있어야 안전하게 설정할 수 있습니다.

Q2. 훅을 설치하면 모든 AI 도구에서 같은 방식으로 작동하나요?

아닙니다. Claude Code, 다른 AI 코딩 도구, 플러그인마다 지원 이벤트·설정 형식·권한 처리 방식이 다를 수 있습니다.

Q3. PreToolUse와 PostToolUse는 무엇이 다른가요?

PreToolUse는 도구 호출 전, PostToolUse는 도구 호출이 성공한 뒤 동작하는 이벤트입니다. 둘의 실행 시점이 다릅니다.

Q4. 훅을 만들면 AI가 마음대로 파일을 고치지 못하게 할 수 있나요?

특정 도구 호출을 검사하거나 차단하는 데 도움이 될 수 있지만 모든 파일 접근을 완전히 차단하는 보안 체계가 되는 것은 아닙니다. 실제 실행 권한과 파일·네트워크 보호는 별도로 관리해야 합니다.

Q5. 훅이 있으면 매번 사용자 승인을 누를 필요가 없나요?

그렇지 않습니다. 승인 절차에 관여할 수 있는 훅이 있지만, 무차별 자동 승인은 위험합니다. 사용자 확인을 건너뛰도록 설정하는 것은 최소 범위와 조직 정책을 충분히 검토한 경우에도 매우 신중해야 합니다.

Q6. 훅을 설정했는데 왜 실행되지 않나요?

이벤트 이름·matcher·설정 파일 위치·셸 명령·실제로 발생한 도구 이벤트를 확인하세요. 등록됐다는 사실과 실제로 조건이 맞아 실행됐다는 사실을 구분해야 합니다.

Q7. 훅을 사용하면 AI 토큰을 무조건 절약할 수 있나요?

아닙니다. 훅 자체는 자동화 시점을 연결하는 장치입니다. 일부 플러그인이 훅을 이용해 도구 출력을 정리할 수는 있지만 토큰 사용량 감소나 요금 절감은 제품·작업 종류·구성에 따라 달라지며 자동 보장되지 않습니다.

Q8. 훅이 실행됐다는 로그가 있으면 테스트도 통과한 건가요?

아닙니다. 훅이 명령을 호출한 사실과 테스트 프로그램이 실제 실행되어 PASS를 받은 사실은 다릅니다. 실행 로그·종료 상태·테스트 결과를 따로 확인하세요.

Q9. 다른 사람의 GitHub 프로젝트를 내려받을 때 훅을 확인해야 하나요?

네. 신뢰하지 않는 저장소나 플러그인에 자동 실행 설정이 포함될 수 있습니다. 다운로드·외부 전송·파일 삭제·비밀정보 접근과 관련된 명령이 없는지 확인하세요.

마무리: 훅은 반복 작업을 연결하는 자동화의 고리입니다

AI 코딩에서 훅(Hook)은 어떤 사건이 일어났을 때 정해진 작업이 자동으로 실행되도록 연결하는 규칙입니다. 핵심은 세 가지입니다. 언제 실행되는가: 도구 실행 전인지, 성공 후인지, 세션 시작 시점인지 확인합니다. 무엇을 실행하는가: 단순 기록인지, 코드 변경인지, 외부로 데이터를 보내는 명령인지 확인합니다. 어떻게 검증하는가: 설정이 등록됐는지뿐 아니라 실제 이벤트에서 의도한 작업이 실행됐는지 확인합니다. 훅을 처음 사용한다면 자동 배포·무제한 권한 승인 같은 복잡한 기능보다 실행 여부만 확인하는 작은 실습부터 시작하세요. 그렇게 해야 자동화의 편리함을 누리면서도 예상하지 못한 변경을 줄일 수 있습니다.

함께 읽으면 좋은 글