Claude Code v2.1.89는 지연 가능한 훅, 권한 재시도 기능을 추가하고 메모리 누수를 수정했습니다.

릴리스 v2.1.89: 훅 개선 및 중요 수정사항

Claude Code v2.1.89는 여러 훅 개선사항을 추가하고 장기 실행 세션에 영향을 미치는 안정성 문제를 해결합니다. 이번 릴리스는 권한 관리, 터미널 렌더링, 대용량 파일이나 복잡한 워크플로우에서 발생할 수 있는 충돌 수정에 중점을 둡니다.

새로운 기능 및 개선사항

• 지연 가능한 PreToolUse 훅: PreToolUse 훅에 "지연(defer)" 권한 결정을 추가했습니다. 헤드리스 세션은 도구 호출 시 일시 중지하고 -p --resume으로 재개하여 훅을 재평가할 수 있습니다.
• PermissionDenied 훅: 자동 모드 분류기가 거부한 후 실행되는 훅을 추가했습니다. {retry: true}를 반환하여 모델이 재시도할 수 있음을 알립니다.
• 자동 모드 개선: 거부된 명령어는 이제 알림을 표시하고 /permissions → Recent 탭에 나타나며, 여기서 r로 재시도할 수 있습니다.
• 환경 변수: 가상화된 스크롤백으로 깜빡임 없는 대체 화면 렌더링을 선택할 수 있는 CLAUDE_CODE_NO_FLICKER=1 환경 변수를 추가했습니다. -p 모드에서 MCP 연결 대기를 완전히 건너뛰는 MCP_CONNECTION_NONBLOCKING=true를 추가했습니다.
• 하위 에이전트 멘션: @ 멘션 입력 제안에 명명된 하위 에이전트를 추가했습니다.
• MCP 연결 시간 제한: --mcp-config 서버 연결을 가장 느린 서버에서 차단하는 대신 5초로 제한했습니다.
• 도구 요약 개선: 축소된 도구 요약이 ls / tree / du에 대해 "N개의 파일 읽음" 대신 "N개의 디렉토리 나열됨"을 표시하도록 개선했습니다.

중요한 수정사항

• 메모리 누수: 대용량 JSON 입력이 장기 실행 세션에서 LRU 캐시 키로 유지되는 메모리 누수를 수정했습니다.
• StructuredOutput 실패: 여러 스키마 사용 시 약 50% 실패율을 유발하는 StructuredOutput 스키마 캐시 버그를 수정했습니다.
• 대용량 파일 충돌: 매우 큰 파일(>1 GiB)에서 Edit 도구를 사용할 때 발생할 수 있는 메모리 부족 충돌을 수정했습니다.
• 세션 파일 충돌: 매우 큰 세션 파일(50MB 이상)에서 메시지를 제거할 때 발생하는 충돌을 수정했습니다.
• LSP 서버 복구: 충돌 후 LSP 서버 좀비 상태를 수정했습니다 — 이제 서버는 세션 재시작까지 실패하는 대신 다음 요청 시 재시작합니다.
• 자동 압축 스래싱: 자동 압축 스래싱 루프를 수정했습니다 — 이제 압축 직후 세 번 연속 컨텍스트가 한계까지 다시 채워질 때 감지하고 API 호출을 낭비하는 대신 실행 가능한 오류와 함께 중지합니다.

플랫폼별 수정사항

• Windows: Windows에서 Edit/Write 도구가 CRLF를 두 배로 만들고 Markdown 하드 줄바꿈(두 개의 후행 공백)을 제거하는 문제를 수정했습니다. Windows PowerShell 5.1에서 git push와 같은 명령어가 stderr에 진행 상황을 기록할 때 PowerShell 도구가 잘못된 실패를 보고하는 문제를 수정했습니다. Windows Terminal Preview 1.25에서 Shift+Enter가 새 줄 삽입 대신 제출하는 문제를 수정했습니다.
• macOS: macOS에서 claude-cli:// 딥 링크가 열리지 않는 문제를 수정했습니다. macOS Apple Silicon에서 음성 모드가 마이크 권한 요청에 실패하는 문제를 수정했습니다.
• 크로스 플랫폼: 일부 수정자 조합 바인딩에 대해 음성 푸시-투-톡이 활성화되지 않는 문제와 Windows에서 음성 모드가 "WebSocket 업그레이드가 HTTP 101로 거부됨"으로 실패하는 문제를 수정했습니다.

