본문으로 건너뛰기

PreToolUse 훅을 읽고 deny 규칙 후보 가리기

Fri-mer

2026.10.22

PreToolUse 훅을 읽고 deny 규칙 후보 가리기 본문 이미지

소개

3주차 강의에서 스터디장 진선이 님이 "만든 뒤에 마주치는 문제"와 "자동화할 업무인지 먼저 따지기", 터미널의 상태줄과 압축(compact), 반복되는 실수를 금지 규칙으로 저장하라는 조언을 주셨습니다. 이 기준을 제 Claude Code 환경에 대어 보고, 2주차에 남긴 숙제 하나(PreToolUse 훅 5개를 읽고 permissions.deny로 옮길 규칙을 고르기)를 실제로 끝낸 기록입니다. 훅 판정 스크립트는 시험을 먼저 쓰고 실패를 본 뒤 구현했습니다. 규칙을 문서에 적어 두기만 하고 실제로 막는 장치는 얼마나 되는지 궁금한 분, 점검 항목을 늘리기보다 작은 개선 하나를 끝내 보고 싶은 분께 도움이 될 것 같습니다.

업무자동화 스터디 3주차는 이렇게 진행됐습니다. 시작 20분은 스터디장이 사례 대신, 만든 워크플로우가 멈추는 이유(Gemini 모델 교체, 구글 인증의 테스트 상태가 7일 뒤 만료되는 문제)와 알아 둘 다섯 가지를 다뤘습니다. 이어 터미널과 데스크톱 앱의 차이, 위키를 소개했고, 쉬는 시간 뒤에는 수강생과 청강생 여섯 분이 사례를 발표했습니다. 과제 문구는 "다음 주 과제는 카톡으로 안내하겠다"는 말만 자막에 있고 내용은 확인되지 않았습니다.

저는 이 스터디를 청강합니다. 측정일은 2026-10-22이고, ~/.claude와 설치 팩의 훅 파일은 읽기만 했으며 어느 것도 고치지 않았습니다.


진행 방법

사용 도구: Python 3, pytest, Claude Code, 터미널 읽기 명령(docker, curl, stat)

Step 1. 강의 기준과 잴 것

3주차 강의 기준

잴 것

측정 방법

자동화하기 전에 빈도와 중요성을 따진다

1주차에 고른 후보 세 가지가 나온 날의 비율

세션 기록의 사람 메시지, 2주차와 같은 정규식

반복되는 실수는 금지 규칙으로 저장한다

글로 적은 금지 표현과 막는 장치

규칙 파일 읽기, settings.json

컨텍스트가 50% 정도 차면 압축한다

압축 방식(자동, 수동)

세션 기록의 compact_boundary

상태줄에 컨텍스트와 5시간, 주간 사용량을 표시한다

제 상태줄 설정

settings.json의 statusLine

세션을 여러 개 동시에 띄운다(스터디장은 6~7개)

60분 안에 메시지를 보낸 세션 수

세션 기록

만든 뒤에도 멈추는 이유를 챙긴다

이 컴퓨터의 n8n 상태

docker, curl

그리고 2주차 다음 주 계획 열 개의 실행 여부를 확인했습니다. 이 가운데 훅 읽기가 이번 글의 중심입니다.

Step 2. 훅 판정 시험 먼저 쓰기

2주차 글에는 "PreToolUse 훅 5개가 어떤 규칙을 실제로 막는지는 읽지 않았다"고 적었습니다. 훅은 도구 호출 직전에 실행되는 스크립트이고, exit 2로 끝나면 그 호출이 막힙니다. permissions.deny는 도구 이름과 경로 패턴으로 호출을 막는 설정이므로, 훅이 도구 입력만 보고 막는지 디스크의 다른 파일 상태까지 보고 막는지가 옮길 수 있는지를 가릅니다.

기준을 세 가지로 정하고, 참값을 아는 모의 훅으로 시험 13개를 먼저 썼습니다.

판정

정의

막을 수 있음

주석을 뺀 코드에 exit 2, sys.exit(2), permissionDecision deny가 있다

외부 상태 의존

막을지를 파일 존재, 마커, 외부 엔진 상태로 정한다

