← 실전 가이드 도서관 · 에이전트·검증

Claude Code가 "완료했다"고 할 때, 실제 파일을 강제로 검사하는 3중 하네스

에이전트의 완료 문장을 믿는 대신 PreToolUse · PostToolUse · Stop 훅과 verify.py 스크립트로 파일 누락·덮어쓰기를 잡아내는 실전 세팅입니다.

"다 고쳤습니다!"라는 Claude Code의 대답을 믿고 폴더를 열어 봤더니 파일이 비어 있거나 기존 설정이 날아간 경험, 한 번쯤 있으실 겁니다.

말로 "실수하지 마"라고 타이르는 프롬프트 대신, 통과 증거가 없으면 에이전트가 멈추지 못하게 만드는 결정론적 검사 장치(하네스)를 10분 안에 내 폴더에 심어 봅니다.

이 가이드 안에 들어 있는 전체 순서

총 4단계 · 복붙 프롬프트 포함
  1. 0 핵심 원리 요약 1분 요약
  2. 1 최소 완료 검사기(verify.py) 만들기 스크립트 복붙
  3. 2 .claude/settings.json 3중 훅 연결 설정 파일
  4. 3 억지 수정 방지 인계 프롬프트 프롬프트

잠긴 단계를 누르면 아래 0초 무료 해금 카드로 이동합니다.

말로 부탁하는 규칙(CLAUDE.md)과 강제하는 훅(Hooks)은 다릅니다

많은 분이 CLAUDE.md에 "절대 기존 파일을 지우지 마", "끝나면 꼭 테스트해"라고 적으면 해결될 거라 생각합니다. 하지만 컨텍스트가 길어지면 LLM은 지시문을 건너뛰고도 태연하게 완료 보고를 출력합니다.

  1. 1
    1층 · PreToolUse 가드 (실행 전 차단)
    위험한 셸 명령(rm -rf, 강제 push, 보호 파일 덮어쓰기 등 G1~G7 규칙)이 실행되기 직전에 종료 코드 2로 원천 차단합니다.
  2. 2
    2층 · PostToolUse 워처 (수정 직후 문법 검사)
    파일을 저장할 때마다 JSON·Python·마크다운 문법 검사를 자동 실행해 깨진 구문을 즉시 에이전트에게 되돌려 줍니다.
  3. 3
    3층 · Stop 훅 + verify.py (완료 전 증거 대조)
    에이전트가 대화를 끝내려 할 때 verify.py가 필수 파일 존재·빈 칸 여부·링크 무결성을 검사하고, 실패하면 종료를 거부합니다.
구분CLAUDE.md 지시문만 있을 때3중 하네스(Hooks + verify.py) 적용 시
작동 방식모델의 확률적 주의를 기대함운영체제 프로세스가 종료 코드로 강제함
거짓 완료 보고파일이 안 만들어져도 "완료" 출력 가능verify.py 통과 전까지 Stop 자체가 반려됨
실측 관찰 (16회 묶음)긴 작업에서 검증 생략·덮어쓰기 발생현행 14회 본 실험 + 추가 훅 실험 2회에서 위험 명령 차단 및 누락 재검출 확인

FREE INSTANT UNLOCK · 0초 즉시 해금

한 번만 입력하면 이 브라우저에서 12편 전체가 계속 열려 있습니다

복붙 프롬프트와 나머지 실전 단계를 바로 여세요

이메일 주소를 입력하시는 즉시 지금 읽고 계신 STEP 1~3 본문과 도서관의 모든 실전 가이드(12편)가 대기 시간 없이 바로 펼쳐집니다.

이미 구독 중인 이메일을 입력하셔도 즉시 잠금이 해제됩니다.