사용기 A-24

클로드 코드 훅으로 명령 막기, 6주 동안 674번 막았는데 횟수는 줄지 않았어요

읽는 데 약 9분

아이티플레인

사용 기록

써 본 날2026-09-23 ~ 2026-11-04

써 본 것클로드 코드 훅(도구를 쓰기 직전·답을 끝내기 직전에 내 프로그램을 돌리는 설정), 맥미니와 윈도우 PC

비용추가 비용 없음 (쓰던 클로드 코드 요금제 안)

설치따로 깔 건 없음 (설정 파일 몇 줄과 짧은 스크립트 준비)

회사 자료쓰지 않음 (맥미니 세션 기록에서 막힌 횟수만 셈)

난이도터미널 조금

결과cd 명령 훅 674번, 디스코드 답장 훅 71번 막음. 주마다 막힌 횟수는 8 → 34 → 55 → 167 → 118 → 154 → 138번

한 줄 결론훅은 막을 때마다 확실히 막았지만, 클로드가 그걸 배워서 덜 하지는 않았어요. 규칙을 지키게 만드는 장치라기보다 매번 걸러 내는 그물에 가까웠어요.

11월 3일에 디스코드로 일을 시키던 클로드 코드 세션 두 개가 각각 56분, 50분 동안 멈춰 있었어요. 둘 다 코덱스를 부르는 codex exec 명령을 입력을 열어 둔 채 불러서 생긴 일이에요. 막는 법은 코덱스 쓰는 법을 적은 스킬 문서에 이미 있었는데, 그 스킬을 안 부른 세션이 같은 데서 걸렸어요.

그래서 스킬을 부르지 않은 세션에서도 막히도록 훅을 하나 더 걸었어요. 그러고 나서 먼저 걸어 둔 훅들은 그동안 몇 번이나 막았는지 세션 기록을 세어 봤어요.

클로드 코드 훅이 뭔가요?

훅(hook)은 클로드 코드가 어떤 일을 하기 직전이나 직후에 내 프로그램을 끼워 돌리는 설정이에요. 명령을 실행하기 직전(PreToolUse), 답을 끝내기 직전(Stop), 세션을 시작할 때(SessionStart) 같은 순간을 고를 수 있어요.

설정은 ~/.claude/settings.json에 적어요. 프로그램이 종료 코드 2로 끝나면 클로드 코드는 그 일을 멈추고, 프로그램이 오류 출력(stderr)에 쓴 문장을 클로드에게 넘겨요. 클로드는 그 문장을 읽고 다음 행동을 정해요. 종료 코드 0이고 따로 막으라는 출력이 없으면 그냥 지나가요.

규칙 파일(CLAUDE.md)에 적은 금지는 클로드가 읽고 따르기를 기대하는 거예요. 훅은 그 순간 명령 글자를 보고 막아요.

훅을 검문소로 그린 그림. 1. 클로드가 'cd 폴더 && git status' 명령을 치려 함 → 2. 훅(내 프로그램)이 명령 글자를 보고 규칙에 걸리는지 검사 → 통과(종료 코드 0)면 그대로 실행, 막힘(종료 코드 2)이면 실행 안 되고 안내문이 클로드에게 돌아감. 막히면 클로드가 'git -C 폴더 status'로 고쳐 다시 쳐서 통과. 아래에 규칙 파일은 벽에 붙인 안내문, 훅은 문 앞 검문소라는 비교
제 맥에 건 cd 막기 훅을 예로 그린 흐름이에요

제가 건 막는 훅 7개는 무엇을 막나요?

1~6번은 맥미니에, 7번은 윈도우 PC에만 걸려 있어요.