deny 이전 후보

막을 수 있고 외부 상태에 의존하지 않는다

시험 대상은 도구 입력만으로 막는 훅, 파일 존재를 보고 막는 훅, 관측만 하는 훅, 주석에만 exit 2가 적힌 훅, 훅 5개짜리 설정 파일(Stop 훅은 세지 않고, 없는 스크립트는 읽지 못한 것으로 따로 센다), 그리고 판정이 파일을 바꾸지 않는지입니다. 세션 기록 쪽 계산 함수 둘(동시 세션 수의 최댓값, 압축 집계)도 참값이 있는 입력으로 시험했습니다.

python3 -m pytest -q
13 failed in 0.24s        (구현 전, 함수 본문이 NotImplementedError)
13 passed in 0.10s        (구현 후)

구현 전에는 전부 실패했고 구현 뒤에 모두 통과했습니다. 경계 시험으로 "정확히 60분 떨어진 세션은 같은 창에 넣지 않는다"를 더했습니다. 휴리스틱이라 완벽하지 않고, 주석 뒤에 붙은 exit 2나 문자열로 만든 exit 2는 정규식이 구분하지 못합니다.

Step 3. 훅 5개 읽기와 판정

판정 스크립트를 실제 설정에 돌린 뒤, 판정이 맞는지 훅 본문을 직접 읽어 대조했습니다.

r = H.audit_settings(json.load(open(os.path.expanduser('~/.claude/settings.json'))))
# {'total': 5, 'blocking': 2, 'movable': 0, 'unreadable': 0}

훅

하는 일

막는 조건

Bash 호출 전 git 스냅샷

작업 폴더를 refs/snapshots/claude-auto에 저장

막지 않음. 항상 exit 0

appbuild-gate (Edit, Write)

기획 문서가 끝나기 전 소스 파일 쓰기를 막음

폴더에 .appbuild가 있고 05-gate.md가 없을 때, 확장자가 소스(.py, .ts 등)일 때

cys-hook (전체)

도구 호출 기록을 쌓음

막지 않음. 파일에 "절대 차단하지 않는다"고 적힘

grill-gate (Edit, Write)

인터뷰 질문이 최소 개수에 못 미치면 구현 파일 쓰기를 막음

마커 파일이 활성이고 결정 항목 수가 기준 미만일 때

grill-arm (Skill)

인터뷰 스킬을 쓰면 위 게이트를 켬

막지 않음

이 훅은 모두 설치 팩이 깐 것이고 제가 만든 것이 아닙니다. 결과는 다섯 개 중 막을 수 있는 것이 두 개이고, 두 개 모두 폴더 안의 파일이나 인터뷰 진행 상태를 보고 막을지를 정하므로 deny로 옮길 후보는 0개였습니다. deny는 "소스 파일 쓰기 금지"처럼 고정된 패턴은 표현할 수 있어도 "05-gate.md가 없을 때만"이라는 조건은 표현하지 못합니다. 억지로 Edit 패턴을 걸면 게이트가 열린 뒤에도 계속 막힙니다. 옮겨 보는 시험은 하지 않았습니다.

금지 표현이 든 줄을 규칙 파일별로 센 막대그래프. 전체 132줄 중 writing-style.md가 79줄이고 permissions.deny는 0개

그러면 deny 후보는 훅이 아니라 규칙 글에서 찾아야 합니다. 2주차와 같은 정규식으로 규칙 파일을 다시 세었습니다.

PROHIB = re.compile(r"하지 않는다|쓰지 않는다|넣지 않는다|금지|않는다\.|마라|말 것|안 된다")

금지 표현이 든 줄은 2주차 121줄에서 132줄로 늘었고, 그중 79줄이 문체 규칙(writing-style.md)입니다. 문장을 어떻게 쓰라는 규칙은 도구 호출을 막는 deny로 옮길 수 없습니다. 도구 동작과 관련될 수 있는 줄은 나머지 53줄이고, 이번에는 이 줄들을 하나씩 열어 분류하지 못했습니다. permissions.deny는 여전히 0개입니다. settings.json은 2주차 측정 뒤인 10월 20일에 수정됐지만 deny 개수와 PreToolUse 훅 수는 그대로였습니다.

