CLAUDE.md 규칙보다 Claude Code 훅이 더 확실한 이유
에 적은 규칙은 Claude가 참고하는 안내문에 가깝다. “배포 스크립트를 실행하지 말라”, “ 폴더를 건드리지 말라”, “커밋 전 포매터를 실행하라” 같은 규칙도 대부분은 지켜지지만 항상 보장되지는 않는다. 대화가 길어지고 컨텍스트가 꽉 차거나 가 여러 단계로 들어가면, 그런 문장은 다른 지시와 함께 묻혀서 놓칠 수 있다.
Claude Code의 훅은 다르게 작동한다. 훅은 에 등록하는 쉘 명령이며, 정해진 순간마다 모델 바깥에서 코드로 실행된다. 특히 은 도구가 실제로 실행되기 전에 작동하고, 실행 직전의 Bash 명령 같은 전체 호출 내용을 JSON으로 받아 검사할 수 있다.
위험한 명령이면 훅이 차단 신호를 보내 실행을 막고, Claude는 차단됐다는 사실을 받은 뒤 다른 방식으로 작업을 이어간다.
핵심 포인트
- 의 규칙은 모델이 참고하는 안내라서 항상 지켜진다고 볼 수 없다.
- 긴 세션이나 컨텍스트가 많은 상황에서는 규칙이 다른 지시에 묻힐 수 있다.
- Claude Code의 훅은 모델 판단과 별개로 정해진 시점에 실행된다.
- 은 전에 Bash 명령을 검사해 위험한 실행을 막을 수 있다.
- 배포, , 커밋 전 포매터처럼 실수 비용이 큰 작업에 특히 유용하다.