훅은 프롬프트보다 단단한 정책 경계야

도구 사건에 코드가 끼어들어

훅은 PreToolUse, PostToolUse, UserPromptSubmit, Stop 같은 사건에 호출되는 콜백이야. 도구 실행 전후에 기록을 남기고, 인자에서 비밀을 가리고, 위험한 호출을 거부할 수 있어. 모델의 협조와 무관하게 코드가 정책을 집행하는 자리야.

안내는 프롬프트로, 불변 조건은 훅으로

시스템 프롬프트에 “rm -rf를 실행하지 마”라고 쓰면 모델이 대체로 따르지만 보장은 아니야. 해당 명령 패턴을 본 훅이 거부하면 실행 경로 자체가 닫혀. 바람직한 행동은 프롬프트로 설명하고 절대 넘으면 안 되는 경계는 코드로 막아.

기록·가림·거부 세 종류부터 시작해

모든 도구 호출을 구조화 로그에 남기는 기록 훅, 실행 전에 인자의 비밀을 지우는 가림 훅, 금지 패턴을 차단하는 거부 훅이 기본 세트야. cwkPippa도 서로 다른 관심사를 이 세 층으로 나눠 다뤄.

원칙: 훅은 프롬프트가 바뀌어도 정책을 지켜. 모델 행동은 흔들릴 수 있지만 코드 경계는 흔들리지 않아.

Code

위험 명령 veto하는 PreToolUse hook·python

from claude_agent_sdk import ClaudeAgentOptions, HookContext, HookOutput

async def block_destructive_bash(context: HookContext) -> HookOutput:
    if context.tool_name != "Bash":
        return HookOutput(allow=True)
    cmd = context.tool_input.get("command", "")
    if "rm -rf" in cmd or "dd if=" in cmd:
        return HookOutput(allow=False, reason="refused: matches destructive command pattern")
    return HookOutput(allow=True)

options = ClaudeAgentOptions(
    cwd="/srv",
    hooks={"PreToolUse": [block_destructive_bash]},
)

Telemetry용 PostToolUse hook·python

import time, json

async def log_tool_use(context):
    line = {
        "ts": time.time(),
        "tool": context.tool_name,
        "input_hash": hash(json.dumps(context.tool_input, sort_keys=True)),
        "duration_ms": context.duration_ms,
        "is_error": context.is_error,
    }
    with open("/var/log/agent.jsonl", "a") as f:
        f.write(json.dumps(line) + "\n")

options = ClaudeAgentOptions(
    cwd="/srv",
    hooks={"PostToolUse": [log_tool_use]},
)

Exercise

모든 Bash 명령을 기록하는 읽기 전용 PreToolUse 훅을 넣고 로그를 확인해. 반드시 막고 싶은 명령 패턴 하나에는 거부 규칙을 추가해 시험해.

Hint

모델이 실제로 그 패턴을 요청하게 만들어 훅이 거부하고 모델이 다른 길을 고르는지 봐.

도구 사건에 코드가 끼어들어

안내는 프롬프트로, 불변 조건은 훅으로

기록·가림·거부 세 종류부터 시작해

Code

External links

Exercise

Progress

댓글 0