Step 4. 2주차 계획 열 개의 실행 여부

2주차 계획 10개의 실행 여부를 색으로 나눈 표. 미실행 5, 확인 못 함 2, 미정 1, 일부 완료 1, 완료 1

n8n과 관련된 다섯 개는 Docker 엔진이 꺼져 있어 진행되지 않았습니다.

docker ps -a                                          # Cannot connect to the Docker daemon
curl -s -m 5 -w '%{http_code}' 127.0.0.1:5678/healthz # 000
pgrep -fl 'Docker Desktop|com.docker.backend' | wc -l # 0

스터디장은 만든 뒤에 멈추는 이유를 알려 줬는데, 제 쪽은 만들기 전 단계에 멈춰 있습니다. 컨테이너가 남아 있는지, 소유자 계정이 만들어졌는지, Execute Command 노드가 꺼져 있는지는 컨테이너 안을 봐야 해서 확인하지 못했습니다. 연결된 MCP는 atlassian, gmail, notebooklm이고 n8n 스킬 폴더는 0개입니다. 절전 스크립트도 10월 14일 이후 새로 만든 것이 없습니다. 워크시트의 1회 소요시간 칸 2개는 여전히 비어 있습니다. 스터디장은 "절감 시간을 측정해야 포트폴리오가 된다"고 했는데, 이 칸이 채워지지 않아 제 경우에는 절감 시간을 말할 수 없습니다.

Step 5. 후보 세 가지의 세 구간 비교

스터디장은 자동화하기 전에 빈도와 중요성을 따져 보라고 했습니다. 2주차 계획에는 "1순위 후보를 3주차 구간까지 보고 정한다"가 있었으므로 같은 정규식으로 구간을 하나 더 셌습니다.

python3 24기업무자동화_3주차_측정.py ../assets/측정결과.json
1주차에 고른 후보 세 가지가 세 구간에서 나온 날의 비율. 외부 모델 결과 전달은 44%, 22%, 50%로 오르내리고 화면 캡처 확인은 10%, 78%, 100%로 올랐다

요청

8/24~10/4

10/5~10/13

10/14~10/21

절전

30건, 20일(49%)

10건, 7일(78%)

9건, 4일(50%)

외부 모델 결과 전달(요청 형태)

46건, 18일(44%)

6건, 2일(22%)

5건, 4일(50%)

화면 캡처 확인

44건, 4일(10%)

63건, 7일(78%)

64건, 8일(100%)

1주차에 첫 후보로 고른 외부 모델 결과 전달은 2주차 구간에서 22%로 줄었다가 3주차 구간에서 50%로 되돌아왔습니다. 2주차 글의 "후보를 다시 봐야 한다"는 판단은 한 구간만 보고 내린 것이었습니다. 두 구간을 이어 봐도 한쪽으로 기울지 않아서 이번 값만으로 1순위를 바꾸거나 유지한다고 말하지 않습니다. 이 결정은 제가 정할 일입니다. 화면 캡처 확인은 구간이 지날수록 나온 날이 늘어 3주차 구간은 8일 전부에 나왔지만, 화면을 보는 일이라 n8n이 맡기에 맞는지는 따로 따져야 합니다.

1주차 구간(8/24~10/4)의 값은 2주차 글에 실은 값과 다릅니다(메시지 2,006건에서 1,897건, 세션 23개에서 18개, 절전 33건에서 30건). 원인을 확인했습니다. 세션 파일이 48개에서 63개로 늘었는데 가장 오래된 파일의 수정일이 2026-09-23이었습니다.

python3 -c "import glob,os,datetime as d;print(d.datetime.fromtimestamp(min(os.path.getmtime(f) for f in glob.glob(os.path.expanduser('~/.claude/projects/*/*.jsonl')))))"
# 2026-09-23 05:46:15
grep -c cleanupPeriodDays ~/.claude/settings.json   # 0

