Claude Code v2.1.294 — '지시문으로 쓴 훅'의 판정 오류를 잡다: 막아야 할 것을 허용하던 문제
AI

Claude Code v2.1.294 — '지시문으로 쓴 훅'의 판정 오류를 잡다: 막아야 할 것을 허용하던 문제

zaq · · 3 min read

훅(hook)을 코드가 아닌 자연어 지시문으로 쓸 때 생기는 함정이 정리됐습니다. v2.1.294는 "Block commands that..."처럼 지시문 형태로 작성된 prompt·agent 훅이 막아야 할 것을 오히려 허용하던 판정 오류를 픽스한 소형 보안 릴리스입니다.

한마디로 말하면, 훅의 판정 로직이 지시문형 훅을 더 정확히 평가하도록 개선돼, 보안 규칙이 의도대로 작동하게 된 업데이트입니다.

무슨 문제였나 — 지시문형 훅의 판정 오류

prompt 훅과 agent 훅은 자연어 지시문으로 작성할 수 있습니다. 예를 들어 "Block commands that delete files outside the project" 같은 식이죠. 문제는 이런 지시문형 훅이 실제로는 막아야 할 명령을 허용하는 경우가 있었다는 점입니다. 훅의 판정이 지시문의 의도를 정확히 따르지 못하면, 보안 규칙이 존재만 하고 작동하지 않는 — 가장 위험한 상태 — 가 됩니다. 287에서 Mods로 훅 생태계가 넓어진 만큼, 훅 품질 문제는 조직 전체의 권한 통제 문제로 번질 수 있었습니다.

Stop·SubagentStop 훅 — 조기 종료도 줄어들었다

같은 원리의 반대쪽 픽스도 있습니다. Stop과 SubagentStop에 걸린 지시문형 훅 — 예컨대 **"Carry on if the build is broken"**처럼 계속 진행 여부를 판단하는 훅 — 의 판정이 개선돼, Claude가 실제로는 계속해야 할 작업을 조기에 멈추는 빈도가 줄었습니다. 지시문형 훅의 양면(막아야 할 것을 놓치거나, 계속해야 할 것을 끊거나)이 함께 보강된 것입니다.

실전에서 어떻게 쓸까?

훅을 작성하는 팀에게 이번 픽스가 주는 교훈은 명확합니다. 강제가 필요한 규칙은 지시문이 아니라 코드로 쓰는 것이 안전합니다 — 지시문형 훅은 판정 모델에 의존하므로, 이번 픽스 같은 판정 개선에도 불구하고 결정론적 보장은 코드형(정규식·명령어 기반) 훅이 줍니다. 지시문형은 "빌드가 깨지면 계속하라" 같은 판단이 필요한 소프트 게이트에 적합하고, "rm -rf를 막아라" 같은 하드 게이트는 코드형으로 쓰세요. 그리고 294로 업데이트한 뒤 기존 지시문형 훅이 의도대로 작동하는지 재확인하세요 — 판정 기준이 바뀌었으니 기존 훅의 동작도 달라졌을 수 있습니다.

마무리로 — Mods로 훅 생태계가 넓어지는 만큼, "훅은 프롬프트다"라는 사실이 보안 경계 대상이 됐습니다. 훅을 쓰는 모든 팀이 이번 릴리스의 교훈을 자기 설정에 적용해야 하는 이유입니다.

출처: https://github.com/anthropics/claude-code/releases/tag/v2.1.294

태그: AI Claude Claude Code 개발도구