Claude Code · 2026년 10월 9일 ★★★★

클로드 코드 v2.1.295 부터 훅에 onFailure: "block" 을 두면 훅이 실패하거나 시간을 넘길 때 동작을 막고, OSC 7501 로 작업 상태를 터미널에 알려요

클로드 코드 v2.1.295 가 10월 8일 나왔어요. 명령(command)·HTTP 훅에 onFailure: "block" 을 두면 훅이 시작되지 않거나, 시간을 넘기거나, 예상하지 못한 종료 코드로 끝날 때 그 동작을 통과시키지 않고 막아요. 지금까지는 훅이 종료 코드 2 처럼 스스로 막겠다고 알려야 막혔고, 그 밖의 실패는 대부분의 이벤트에서 동작을 막지 않았어요. 함께 OSC 7501(프로그램 상태 프로토콜)을 지원해서, 이 규격을 구현한 터미널은 클로드 코드가 일하는 중인지, 사용자를 기다리는지, 끝났는지 보여 줄 수 있어요. 다만 이 규격은 미첼 하시모토가 10월 6일 공개한 초안이고, 고스티는 라이브러리(libghostty)에만 넣었으며 고스티 앱은 아직 이 보고를 쓰지 않는다고 그 풀 리퀘스트에 적혀 있어요. 클로드 앱 게이트웨이에서는 업스트림마다 models 목록을 둬서 목록에 있는 모델만 그쪽으로 보내게 할 수도 있어요.

용어 풀이
OSC
Operating System Command. 프로그램이 터미널에 보내는 제어용 문자열(이스케이프 시퀀스)의 한 종류
PreToolUse
클로드 코드가 도구를 실행하기 직전에 돌리는 훅 이벤트
운영자 인사이트

보안 검사용 PreToolUse 훅을 운영한다면 onFailure: "block" 을 켜서, 스크립트가 깨지거나 느려질 때 검사 없이 통과되는 일을 막아 두세요. 그 대신 훅이 멈추면 작업도 함께 멈추니 timeout 값도 같이 점검해야 해요. 10월 9일 기준 공식 훅 문서에는 이 설정이 아직 없어서, 지금은 릴리스 노트가 유일한 근거예요.

여러 관점으로 보기
  • OSC 7501 제안 배경 미첼 하시모토가 10월 6일 여러 에이전트를 한 화면에서 관리하는 도구들이 창 제목을 추측하는 대신 쓸 표준 상태 신호로 이 규격을 제안했고, 상태는 idle·working·done·blocked·error 예요. mitchellh.com
  • 터미널 쪽 지원 현황 고스티는 10월 6일 libghostty 에 OSC 7501 해석을 병합해 1.4.0 마일스톤에 넣었고, 고스티 앱은 아직 이 보고를 쓰지 않는다고 적었어요. GitHub
  • 규격 원문 규격은 슈퍼로지컬의 터미널 멀티플렉서 Rex 문서에 있고, 10월 7일 기준 개정 0.3 이에요. Superlogical

원본 보기 (github-releases:claude-code)