설정에 보관 기간 값이 없고 9월 23일보다 앞의 파일이 없으므로, 오래된 세션 파일이 일정 기간 뒤 지워졌을 가능성이 큽니다. 기본 보관 기간은 공식 문서로 확인하지 않았습니다. 앞으로 8월~9월 초 구간은 다시 셀 수 없다는 뜻이라, 이 구간은 2주차 글에 실은 값을 기준으로 두고 비교는 두 신규 구간끼리 해야 합니다. 2주차 구간(10/5~10/13)은 메시지 858건이 그대로 나왔고, 모델 응답 수만 첫 실행에서 달랐습니다. 이어받은 세션이 같은 응답 기록을 복제해서(12,566건 중 고유 기록 11,378건) 응답 id로 한 번만 세도록 고치자 2주차 값(Opus 9,167, Sonnet 1,278)과 같아졌습니다. 복제가 2주차 측정 때보다 늘어난 이유는 모릅니다.

Step 6. 압축과 동시 세션과 상태줄

압축 방식과 60분 안에 메시지를 보낸 세션 수. 수동 압축은 7/25, 2/29, 3/18건이고 동시 세션 최댓값은 5, 5, 6개

스터디장은 컨텍스트가 50% 정도 찼을 때 압축하고, 상태줄에 컨텍스트와 5시간, 주간 사용량을 띄워 두라고 했습니다. 제 settings.json에는 이미 상태줄이 설정돼 있었고 스크립트에 컨텍스트, 5시간, 7일 사용량 표시가 모두 있었습니다. 압축은 3주차 구간에 18건이었고 그중 수동은 3건입니다. 압축 직전 토큰 수의 중앙값은 348,160이었지만 창 크기를 기록에서 확인하지 못해 50%에 맞췄는지는 말할 수 없습니다. 동시 세션은 3주차 구간 최댓값이 6개입니다. 다만 스터디장이 말한 "동시에 띄운 개수"와 달리 제 값은 60분 안에 메시지를 보낸 세션 수라 같은 지표가 아닙니다. 모드는 사람이 보낸 메시지 949건 중 943건이 자동 모드이고 계획 모드는 5건으로, 2주차와 같은 경향입니다. 응답 모델은 Opus 계열 88.9%, Sonnet 계열 6.8%였습니다.


결과와 배운 점

측정 결과

항목

값

낸 방법

PreToolUse 훅

5개 중 막을 수 있는 것 2개, deny 이전 후보 0개

hook_audit.py 판정, 훅 본문 직접 확인

금지 표현이 든 줄

132줄(2주차 121줄), 그중 문체 규칙 79줄

2주차와 같은 정규식

permissions.deny

0개

settings.json 읽기

외부 모델 결과 전달이 나온 날

44%, 22%, 50%

세션 기록, 정규식

압축

3주차 구간 18건 중 수동 3건

compact_boundary

2주차 계획 열 개

완료 1, 일부 완료 1, 미실행 5, 확인 못 함 2, 미정 1

파일, 설정, 명령

시험

구현 전 13개 실패, 구현 후 13개 통과

pytest

배운 점

  1. 훅이 하는 일과 deny가 하는 일은 겹치는 부분이 적었습니다. 훅 다섯 개 중 막을 수 있는 둘은 모두 상태를 보고 막으므로, 2주차 글의 "금지 121줄 대 deny 0개"는 훅을 옮겨서 메워지지 않습니다. deny에 넣을 규칙은 규칙 글에서 새로 골라야 하고, 이번에는 그 53줄을 분류하지 못했습니다.

  2. 판정을 스크립트로 만들어 두니 훅이 늘어도 다시 읽지 않고 판정할 수 있습니다. 다만 휴리스틱이라 훅을 새로 깔았을 때는 본문을 한 번 읽어 대조해야 합니다.

  3. 한 구간으로 정한 판단은 다음 구간에서 뒤집힙니다. 스터디장이 말한 "고민하지 말고 먼저 시도하라"와 "필요한지 먼저 따져라"는 시기가 다른 조언으로 읽혔습니다. 빈도는 구간을 이어서 봐야 따질 수 있었습니다.

  4. 측정은 원본이 지워지면 다시 할 수 없습니다. 1주차 구간 값이 달라진 것은 계산이 바뀐 것이 아니라 세션 파일이 줄었기 때문으로 보입니다. 숫자를 글에 쓸 때 원본도 함께 남겨 둬야 하는데, 이번에 측정 결과를 assets/측정결과.json으로 저장했습니다.

  5. 만든 뒤 단계에 들어가려면 먼저 만들어야 합니다. 스터디장이 알려 준 모델 교체 메일이나 인증 만료는 워크플로우가 돌아야 겪는 일인데, 저는 Docker를 켜는 첫 단계에 있습니다.

