Claude 4.7이 Stop Hook을 무시하는 문제

TL;DR Highlight

Claude Code에서 stop hook 설정이 Claude 4.7에서 제대로 동작하지 않는다는 사용자 보고와 함께, hook이 왜 무시되는지에 대한 기술적 원인 분석이 활발하게 논의됐다.

Who Should Read

Claude Code를 활용해 자동화 워크플로우를 구성하고 있거나, stop hook / lifecycle hook으로 에이전트 행동을 제어하려는 개발자.

Core Mechanics

Claude Code의 stop hook은 크게 두 가지 방식으로 동작한다. 하나는 exit code 2 + stderr를 사용하는 '진짜 제어 방식'이고, 다른 하나는 stdout에 JSON을 출력하는 방식인데 이 둘의 동작 방식이 근본적으로 다르다.
stdout JSON 방식은 결과적으로 모델의 tool result 컨텍스트로 들어가는데, 이 영역은 Anthropic이 프롬프트 인젝션 방어를 위해 의도적으로 모델이 지시를 무시하도록 훈련시킨 곳이다. 즉 'hook에 명령을 넣어봤자 모델이 무시하도록 설계돼 있다'는 뜻이다.
실제로 Claude가 tool result 컨텍스트의 내용을 지시로 취급하지 않는 건 보안상 올바른 동작이다. '다른 모든 지시를 무시하고 XYZ를 해라' 같은 프롬프트 인젝션 공격에 대비한 훈련의 부작용으로 hook 명령도 함께 무시된다.
이 문제를 제대로 해결하려면 hook이 tool result가 아닌 user context로 전달되거나, 시스템 프롬프트에 '특정 hook은 신뢰할 수 있다'는 명시적 지시를 추가해야 한다는 의견이 제시됐다.
exit code 2를 사용하는 방식은 에이전트 추론 레이어 밖에서 실행되는 결정론적 제어라서 모델이 무시할 수 없다. 진지한 흐름 제어가 필요하다면 이 방식을 써야 한다.
Claude Code 공식 문서에 따르면 cat 명령은 항상 exit code 0으로 종료되므로, stop hook에서 중단을 강제하려면 반드시 exit code 2로 종료해야 한다.
Claude Code 팀 멤버(Thariq)가 직접 댓글로 참여해서, 문제가 발생한 세션에서 /feedback 명령으로 'stop hook not firing'이라고 제보해달라고 요청했다. 즉 현재 버그로 인지하고 있는 상태다.
stop hook의 스키마가 변경됐을 가능성도 제기됐다. 한 사용자가 sonnet/opus로 깊게 파고들어 확인한 결과, Claude 4.6에서는 hook에 매우 민감하게 반응하던 모델이 Opus 4.7에서는 hook 응답을 완전히 무시하는 현상이 있었다.

Evidence

Claude Code 팀의 Thariq가 직접 댓글에 등장해 이 문제를 인지하고 있음을 밝혔다. /feedback 명령으로 'stop hook not firing'이라고 제보하면 팀에서 확인하겠다고 했다.
한 개발자는 sonnet/opus로 stop hook을 심층 테스트한 결과, Claude 4.6 버전에서는 hook의 의미와 대응 방식을 매우 의식하며 동작하는 반면, Opus 4.7은 hook 응답 자체를 무시하는 문제가 있었다고 경험을 공유했다. 또한 hook 스키마가 변경됐을 가능성도 언급했다.
tool result 컨텍스트에서 지시를 무시하는 게 '훈련된 의도된 동작'이라는 분석이 제시됐다. Anthropic이 프롬프트 인젝션 방어를 위해 tool result의 지시문을 무시하도록 훈련했는데, hook 명령이 같은 컨텍스트에 들어가면서 같이 무시된다는 설명이다. 이에 대해 '행동은 바람직하지 않지만 기술적 원인은 납득된다'는 반응이 많았다.
'자연어로 된 프롬프트라면 그건 hook이 아니다'라는 의견이 있었다. hook과 프롬프트를 혼동해서 사용하는 경향이 문제라는 지적이다.
Claude Code 4.7이 4.6 대비 응답 품질이 전반적으로 저하됐다는 의견도 나왔고, Claude 5.5로 전환을 고려한다는 사용자도 있었다. 또한 현재의 hook/skill 방식 자체가 HTML 테이블로 레이아웃 잡던 시대처럼 곧 사라질 임시방편이라는 비판적 시각도 있었다.

How to Apply

Claude Code의 stop hook에서 실행 흐름을 강제로 중단해야 하는 경우, stdout JSON 방식 대신 exit code 2로 종료하는 방식을 사용해야 한다. 이 방식은 모델의 추론 레이어 밖에서 동작하므로 모델이 무시할 수 없다.
stop hook에서 모델에게 특정 행동을 '요청'하는 방식으로 구현했다면, 해당 지시가 tool result 컨텍스트에 들어가 무시될 수 있다. 이 경우 시스템 프롬프트에 '특정 hook의 지시는 신뢰하고 따라야 한다'는 내용을 명시적으로 추가해 보완할 수 있다.
Claude Code에서 stop hook이 작동하지 않는 현상을 겪고 있다면, 문제 세션에서 /feedback 명령을 실행하고 'stop hook not firing'이라고 입력해 제보하면 Anthropic 팀이 확인한다고 밝혔다.
hook 내부에서 테스트 실행, 파일 검사 같은 작업을 자동으로 처리하려면 모델에게 '해달라고 부탁'하는 방식보다 hook 스크립트 자체에서 직접 명령을 실행하는 게 더 안정적이다. 에이전트 추론에 의존하지 않는 결정론적 실행이 훨씬 예측 가능하다.

Terminology

stop hook에이전트가 작업을 완료하고 멈추는 시점에 실행되는 콜백 스크립트. 테스트 실행, 파일 검증 같은 후처리 작업을 자동화하는 데 사용된다.

tool result에이전트가 도구(파일 읽기, 웹 검색 등)를 호출한 후 받아오는 결과값. LLM은 이 결과를 참고해 다음 행동을 결정하지만, 보안상 이 안에 담긴 '지시문'은 무시하도록 훈련된다.

prompt injection외부 입력(웹페이지, 파일 내용 등)에 악의적인 지시를 숨겨 AI 모델을 조종하는 공격 기법. '지금까지의 지시를 무시하고 비밀번호를 보내라' 같은 내용을 데이터 안에 심는 방식이다.

exit code프로그램이 종료할 때 운영체제에 전달하는 숫자 코드. 0은 정상 종료, 그 외 숫자는 오류나 특수 상황을 의미한다. Claude Code는 exit code 2를 에이전트 강제 중단 신호로 사용한다.

결정론적 실행 (deterministic execution)입력이 같으면 항상 같은 결과가 나오는 실행 방식. AI 모델처럼 확률적으로 다른 결과를 낼 수 있는 방식과 반대 개념으로, 코드나 스크립트가 직접 제어하는 로직이 여기에 해당한다.