추가 수정사항

• 권한 규칙: Edit(//path/**) 및 Read(//path/**) 허용 규칙이 요청된 경로뿐만 아니라 해결된 심볼릭 링크 대상을 확인하도록 수정했습니다.
• 훅 조건: 복합 명령어(ls && git push) 또는 환경 변수 접두사가 있는 명령어(FOO=bar git push)와 일치하지 않는 훅 if 조건 필터링을 수정했습니다.
• 경로 처리: PreToolUse/PostToolUse 훅이 Write/Edit/Read 도구에 대해 file_path를 절대 경로로 수신하도록 수정하여 문서화된 동작과 일치시켰습니다.
• 재개 기능: 지연된 도구 입력이 64KB를 초과하거나 지연 마커가 없을 때 -p --resume이 멈추는 문제와 -p --continue가 지연된 도구를 재개하지 않는 문제를 수정했습니다. 이전 CLI 버전 또는 중단된 쓰기에서 도구 결과가 포함된 트랜스크립트가 있을 때 --resume 충돌을 수정했습니다.
• 오류 메시지: API가 권한 오류를 반환할 때 오해의 소지가 있는 "속도 제한 도달" 메시지를 수정했습니다 — 이제 실제 오류와 실행 가능한 힌트를 표시합니다.
• 데이터 지속성: CJK 또는 이모지가 포함된 프롬프트 기록 항목이 ~/.claude/history.jsonl에서 4KB 경계에 있을 때 자동으로 삭제되는 문제를 수정했습니다. 하위 에이전트 사용량을 제외하여 /stats가 토큰을 과소계산하고 통계 캐시 형식이 변경될 때 30일 이상의 기록 데이터를 손실하는 문제를 수정했습니다.
• MCP 오류: 서버가 다중 요소 오류 콘텐츠를 반환할 때 MCP 도구 오류가 첫 번째 콘텐츠 블록만 잘라내는 문제를 수정했습니다.
• 컨텍스트 관리: SDK를 통해 이미지가 포함된 메시지를 보낼 때 기술 리마인더 및 기타 시스템 컨텍스트가 삭제되는 문제를 수정했습니다. 많은 파일을 읽는 장기 세션에서 중첩된 CLAUDE.md 파일이 수십 번 재주입되는 문제를 수정했습니다.
• 렌더링 문제: 보조 출력에서 데바나가리 및 기타 결합 표시 텍스트가 잘리는 문제를 수정했습니다. 레이아웃 이동 후 메인 화면 터미널에서 렌더링 아티팩트가 발생하는 문제를 수정했습니다. tmux 내부에서 실행 시 iTerm2에서 스트리밍 중 주기적인 UI 지터를 수정했습니다.
• 캐시 문제: 세션 중간에 도구 스키마 바이트가 변경되어 장기 세션에서 프롬프트 캐시 누락이 발생하는 문제를 수정했습니다.
• UI 알림: 알림 invalidates가 현재 표시된 알림을 즉시 지우지 않는 문제를 수정했습니다. 처리 중에 백그라운드 메시지가 도착할 때 제출 후 프롬프트가 잠시 사라지는 문제를 수정했습니다.
• 터미널 배지: 무거운 병렬 도구 사용 중 터미널 스크롤백에서 축소된 검색/읽기 그룹 배지가 중복되는 문제를 수정했습니다.

이번 릴리스는 주로 대용량 파일, 복잡한 권한 시스템 또는 헤드리스 자동화 워크플로우를 사용하는 확장된 코딩 세션에 Claude Code를 사용하는 개발자에게 혜택을 줍니다.