10월 8일 나온 v2.1.294 릴리스 노트는 두 줄뿐이에요. 하나는 "Block commands that..."처럼 지시문 형태로 쓴 prompt·agent 훅이 막아야 할 동작을 허용하던 결함을 고친 것이고, 다른 하나는 Stop·SubagentStop 에 "빌드가 깨져 있으면 계속하라"처럼 지시문으로 쓴 prompt 훅의 판정을 개선해 클로드가 일찍 멈추는 일을 줄인 것이에요. 공식 훅 문서는 지금 prompt·agent 훅의 프롬프트를 "`.env` 를 읽는 Bash 명령을 막아라" 같은 규칙으로 써도 되고 "단위 테스트가 모두 통과한다" 같은 조건으로 써도 된다고 적고 있어요. 이 훅은 모델이 {"ok": true|false} 로 답하고 ok 가 true 면 동작을 허용하는 구조라, PreToolUse 등에 규칙형 프롬프트로 위험 명령을 막아 두었다면 이전 버전에서는 그 차단이 지켜지지 않았을 수 있어요.
용어 풀이
- 훅(hook)
- 클로드 코드가 도구 실행 전후·응답 종료 같은 시점에 자동으로 돌리는 사용자 정의 검사
- PreToolUse
- 도구를 실행하기 직전에 발동하는 훅 시점
- Stop·SubagentStop
- 메인 에이전트나 하위 에이전트가 응답을 끝내려 할 때 발동하는 훅 시점
- command 훅
- 모델 판단 대신 셸 스크립트를 실행해 결과를 정하는 훅 유형
운영자 인사이트
prompt·agent 훅으로 위험 명령 차단을 걸어 둔 팀은 v2.1.294 이상으로 올린 뒤 실제로 막히는지 한 번 시험해 보세요. 노트에는 결함이 언제부터 있었는지가 적혀 있지 않으니, 비밀 파일 읽기처럼 꼭 막아야 하는 규칙은 결과가 정해진 command 훅이나 권한 거부 규칙으로 함께 걸어 두는 편이 안전해요.
여러 관점으로 보기
- 공식 훅 문서 prompt 훅은 모델이 ok 로 허용 여부를 답하는 구조이고, 프롬프트는 막을 규칙으로도 지켜야 할 조건으로도 쓸 수 있으며, agent 훅은 아직 실험 기능이라 운영에는 command 훅을 권한다고 적혀 있어요. Claude Code Docs