티스토리 뷰

2026년 4월 28일 Claude Code 2.1.120과 2.1.121이 순차적으로 배포되었습니다. 신기능보다는 묵혀 있던 버그를 털어내는 데 힘을 쏟은 업데이트로, 멀티 이미지 처리 메모리 누수 수정, MCP 서버 안정성 강화, 플러그인 관리 체계 정비, 터미널 UX 개선이 주를 이룹니다.
3줄 요약
- 이미지 대량 처리 시 메모리가 수 GB씩 쌓이던 문제와
/usage사용 시 최대 2GB 메모리 누수가 수정되었습니다. - MCP 서버가 시작 시 오류가 생겨도 자동으로 최대 3회 재시도하며,
alwaysLoad옵션으로 특정 서버의 도구를 항상 활성화할 수 있습니다. - Windows에서 Git Bash 없이도 PowerShell로 Bash 도구를 사용할 수 있게 되고
claude plugin prune으로 고아 플러그인 의존성을 정리할 수 있습니다.
주요 변경사항
메모리 누수 대규모 수정
장기 세션에서 이미지를 많이 처리하면 RSS 메모리가 수 GB까지 쌓이던 문제가 수정되었습니다. /usage 명령어를 쓸 때 대화 기록이 긴 환경에서 최대 2GB까지 메모리가 새던 버그도 잡혔습니다. 장기 세션으로 작업을 하던 분들은 체감이 있을 거 같습니다. 도구 실행 중 진행 이벤트가 누락될 때 발생하던 메모리 누수도 이번에 함께 정리되었습니다.
MCP 서버 안정성 강화
일시적인 오류로 MCP 서버 시작이 실패하면 자동으로 최대 3회 재시도합니다. 연결 실패 상태로 방치되어 수동으로 재시작해야 하는 번거로움이 없어집니다. 새 설정 옵션 alwaysLoad도 추가되었습니다. 이 옵션을 켜면 해당 서버의 도구가 도구 검색 유예 없이 항상 활성 상태로 유지됩니다. claude.ai 커넥터 쪽에서도 동일한 URL의 커넥터가 중복 표시되던 문제와 시작 시 인증 오류로 커넥터가 조용히 사라지던 버그가 수정되었습니다.
Windows에서 Git Bash 없이도 동작
Windows에서 Claude Code의 Bash 도구를 쓰려면 Git for Windows(Git Bash)가 설치되어 있어야 했습니다. 2.1.120부터는 Git Bash가 없을 때 PowerShell을 셸 도구로 대신 씁니다. Windows에서 Claude Code를 처음 설치하는 경우라면 Git Bash 설치 단계를 건너뛸 수 있습니다.
플러그인 관리 체계 정비
claude plugin prune 명령어가 새로 추가되었습니다. 플러그인을 제거하거나 변경하면서 남은 자동 설치 의존성을 한 번에 정리할 수 있습니다. plugin uninstall --prune을 사용하면 제거 시 연쇄적으로 정리하는 것도 가능합니다. claude plugin validate도 개선되었습니다. 기존에는 marketplace.json의 $schema, version, description 최상위 필드와 plugin.json의 $schema를 인식하지 못했는데 이제 정상 처리합니다.
CI·자동화 환경 지원 확대
claude ultrareview [대상] 서브커맨드가 추가되었습니다. 기존에는 대화형으로만 /ultrareview를 실행할 수 있었지만 이제 CI나 스크립트에서 그냥 돌리면 결과가 터미널에 바로 찍힙니다. --json 플래그를 붙이면 JSON 형식으로 출력되며, 완료 시 종료 코드 0, 실패 시 1을 반환합니다. SDK와 claude -p 환경에서도 CLAUDE_CODE_FORK_SUBAGENT=1이 비대화형 세션에서 동작하도록 개선되었습니다.
부가 변경사항
터미널 UX 개선
전체화면 모드에서 위로 스크롤한 상태로 프롬프트를 입력하면 화면이 맨 아래로 튕겨 내려오던 문제가 수정되었습니다. 터미널 크기를 벗어나는 다이얼로그는 화살표 키, PgUp/PgDn, Home/End, 마우스 휠로 스크롤할 수 있습니다. 전체화면 모드에서 여러 줄에 걸쳐 줄 바꿈된 긴 URL의 아무 줄이나 클릭해도 전체 URL이 열립니다. LSP 진단 요약은 클릭하거나 Ctrl+O를 누르면 펼쳐지며, 펼침 힌트도 함께 표시됩니다.
스킬 관리 개선
/skills 다이얼로그에 검색창이 추가되었습니다. 스킬 목록이 길어진 경우 타이핑으로 빠르게 찾을 수 있습니다. 스킬 내용에서 ${CLAUDE_EFFORT} 변수를 쓰면 현재 effort 설정값을 그대로 가져올 수 있습니다.
Hooks 기능 확대
PostToolUse Hook의 hookSpecificOutput.updatedToolOutput을 통한 도구 출력 교체가 MCP 도구에만 제한되어 있었는데, 이제 모든 도구에서 동작합니다.
보안·인증 개선
--dangerously-skip-permissions 옵션이 .claude/skills/, .claude/agents/, .claude/commands/에 쓰기 작업을 할 때 더 이상 확인 창이 뜨지 않습니다. Vertex AI에서 X.509 인증서 기반 워크로드 아이덴티티 페더레이션(mTLS ADC)을 지원합니다. Microsoft 365 MCP OAuth에서 중복 또는 지원되지 않는 prompt 파라미터로 인증에 실패하던 버그가 수정되었습니다.
OpenTelemetry 관측성 강화
LLM 요청 스팬에 stop_reason, gen_ai.response.finish_reasons 필드가 추가되었습니다. OTEL_LOG_USER_PROMPTS 환경변수를 설정한 경우에는 user_system_prompt도 포함됩니다.
기타 개선사항
- 터미널 탭 세션 제목이 설정된 언어로 생성됩니다.
/terminal-setup이 iTerm2의 "Applications in terminal may access clipboard" 설정을 자동으로 활성화하여 tmux 환경에서도/copy가 동작합니다.- 스피너 팁에서 이미 데스크탑 앱을 설치했거나 스킬·에이전트를 사용 중인 경우 관련 추천 메시지가 표시되지 않습니다.
- 업그레이드 후 시작 화면에서 최근 활동 패널을 제거하여 초기 로딩이 빨라졌습니다.
AI_AGENT환경변수가 서브프로세스에 설정되어gh명령어 등이 Claude Code 트래픽임을 식별할 수 있습니다.
버그 수정
세션·재시작
--resume이 외부 빌드에서 시작 시 충돌:--resume옵션을 사용할 때 외부 빌드에서 충돌하던 문제가 수정되었습니다.- 비정상 종료 시 대용량 세션
--resume실패: 비정상 종료로 기록이 손상된 경우 해당 줄을 건너뛰고 복구합니다. - "Always allow" 규칙이 원격 세션 재시작 후 초기화: 원격 세션에서 내장 도구에 설정한 항상 허용 규칙이 워커 재시작 후 사라지던 문제가 수정되었습니다.
- 세션 종료 대신 설정 적용 후 계속 진행: 관리형 설정 승인 프롬프트에서 수락해도 세션이 종료되던 버그가 수정되었습니다.
도구·셸
- Bash 도구가 시작 디렉터리 삭제 시 영구적으로 사용 불가: 세션 중 Claude가 시작된 디렉터리가 삭제되거나 이동하면 Bash 도구 전체가 먹통이 되던 문제가 수정되었습니다.
- grep/find/rg 래퍼가 실행 중인 바이너리 삭제 시 실패: 내장 래퍼가 실패하면 설치된 도구로 자동 폴백합니다.
- 대형 디렉터리 트리에서 파일 디스크립터 고갈:
find가 대형 디렉터리 트리에서 파일 디스크립터를 소진해 macOS/Linux에서 시스템 전반에 영향을 주던 버그가 수정되고 최대 사용량도 줄었습니다. thinking.type.enabled가 지원되지 않는다는 오류: Bedrock 애플리케이션 추론 프로필 ARN 사용 시 발생하던 오류가 수정되었습니다.
터미널·디스플레이
- 스크롤백 중복 표시: tmux, GNOME Terminal, Windows Terminal, Konsole 환경에서 Ctrl+L이나 리드로 시 스크롤백이 중복 표시되던 문제가 수정되었습니다.
- 전체화면에서 "Write +N 줄" 클릭 시 접힘: 펼쳐져야 할 Write 도구 출력이 오히려 접히던 문제가 수정되었습니다.
- 슬래시 명령 선택기가 입력 중 위치 이동: 입력 중 선택기가 흔들리던 문제와 강조 표시가 연속된 부분 문자열에만 파랗게 매칭되도록 개선되었습니다.
/usage다이얼로그가 no-flicker 모드 해제 시 잘림: 콘텐츠가 잘리던 문제가 수정되었습니다./focus가 전체화면 렌더러 비활성화 시 알 수 없는 명령으로 표시: 이제 전체화면 렌더러 활성화 방법을 안내합니다.auto모드에서 자동 압축 표시: 오해를 줄 수 있는 토큰 수 대신 소문자auto로 표시됩니다.
권한·정책
- 자동 모드에서 파이프와 리디렉션이 함께 있는 멀티라인 bash 명령에 잘못된 경고: 멀쩡한 명령을 "위험한 rm 작업"으로 잘못 잡아내던 문제가 수정되었습니다.
DISABLE_TELEMETRY/CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC이 API·엔터프라이즈 사용자 메트릭을 억제하지 않던 문제: 환경변수 설정이 정상 적용됩니다.NO_PROXY가 네이티브 빌드에서 모든 HTTP 클라이언트에 미적용:managed-settings.json을 통해 설정 시 일부 클라이언트에서 무시되던 문제가 수정되었습니다.settings.json의 레거시 열거값이 전체 설정 파일을 무효화: 잘못된 열거값 하나가 전체 설정을 망가뜨리던 문제가 수정되었습니다.
MCP·커넥터
- Stdio MCP 도구 호출 중 Esc를 누르면 서버 연결 전체 종료: 2.1.105에서 발생한 회귀 버그가 수정되었습니다.
- MCP 인증에
redirectUri지원 추가: SDK의mcp_authenticate가 커스텀 스킴 완료와 claude.ai 커넥터를 위한redirectUri를 지원합니다. /plugin marketplace가 인식 불가 소스 포맷 항목 하나로 전체 로드 실패: 문제 항목은 표시하되 설치 시 업데이트를 안내합니다.
기타
/rewind등 대화형 오버레이가--resume으로 시작 후 키보드 입력 미응답: 오버레이에서 키보드가 동작하지 않던 문제가 수정되었습니다.- 스크롤 이벤트 대신 화살표 키를 보내는 터미널에 스크롤 힌트 표시: PgUp/PgDn 사용 안내가 표시됩니다.
/usage가 OAuth 토큰 만료 시 "rate limited" 반환: 만료된 토큰을 자동으로 갱신합니다.- [VSCode] 음성 받아쓰기 언어 설정 순서 개선:
~/.claude/settings.json에 언어가 없으면accessibility.voice.speechLanguage를 따릅니다. - [VSCode]
/context·/usage명령 변경:/context는 네이티브 토큰 사용 다이얼로그를,/usage는 계정 및 사용 다이얼로그를 엽니다.
마무리
Claude Code 2.1.120~2.1.121은 장기 세션 메모리 누수, MCP 서버 불안정, Windows 환경 제약처럼 오래 불편했을 문제들을 한꺼번에 정리한 업데이트입니다. 평소 자주 쓰는 기능이 걸려 있다면 해당 항목만 골라 읽어도 충분합니다.
'클로드 코드 > 패치노트' 카테고리의 다른 글
| Claude Code 2.1.122~2.1.123 업데이트 정리 (0) | 2026.04.29 |
|---|---|
| Claude Code 2.1.119 업데이트 정리 (6) | 2026.04.24 |
| Claude Code 2.1.118 업데이트 정리 (2) | 2026.04.23 |
| Claude Code 2.1.117 업데이트 정리 (0) | 2026.04.22 |
| Claude Code 2.1.116 업데이트 정리 (0) | 2026.04.21 |