시행착오

  • 모델 응답 수가 2주차 값과 달라 이상하다고 봤고, 응답 id 중복을 확인하고 나서야 2주차 값과 맞췄습니다. 처음부터 중복을 제거하지 않은 것은 2주차 스크립트를 그대로 복제했기 때문입니다.

  • 판정 기준의 "외부 상태 의존" 정규식은 marker, git status 같은 단어도 잡습니다. 이번 훅 다섯 개에는 맞았지만 다른 훅에서는 과하게 잡을 수 있습니다.

  • 훅 다섯 개의 판정을 스크립트에만 맡기지 않고 본문을 직접 읽었습니다. 스크립트는 설치 팩의 엔진 호출(grill_gate.py check)이 막는 조건을 보지 못하므로 GATE_PY 문자열로 대신 잡았습니다.

이 측정은 2026년 10월 22일 ~/.claude/projects/ 최상위 세션 파일 63개에서 8월 24일부터 10월 21일까지 제가 직접 보낸 메시지를 Python으로 센 결과입니다. 하위 에이전트 기록과 Claude Code 밖의 대화는 보지 않았고, 요청 유형은 정규식이라 키워드가 없는 요청은 잡히지 않습니다. 훅은 settings.json의 PreToolUse 5개만 읽었고 deny 규칙을 실제로 적용해 막히는지는 시험하지 않았습니다. 컨테이너 안의 n8n 상태와 53줄의 분류는 하지 못했습니다.


도움 받은 글

  • 24기 업무자동화 3주차 강의 (진선이): 멈추는 이유, 알아 둘 다섯 가지, 상태줄과 압축, 위키, 금지 규칙으로 저장하라는 조언

  • 칼로스 님의 발표: 기존 데이터의 이름이 서로 다르면 자동화보다 정합성 맞추기가 더 어렵다는 이야기. 세션 파일이 줄어 구간 값이 달라진 것을 살필 때 떠올렸습니다

  • 둘리아빠 님의 발표: 만들고 나서 "이게 꼭 필요한가"를 묻고 워크플로우 몇 개를 접은 경험. 후보를 구간별 빈도로 다시 본 계기였습니다

  • 크레송 님의 발표: 연동이 막힌 이유가 회사의 구독이나 권한일 수 있고 사내 담당자와 상담하라는 답변. 막는 장치를 누가 정하는지 살필 때 참고했습니다

  • 24기 업무자동화 2주차 사례글(본인): 2주차 계획과 측정 정의

1

함께 이야기해요 1

로그인하고 댓글을 남겨 주세요

뽀짝이 프로필 이미지
뽀짝이2026.10.22

훅 5개 중 막을 수 있는 2개가 모두 "05-gate.md가 없을 때만"처럼 파일 상태를 보고 막기 때문에 deny 후보가 0개라는 결론이 인상적이에요. 억지로 Edit 패턴을 걸면 게이트가 열린 뒤에도 계속 막힌다는 설명 덕분에 훅과 deny가 겹치는 부분이 왜 적은지 바로 이해됐습니다.

스크립트 판정만 믿지 않고 훅 본문을 직접 읽어 대조하셨다는 점, 그리고 53줄을 분류하지 못했다고 한계를 숨기지 않고 적어 주신 점이 믿음직스러워요. 다음 주에 그 53줄에서 deny 후보가 몇 개 나오는지 궁금합니다.

꼬리 탁! 치고 응원하고 갈게요 🐈‍⬛

필요한 AI 정보만
메일함에 쏙쏙 넣어드려요.

지금 핫한 AI 소식부터 직접 해 본 사례까지, 월요일마다 무료로 받아보세요

이런 사례도 있어요

사례 전체 보기