Claude Code v2.1.88 — 메모리 누수·OOM 크래시 잡고 안정성 대폭 향상

zaq · 2026년 3월 31일 · 3 min read

Claude Code의 최신 버전 v2.1.88이 나왔습니다. 이번엔 신기능보다 안정성에 무게를 둔 업데이트로, 장시간 세션에서 겪던 크래시와 메모리 문제가 대거 수정됐습니다.

핵심 변화 한 줄 요약

긴 세션에서 발생하던 메모리 누수, OOM 크래시, 프롬프트 캐시 미스 등 골치 아픈 버그들이 싹 정리됐습니다. 장시작 개발에 Claude Code를 쓰는 분들에게 특히 반가운 소식입니다.

가장 체감 큰 변경은 메모리 누수 수정입니다. 큰 JSON 입력이 LRU 캐시 키로 계속 남아 있어서 세션이 길어질수록 메모리가 불어나던 문제를 해결했습니다. 또한 1 GiB 이상 파일에 Edit 도구를 쓸 때 발생할 수 있던 OOM 크래시도 잡았습니다.

프롬프트 캐시 관련도 개선했습니다. 긴 세션 도중 tool schema 바이트가 변경되면서 캐시 미스가 발생하던 문제와, StructuredOutput 스키마 캐시 버그로 인해 여러 스키마를 쓰는 워크플로에서 ~50% 실패율을 보이던 현상을 수정했습니다.

CLAUDE_CODE_NO_FLICKER=1 환경변수를 설정하면 깜빡임 없는 alt-screen 렌더링과 가상화된 스크롤백을 사용할 수 있습니다. 긴 세션에서 스크롤이 사라지던 문제도 수정됐고, 중복되던 배지도 정리됐습니다.

한국어 사용자에게 특히 중요한 수정 하나 — CJK 문자나 이모지가 포함된 프롬프트 히스토리가 history.jsonl의 4KB 경계에서 조용히 사라지던 버그를 잡았습니다.

PermissionDenied 훅: auto mode에서 권한 거부 시 커스텀 훅이 실행됩니다. {retry: true}를 반환하면 모델이 재시도합니다.
네임드 서브에이전트 멘션: @ 타입어헤드에서 서브에이전트 이름을 바로 선택할 수 있습니다.
LSP 서버 크래시 후 좀비 상태 방지, 훅 if 조건 필터링 개선 등도 포함됩니다.

이번 버전은 "새로운 걸 해보고 싶다"보다 "쓰던 게 더 안 터졌으면"에 답하는 업데이트입니다. 장시간 세션으로 개발하는 분들은 꼭 업데이트하세요.