Claude Code 2.1.132 업데이트

💡

Bash 서브프로세스에 `CLAUDE_CODE_SESSION_ID`가 노출되고, `CLAUDE_CODE_DISABLE_ALTERNATE_SCREEN=1`로 풀스크린 렌더러를 끌 수 있습니다. 외부 SIGINT 종료, 슬립/깨어남 후 빈 화면, stdio MCP의 10GB+ 메모리 누수 등 운영 안정성 이슈가 다수 해결되었고, Cursor·VS Code·JetBrains 터미널의 스크롤 회귀와 Bedrock·Vertex `ENABLE_PROMPT_CACHING_1H` 400 오류도 함께 수정되었습니다.

🔗 공식 발표 →

이 글은 공식 문서를 바탕으로 요약·정리한 내용입니다.

무엇이 바뀌었나?

Claude Code 2.1.132가 2026년 5월 6일(현지 시간) 릴리스되었습니다. 새 기능 3개와 함께 안정성·렌더링·IDE 통합 회귀를 폭넓게 정리한 릴리스입니다. 외부 SIGINT 처리, 슬립/깨어남 후 빈 화면, vim 연산자가 NFD 분해 문자를 손상시키던 문제, 풀스크린에서의 그래프엠 단위 커서 이동, stdio MCP의 비프로토콜 출력으로 인한 10GB+ RSS 폭증, Bedrock·Vertex의 ENABLE_PROMPT_CACHING_1H 400 오류까지 광범위하게 다뤄졌습니다.

새 기능

  • CLAUDE_CODE_SESSION_ID 환경변수가 Bash 서브프로세스에도 노출

    hook으로 전달되는 session_id는 있었지만, Bash 도구로 실행한 서브프로세스에서는 동일 세션을 식별할 방법이 없었습니다. 이제 Bash 서브프로세스 환경에 CLAUDE_CODE_SESSION_ID가 설정되어 셸 명령에서 hook과 동일한 세션 ID를 참조할 수 있습니다.

  • CLAUDE_CODE_DISABLE_ALTERNATE_SCREEN=1 — 풀스크린 alternate-screen 옵트아웃

    풀스크린 alternate-screen 렌더러는 종료 후 대화 기록이 터미널 스크롤백에 남지 않습니다. 이 환경변수를 설정하면 alternate-screen을 사용하지 않고 터미널의 기본 스크롤백에 대화가 그대로 누적됩니다.

  • 이미지 붙여넣기 중 “Pasting…” 푸터 안내 표시

    Ctrl+V로 클립보드 이미지를 붙여넣을 때 클립보드에서 읽는 동안 어떤 피드백도 없어 동작 여부를 알 수 없었습니다. 이제 읽는 동안 “Pasting…” 안내가 푸터에 표시됩니다.

주요 개선

  • /tui fullscreen 시작 배너 메시지 보강

    alternate-screen 렌더러의 추가 이점(메모리 사용량 감소, 마우스 지원, 선택 시 자동 복사)을 시작 시점에 명시하도록 안내 문구가 다시 작성되었습니다.

  • 슬래시 명령 다이얼로그·/login·/upgrade·/extra-usage 시각 일관성 정리

    다이얼로그 간 간격·정렬이 일관되지 않던 부분이 정리되어 시각적 통일성이 개선되었습니다.

주요 버그 수정

세션·재개·종료

  • 외부 SIGINT(IDE 정지 버튼, kill -INT 등)에서 graceful shutdown이 실행되지 않던 문제 — 이제 터미널 모드가 복원되고 --resume 안내가 출력된 뒤 종료됩니다.
  • 네이티브 빌드에서 세션 도중 터미널이 닫히거나 SSH가 끊어질 때 처리되지 않은 예외가 발생하던 문제 수정.
  • 도구 오류 truncation이 이모지를 쪼개 --resumeno low surrogate in string으로 실패하던 문제 — 이미 손상된 세션은 로드 시 자동 정리됩니다.
  • plan 모드 세션을 -p --continue / --resume으로 재개할 때 --permission-mode 플래그가 무시되고, 같은 세션 내 ExitPlanMode 이후 plan 모드가 다시 적용되지 않던 문제 수정.

