7.3Claude 훅

프롬프트로 부탁한 것은 대체로 지켜지지만 항상은 아닙니다. 반드시 지켜져야 하는 것은 코드로 강제해야 합니다.

훅은 정해진 시점에 실행되는 코드입니다. 조건이 맞으면 언제나 실행되고, 모델의 판단이 개입하지 않습니다.

프롬프트: "운영 DB에는 접근하지 마세요"      → 대체로 지켜짐, 보장 없음
훅:      실행 직전에 대상을 검사해 거부      → 조건이 맞으면 항상 차단

이 차이가 훅의 존재 이유 전부입니다. 시험에서는 둘을 같은 수준의 통제로 놓는 선택지가 오답으로 나옵니다.

Claude Code에서는 여러 시점에 훅을 걸 수 있습니다. 대표적인 것들입니다.

• 도구 실행 전(PreToolUse) — 검사하고 차단할 수 있습니다. 막아야 하는 일은 반드시 여기입니다.
• 도구 실행 후(PostToolUse) — 결과를 보고 기록하거나 후처리합니다. 이미 실행된 뒤라 막을 수 없습니다.
• 세션 시작(SessionStart) — 초기 상태를 준비합니다.
• 종료(Stop) — 정리 작업을 합니다.

차단은 실행 전 시점에서만 가능하다는 것이 핵심입니다. 파괴적 명령을 실행 후 시점에서 잡으려는 구성은 이미 벌어진 일을 기록할 뿐입니다.

def pre_tool_use(tool_name, tool_input):
    if tool_name == "run_shell":
        cmd = tool_input.get("command", "")
        if any(p in cmd for p in DANGEROUS_PATTERNS):
            return {"deny": True, "reason": "파괴적 명령으로 판단되어 차단했습니다"}
    return {"deny": False}

차단할 때 이유를 함께 돌려주는 것이 중요합니다. 그래야 모델이 다른 방법을 찾습니다. 이유 없이 막으면 같은 시도를 반복합니다.

훅은 조건과 동작을 코드로 적을 수 있는 일에만 씁니다. 그렇지 않은 요구는 대상이 아닙니다.

• "답변을 더 정확하게 만들어라" → 조건을 코드로 적을 수 없습니다.
• "맥락에 맞게 판단하라" → 판단 자체가 모델의 몫입니다.
• "위험해 보이면 막아라" → "위험해 보임"을 코드로 정의해야 훅이 됩니다.

세 번째가 실무에서 자주 부딪히는 지점입니다. 막고 싶은 것을 구체적인 패턴이나 대상 목록으로 정의할 수 있어야 훅이 됩니다. 정의할 수 없다면 다른 수단 — 권한 축소나 사람 승인 — 을 써야 합니다.

또 하나, 훅은 자기가 아는 시점에서만 동작합니다. 훅이 걸리지 않는 경로로 같은 일이 벌어질 수 있다면 그 경로도 함께 막아야 합니다. 도구 실행을 막아 두고 다른 통로로 셸을 쓸 수 있다면 방어가 완성되지 않습니다.

차단만이 훅의 용도는 아닙니다. 무슨 일이 있었는지 남기는 것도 중요한 쓰임입니다.

def post_tool_use(tool_name, tool_input, result):
    audit.write({
        "ts": now(),
        "tool": tool_name,
        "args_hash": sha1(json.dumps(tool_input, sort_keys=True))[:12],
        "ok": not result.get("is_error"),
    })

기록에서 챙길 점이 있습니다. 인자 원문을 그대로 남기면 그 로그가 유출 경로가 될 수 있습니다. 해시나 요약으로 남기고, 필요할 때만 상세 기록을 켜는 편이 안전합니다.

차단된 시도도 기록해야 합니다. 무엇이 얼마나 자주 막히는지 보면, 권한 설정이 과한지 부족한지 판단할 수 있습니다. 매일 같은 것이 막히고 있다면 그 작업을 안전하게 할 방법을 따로 만들어 줘야 한다는 신호입니다.