제가 건 막는 훅 7개 정리 그림. 1 cd 붙인 명령 막기(명령 직전, 허락해 둔 명령 목록과 모양이 안 맞음), 2 디스코드 답장 빠뜨림 막기(답 끝내기 직전), 3 deep-research 막기(스킬 부르기 직전, 10/26 주간 한도 소진), 4 블로그 예약 손으로 바꾸기 막기(10/28), 5 입력 열어 둔 codex exec 막기(11/3 56분·50분 멈춤), 6 대화 스스로 끝내기 막기, 7 공용 저장소 쓰기 막기(윈도우, 10/28)
  1. cd 붙인 명령 막기 (명령 직전): cd 폴더 && 명령처럼 폴더 이동을 앞에 붙인 명령을 막아요. 이렇게 치면 미리 허락해 둔 명령 목록과 모양이 안 맞아요. 막을 때 git -C 폴더 같은 대신 쓸 방법을 같이 알려 줘요.
  2. 디스코드 답장 빠뜨림 막기 (답 끝내기 직전): 저는 폰 디스코드로 클로드 코드와 대화해요. 클로드가 터미널에만 답을 쓰고 끝내면 저는 아무 답도 못 받아요. 그럴 때 끝내지 못하게 막고 디스코드로 보내라고 돌려보내요.
  3. deep-research 스킬 막기 (스킬 부르기 직전): 10월 26일 이 스킬이 서브에이전트(클로드가 띄우는 보조 작업자)를 100개 넘게 띄워 주간 한도를 다 쓴 뒤로 막았어요. 권한 거부 설정, 스킬 끄기와 함께 거는 마지막 안전망이에요.
  4. 블로그 예약 손으로 바꾸기 막기 (명령 직전): 10월 28일 글 예약이 꼬인 뒤로, 워드프레스 예약·공개·날짜 변경은 예약 도구 하나로만 하게 막았어요. 조회는 통과시켜요.
  5. 입력 열어 둔 codex exec 막기 (명령 직전): 위에서 말한 11월 3일 일 때문에 걸었어요. 같은 명령 안에 < /dev/null이나 - < 지시문.md처럼 입력을 정해 준 호출은 통과시켜요.
  6. 대화 스스로 끝내기 막기 (도구 직전): 클로드가 대화를 닫는 도구를 쓰려 하면 무조건 막아요. 세션은 제가 닫아요.
  7. 공용 저장소 쓰기 막기 (파일 쓰기·명령 직전): 10월 28일 서브에이전트가 허락 없이 다른 세션의 코드를 여러 프로젝트가 같이 쓰는 저장소에 옮겨 올렸어요. 그 뒤로 서브에이전트는 그 저장소에 쓰지 못하게 했어요.

이 밖에 명령 출력을 줄여 토큰을 아끼는 RTK와 세션 시작 때 도는 동기화 스크립트도 훅으로 붙어 있어요. 막는 훅이 아니라서 셈에서 뺐어요.

훅이 실제로 몇 번 막았나요?

맥미니에 남아 있는 클로드 코드 세션 기록(9월 9일 이후, 서브에이전트 기록 포함)에서 훅이 막았을 때 남는 줄을 셌어요. 클로드가 훅 코드를 읽기만 한 경우는 뺐어요.

  • cd 붙인 명령 막기: 674번 (9월 24일~11월 4일)
  • 디스코드 답장 빠뜨림 막기: 71번 (9월 23일~11월 4일, 세션 약 25개)
  • 블로그 예약 손으로 바꾸기: 10월 28일 서버에서 직접 예약을 바꾸려던 명령 한 번
  • deep-research: 10월 26일 한 세션에서 막은 기록
  • codex exec: 건 날 제가 시험 삼아 막아 본 것뿐
  • 대화 끝내기: 0번
  • 공용 저장소: 맥 기록에는 없음 (윈도우 PC에만 건 훅)
cd 붙인 명령을 막는 훅이 주마다 막은 횟수 막대그래프. 9월 21일 주 8번(9/24부터), 9월 28일 주 34번, 10월 5일 주 55번, 10월 12일 주 167번, 10월 19일 주 118번, 10월 26일 주 154번, 11월 2일 주 138번(11/4까지), 모두 674번
주는 월요일부터 세었어요

cd 훅이 막은 횟수를 주별로 나눠 보면 8, 34, 55, 167, 118, 154, 138번이에요. 훅이 6주 내내 걸려 있었는데도 줄지 않았어요. 주마다 돌린 세션 수는 따로 세지 않아서, 늘어난 주가 일을 많이 한 주였는지까지는 몰라요. 지금 제 규칙 파일에도 “cd 붙인 명령 금지, 훅이 막는다”라고 적혀 있는데 그래요.

막힌 바로 다음에 클로드가 친 명령도 봤어요. 따라갈 수 있었던 670번 중 266번은 훅이 알려 준 git -C 같은 모양으로 고쳐 쳤고, 368번은 다른 명령으로 넘어갔어요. 36번은 또 cd를 붙여서 한 번 더 막혔어요.

디스코드 답장 훅은 이 글을 쓰는 오늘도 걸렸어요. 제가 “ㅇ” 한 글자를 보냈을 때 클로드가 터미널에만 영어로 답을 쓰고 끝내려다 막혔고, 그다음에 디스코드로 다시 보냈어요.

이름으로 골라 막는 훅은 어떻게 생겼나요?

3번 deep-research 훅이 짧고 구조가 잘 보여요. 클로드 코드가 넘겨주는 JSON에서 부르려는 스킬 이름을 꺼내, 이름에 deep-research가 들어 있으면 막아요. 스크립트 전체예요. 제 개인 스킬 이름만 지웠어요.

block-deep-research.sh (제 맥에서 쓰는 것, 개인 스킬 이름만 지움)

#!/usr/bin/env bash
# block-deep-research: 클로드 내장 deep-research 스킬 호출 차단 훅(2026-10-26)
# deep-research 는 서브에이전트를 100개 이상 띄워 주간 한도를 다 쓴다. 리서치는 따로 만든 리서치 스킬만 쓴다.
# 권한 deny·skillOverrides 와 함께 거는 마지막 안전망 - 이름이 바뀌거나 접두사가 붙어도 deep-research 가 들어가면 막는다.