UI·렌더링

  • 노트북 슬립/깨어남 또는 Ctrl+Z/fg 이후 풀스크린 모드가 다음 키 입력이나 스트림 출력 전까지 빈 화면을 표시하던 문제 수정.
  • 인도계 결합 자모(Indic conjunct) 또는 ZWJ 이모지가 줄바꿈으로 걸쳐 있을 때 Ctrl+E/A/K/U·화살표 키가 그래프엠 중간에 커서를 떨어뜨리던 문제 수정.
  • vim 연산자가 NFD(분해형) 악센트 문자를 포함한 텍스트를 손상시키던 문제 수정.
  • /로 시작하는 텍스트를 붙여넣으면 입력이 그대로 사라지거나 unknown-command 응답이 뜨던 문제 수정.
  • 포커스 이벤트·마우스 트래킹 보고가 bracketed paste 중간에 끼어들면 프롬프트에 이스케이프 시퀀스가 그대로 남던 문제 수정.
  • 슬래시 명령 자동완성 팝업이 터미널 높이에 맞춰 늘어나지 않고 약 3~5개 명령만 보이도록 잘리던 문제 수정.
  • statusline의 context_window 토큰 카운트가 현재 컨텍스트 사용량이 아니라 세션 누적 합계를 반영하던 문제 수정.
  • macOS에서 “Option as Meta”가 꺼진 터미널(iTerm2·Terminal.app 기본값)에서 Alt+T(thinking 토글)가 동작하지 않던 문제 수정.

IDE·터미널 통합

  • 상위 xterm.js 버그로 Cursor와 VS Code 1.92~1.104의 마우스 휠 스크롤이 지나치게 빠르던 문제 수정.
  • JetBrains IDE 2025.2 터미널에서 스크롤 휠이 잘못된 화살표 키를 발생시키거나 방향이 반대로 동작하고, 가속이 풀려 폭주하던 문제 수정.
  • Linux/X11에서 /usage Ctrl+S로 통계 스크린샷을 클립보드에 복사할 때 멈추던 문제 수정.
  • Windows Terminal에서 /terminal-setup이 모순된 오류를 표시하던 문제 — Windows Terminal은 Shift+Enter를 기본 지원하므로 안내가 정정되었습니다.
  • claude agents로 백그라운드 세션을 다시 열면 Windows에서 키보드 입력이 죽던 문제 수정.

설정·상태

  • /effort 피커가 CLAUDE_CODE_EFFORT_LEVEL 환경변수 오버라이드를 반영하지 못하던 문제 수정.
  • 일부 사용자에게 /status가 잘못된 기본 모델을 표시하던 문제 수정.

MCP·연결

  • stdio MCP 서버가 stdout으로 비프로토콜 데이터를 출력할 때 메모리(RSS)가 10GB 이상까지 무한 증가하던 문제 수정.
  • MCP 서버가 연결은 되지만 tools/list에 실패하면 0개 도구로 조용히 표시되던 문제 — 이제 한 번 재시도한 뒤 /mcp에 “connected · tools fetch failed”로 표시됩니다.
  • 인증되지 않은 claude.ai MCP 커넥터가 “needs auth” 대신 “failed”로 표시되고, headless -p 모드가 비일시적 4xx 연결 오류까지 재시도하던 문제 수정.
  • ENABLE_PROMPT_CACHING_1H가 설정된 환경에서 Bedrock·Vertex가 400 오류를 반환하던 문제 수정.

알아두면 좋은 점

  • CLAUDE_CODE_DISABLE_ALTERNATE_SCREEN=1 — 풀스크린 alternate-screen이 끝난 뒤 대화를 스크롤백에서 다시 보고 싶다면 이 변수를 설정하세요. 단, alternate-screen의 메모리 절감·마우스 지원·자동 복사 같은 이점은 사용할 수 없습니다.
  • CLAUDE_CODE_SESSION_ID 활용 — Bash 도구로 실행하는 셸·hook 스크립트가 hook 측 session_id와 동일한 값을 참조할 수 있게 되어, 세션별 로그 분리·추적이 단순해집니다.
  • stdio MCP 서버 메모리 누수 회복 — 서버가 stdout으로 비프로토콜 데이터를 출력하면 클라이언트 RSS가 10GB 이상까지 증가할 수 있었습니다. 이번 릴리스에서 클라이언트 측 누수가 막혔습니다.
  • ENABLE_PROMPT_CACHING_1H + Bedrock/Vertex 운영자 — 그동안 1시간 캐시를 시도하면 400으로 막혔던 환경은 이번 릴리스로 정상 동작합니다.
  • JetBrains 2025.2 / Cursor / VS Code 1.92~1.104 사용자 — 마우스 휠 스크롤 회귀가 정정되었습니다. 별도 설정 변경 없이 업데이트만으로 복구됩니다.