Claude Code에서 재앙을 막는 3가지 후크(Hooks) 사용법 (코드 포함)

Claude Code는 명령어 실행에 매우 능숙합니다. 이것이 바로 잘못된 명령어를 실행했을 때 문제가 되는 지점입니다. **후크(hooks)**를 사용하면 모델이 규칙을 '기억'하는 것에 의존하지 않고, 모든 액션 전에 작동하는 안전장치를 설정할 수 있습니다.

작동 방식 (30초 만에)

• .claude/settings.json 파일에 이벤트별(PreToolUse, PostToolUse, Notification 등) 및 도구별(Bash, Write|Edit 등)로 설정합니다.
• 후크는 stdin을 통해 JSON 형태로 이벤트를 받습니다.
• 코드 2가 반환되면 액션이 차단되며, stderr의 텍스트가 그 이유와 함께 Claude에게 되돌려집니다.

1. 파괴적인 명령어 차단하기

.claude/hooks/bloquear-comandos-peligrosos.sh:

#!/usr/bin/env bash
entrada="$(cat)"
patrones=(
...

--force([^-]|$)의 세부 사항에 주목하세요: --force는 차단하지만, 안전한 방식인 --force-with-lease는 통과시킵니다.
.claude/settings.json:

{
  "hooks": {
    "PreToolUse": [
...

chmod +x를 잊지 말고 테스트해 보세요:

echo '{"tool_input":{"command":"git reset --hard"}}' | .claude/hooks/bloquear-comandos-peligrosos.sh; echo $?
# → 2

2. 비밀 정보 작성 전 감지하기

동일한 패턴을 사용하지만, `matcher:

El Kit Claude Code en español (US$9)에는 세 가지 후크와 하나의 알림 기능, 6가지 스킬(스페인어 버전: /commit, /pr, /revisar, /tests, /plan, /depurar)이 포함되어 있으며, React, Node 및 GraphQL용 CLAUDE.md 템플릿과 권한 프리셋도 제공됩니다: https://luijhy.gumroad.com/l/kit-claude-code-es

여러분은 또 어떤 명령어를 차단하시겠습니까? 댓글에서 읽어보겠습니다.