Claude Code v2.1.295, onFailure 차단 훅 및 프로그램 상태 프로토콜 추가

Claude Code v2.1.295가 새로운 훅 제어, 게이트웨이 튜닝 옵션, 그리고 MCP 및 헤드리스 모드 수정 사항 모음과 함께 출시되었습니다. 가장 주목할 만한 추가 사항은 명령 및 HTTP 훅을 위한 onFailure: "block"입니다. 훅이 시작되지 않거나, 시간 초과되거나, 예상치 못한 코드로 종료되면 해당 작업이 통과되지 않고 차단됩니다. 이는 깨진 훅이 사실상 아무 동작도 하지 않던 이전 동작을 뒤집는 것입니다.

터미널 및 CLI 변경 사항

• Program Status Protocol(OSC 7501) 지원: 이를 구현한 터미널에서 Claude Code가 작업 중인지, 사용자를 기다리는지, 완료되었는지 표시할 수 있습니다.
• /copy가 이제 선택기에 인용된 텍스트를 포함하므로, 작성 중인 메시지를 > 표시 없이 복사할 수 있습니다.
• claude -p가 마지막 턴 이후에도 열려 있으면 stderr(터미널인 경우)에 해당 실행이 무엇을 기다리는지 설명하는 줄을 출력합니다.
• ←가 현재 도구를 기다리는 중에 턴을 중지하면 "백그라운드 전환 취소됨" 메시지가 표시됩니다.
• claude plugin install, enable, disable, marketplace add가 기록하는 설정 파일이 로드되지 않으면 경고합니다.

게이트웨이 및 업스트림 제어

게이트웨이 업스트림(Bedrock, Vertex, Foundry 및 기타 클라우드 백엔드)에 두 가지 새로운 설정이 추가됩니다:

timeouts.upstream_ttfb_ms
models: ["model-id", "other-*"]

timeouts.upstream_ttfb_ms는 스트림이 시작되기까지 걸릴 수 있는 시간을 제한하며, 이를 초과하면 장애 조치되거나 502를 반환합니다. 선택적 models 목록은 주어진 업스트림으로 전송되는 모델을 제한하며(장애 조치 시 포함), 항목에 단일 *를 사용하면 와일드카드로 작동합니다. 성공적인 추론 응답은 이제 request-id 헤더를 포함하므로 Claude Code 텔레메트리의 request_id가 게이트웨이 감사 로그와 일치하며, 추론 감사 이벤트에는 Bedrock, Anthropic API 또는 기타 업스트림의 upstream_request_id가 추가됩니다.

관리 설정이 없는 머신의 경우, 사용자 설정이 이제 forceLoginMethod: "gateway" 및 forceLoginGatewayUrl을 지원하므로 /login이 해당 게이트웨이로 열립니다.

주요 수정 사항

• 게이트웨이, Bedrock, Vertex 또는 Foundry가 context-1m 베타를 거부할 때 [1m] 모델에 대한 요청이 더 이상 전체적으로 실패하지 않습니다. Claude Code가 이를 제외하고 재전송합니다.
• claude -p 텍스트 출력이 백그라운드 작업이 다른 턴을 시작할 때 이전 응답을 더 이상 누락하지 않습니다. 각 턴의 응답은 턴이 끝날 때 출력됩니다.
• 헤드리스 및 SDK 세션의 원격 MCP 서버가 15초를 초과하는 중단 후 올바르게 재연결됩니다. 연결 직후 모든 연결을 끊는 서버는 이제 촘촘한 루프 대신 최대 30초까지 백오프합니다.
• 페이지네이션 커서를 반복하는 MCP 서버에 연결당 최대 20번까지 동일한 페이지를 요청하지 않습니다.
• MCP 도구가 반환하는 CSS, JavaScript 및 XML 파일이 더 이상 .bin(Read 도구가 거부하는 형식)으로 저장되지 않습니다.
• 모델이 description 대신 command_description을 전달할 때 Bash 도구 호출이 작동합니다.

모드 작성자의 경우, $.ui.notify가 알림 설정을 통해 네이티브 알림을 발생시키고 채널을 보고합니다. 모드의 Button이 이제 자식(문자열 및 Text)을 받아들이므로 목록 행이 칩이나 흐린 세부 정보를 포함한 하나의 누를 수 있는 요소가 됩니다. CLAUDE_CODE_RETRY_WATCHDOG_MAX_WAIT_MS는 무인 재시도 모드가 429 및 529 오류를 기다리는 최대 시간을 제한합니다.