사용 기록
써 본 날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)에 적은 금지는 클로드가 읽고 따르기를 기대하는 거예요. 훅은 그 순간 명령 글자를 보고 막아요.

제가 건 막는 훅 7개는 무엇을 막나요?
1~6번은 맥미니에, 7번은 윈도우 PC에만 걸려 있어요.

- cd 붙인 명령 막기 (명령 직전):
cd 폴더 && 명령처럼 폴더 이동을 앞에 붙인 명령을 막아요. 이렇게 치면 미리 허락해 둔 명령 목록과 모양이 안 맞아요. 막을 때git -C 폴더같은 대신 쓸 방법을 같이 알려 줘요. - 디스코드 답장 빠뜨림 막기 (답 끝내기 직전): 저는 폰 디스코드로 클로드 코드와 대화해요. 클로드가 터미널에만 답을 쓰고 끝내면 저는 아무 답도 못 받아요. 그럴 때 끝내지 못하게 막고 디스코드로 보내라고 돌려보내요.
- deep-research 스킬 막기 (스킬 부르기 직전): 10월 26일 이 스킬이 서브에이전트(클로드가 띄우는 보조 작업자)를 100개 넘게 띄워 주간 한도를 다 쓴 뒤로 막았어요. 권한 거부 설정, 스킬 끄기와 함께 거는 마지막 안전망이에요.
- 블로그 예약 손으로 바꾸기 막기 (명령 직전): 10월 28일 글 예약이 꼬인 뒤로, 워드프레스 예약·공개·날짜 변경은 예약 도구 하나로만 하게 막았어요. 조회는 통과시켜요.
- 입력 열어 둔 codex exec 막기 (명령 직전): 위에서 말한 11월 3일 일 때문에 걸었어요. 같은 명령 안에
< /dev/null이나- < 지시문.md처럼 입력을 정해 준 호출은 통과시켜요. - 대화 스스로 끝내기 막기 (도구 직전): 클로드가 대화를 닫는 도구를 쓰려 하면 무조건 막아요. 세션은 제가 닫아요.
- 공용 저장소 쓰기 막기 (파일 쓰기·명령 직전): 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 훅이 막은 횟수를 주별로 나눠 보면 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 설정도 같이 달아 두면 돼요.
함께 읽을 글
- codex exec가 멈출 때 막는 법, 입력 하나만 닫으면 끝나요 (셸·파이썬·노드 실측)
- 클로드 코드 토큰 줄이는 RTK, 제 맥 기록은 88%인데 명령별로 보면 달랐어요
- 디스코드 웹훅 알림 클로드 코드로 만들기, 파이썬 기본 요청은 403이 났어요
- 클로드 코드가 내 이메일을 웹사이트에 보낸다? 제 맥 기록엔 한 번 있었고, 기본 차단 장치는 제 시험을 통과시켰어요
- unslop 써 보니, 보라색 ‘AI 티’ 대시보드가 9분 만에 장부처럼 바뀌었어요
2026년 11월 8일 기준.
참고한 자료