if ! command -v jq &>/dev/null; then
  exit 0
fi

NAME=$(jq -r '.tool_input.skill // .tool_input.name // .tool_input.command // empty')

if echo "$NAME" | grep -qiE 'deep[-_ ]?research'; then
  echo "BLOCKED: 클로드 내장 deep-research 는 금지(서브에이전트 대량 생성으로 주간 한도 소진). 리서치는 따로 만든 리서치 스킬을 쓸 것." >&2
  exit 2
fi

exit 0

settings.json에는 아래처럼 걸어요. 설정 파일 전체가 아니라 hooks 부분만 뗀 거예요. 이미 hooks가 있으면 PreToolUse 목록에 항목 하나만 더 넣으면 돼요. matcher가 어느 도구 앞에서 돌지 정하는데, 여기서는 스킬을 부르는 도구(Skill) 앞이에요.

~/.claude/settings.json 의 hooks 부분 (발췌)

"hooks": {
  "PreToolUse": [
    {
      "matcher": "Skill",
      "hooks": [
        { "type": "command", "command": "bash ~/.claude/hooks/block-deep-research.sh" }
      ]
    }
  ]
}

명령을 골라 막을 때도 같은 방식이에요. matcher를 Bash로 두고, JSON의 tool_input.command에서 명령 글자를 꺼내 검사해요. cd 훅은 이걸 정규식 한 줄로 하는 24줄 셸 스크립트이고, codex exec 훅은 명령을 토막 내서 보는 파이썬 67줄이에요.

훅을 걸 때 무엇을 봐야 하나요?

엉뚱한 명령까지 막히는지 봐야 해요. codex exec 훅을 만들 때는 “codex exec” 글자가 든 메모를 쓰는 명령이나 그 글자를 검색하는 명령은 통과해야 했어요. 막혀야 할 것과 통과해야 할 것 17개를 시험 파일로 만들어 두고 다 맞는지 확인했어요.

빠져나가는 길도 남아요. 제 codex exec 훅은 bash -c "codex exec ..."처럼 따옴표 안에 숨은 호출이나 파이썬 프로그램 안에서 부르는 건 못 봐요. 이 한계는 훅 코드에 주석으로 적어 두었어요.

훅이 제대로 못 돌면 그냥 통과돼요. 클로드 코드는 종료 코드가 2가 아닌 오류면 하던 일을 계속하거든요. 제 cd 훅과 deep-research 훅은 JSON을 읽는 jq가 없으면 바로 통과시키고, 디스코드 훅은 입력을 못 읽으면 통과시켜요. 새 기계로 옮기면 훅이 걸려 있어도 안 도는 일이 생길 수 있어요.

이건 기본값 이야기예요. 공식 문서를 보면 클로드 코드 2.1.295부터 훅 설정에 "onFailure": "block"을 달 수 있어요. 그러면 훅이 아예 실행되지 못하거나, 시간이 넘거나, 0·2가 아닌 코드로 끝날 때 그 일을 막아요. 다만 제 cd 훅처럼 jq가 없으면 스스로 0으로 끝내게 짠 건 실패가 아니라 통과라서, 이 설정으로도 막히지 않아요.

답 끝내기 직전에 거는 훅은 한 번 막은 뒤 또 막지 않게 해야 해요. 클로드 코드가 넘겨주는 stop_hook_active 값이 참이면 이미 한 번 막았다는 뜻이라, 제 디스코드 훅은 그때는 통과시켜요.

그래서 훅은 어디에 걸면 되나요?

결론은 한 번 새면 되돌리기 힘든 일에만 거는 게 맞았어요. 훅은 6주 동안 걸린 명령을 매번 막았지만, 클로드가 그걸 배워서 덜 하지는 않았어요. 주간 한도를 다 써 버리는 스킬, 예약 글을 손으로 바꾸는 명령처럼 한 번이라도 지나가면 손해가 큰 일에 거는 그물로 쓰면 돼요.

막을 때는 대신 쓸 방법을 안내문에 같이 적는 게 좋아요. cd 훅이 막은 뒤 따라갈 수 있었던 670번 중 266번은 안내문에 적힌 git -C 모양으로 바로 고쳐 쳤어요. 안내문이 없으면 클로드는 막힌 이유를 짐작해서 다른 길을 찾아야 해요.

규칙 파일의 금지 문장은 그대로 두고, 훅은 그 문장이 안 지켜질 때를 위한 장치로 같이 걸어요. 처음 걸 때는 막혀야 할 명령과 통과해야 할 명령을 함께 시험하고, 훅이 아예 못 도는 경우까지 막고 싶으면 onFailure 설정도 같이 달아 두면 돼요.

함께 읽을 글


2026년 11월 8일 기준.

참고한 자료

아이티플레인 · 만들면서 AI 도구를 매일 쓰는 개발자가 적습니다 · 소개 보기