Claude Code 업데이트 노트 — 2.1.120 → 2.1.126

작성일: 2026-05-04
범위: Claude Code 2.1.120~2.1.126 변경사항 (직전 뉴스레터 2.1.119 이후)
출처: https://github.com/anthropics/claude-code/blob/main/CHANGELOG.md

---

이번 업데이트 한눈에

워크플로우에 바로 영향

• claude ultrareview CLI 추가 — /ultrareview 를 CI·스크립트에서 비대화형 호출. --json 출력, exit 0/1 (2.1.120)
• claude project purge 추가 — 프로젝트 단위 transcript·task·file history·config 일괄 삭제. --dry-run 으로 사전 점검 (2.1.126)
• /resume 가 PR URL 검색 지원 — PR 만든 세션을 PR URL로 찾기 (2.1.122)
• MCP 서버 alwaysLoad: true 옵션 — tool-search 지연 없이 도구 즉시 사용 (2.1.121)
• /model 이 게이트웨이 모델 자동 인식 — ANTHROPIC_BASE_URL 의 /v1/models 사용 (2.1.126)
• 메모리 누수 다수 수정 — 다수 이미지 처리(수GB), /usage 큰 transcript(~2GB), 장시간 도구 (2.1.121)

Windows 환경에서 달라진 점

• 🪟 Git for Windows 의존성 제거 — Git Bash 미설치 시 PowerShell 이 셸 도구 (2.1.120)
• 🪟 PowerShell 도구 활성화 시 PowerShell 이 기본 셸 — Bash 로 폴백 안 함. 자동화 스크립트의 셸 가정 점검 필요 (2.1.126)
• 🪟 PowerShell 7 자동 감지 확대 — Microsoft Store, PATH 미등록 MSI, .NET global tool 까지 (2.1.126)
• 🪟 한·일·중 텍스트 깨짐 수정 — no-flicker 모드 (2.1.126)
• 🪟 클립보드 쓰기 보안 — copy 내용이 EDR/SIEM 에 보이는 프로세스 인자에 노출되지 않음 + 22KB 초과 선택 처리 (2.1.126)

🚨 보안·중요 수정

• allowManagedDomainsOnly / allowManagedReadPathsOnly 무시 버그 — 상위 관리 설정에 sandbox 블록 없으면 적용 안 되던 문제 수정. 관리 정책 사용 환경은 즉시 점검 (2.1.126)
• --dangerously-skip-permissions 보호 경로 축소 — 이전에 보호되던 .claude/, .git/, .vscode/, 셸 설정 파일 쓰기까지 우회 (치명적 rm 은 여전히 프롬프트, 2.1.126)
• DISABLE_TELEMETRY 우회 버그 수정 — 이전 버전들이 사용량 메트릭을 계속 전송. API·엔터프라이즈 사용자 즉시 업그레이드 (2.1.120)
• OAuth refresh 토큰 race — 동시 자격증명 쓰기로 유효 토큰이 지워지던 문제 수정 (2.1.126)

---

버전별 상세 변경사항

2.1.126 (최신)

• claude project purge [path] — 프로젝트 상태 일괄 삭제 (--dry-run/-y/-i/--all)
• /model 이 ANTHROPIC_BASE_URL 호환 게이트웨이의 /v1/models 에서 모델 목록 동적 로드
• claude auth login 이 브라우저 콜백 실패(WSL2·SSH·컨테이너) 시 OAuth 코드 직접 입력 허용
• 🚨 allowManagedDomainsOnly / allowManagedReadPathsOnly 가 상위 관리 설정의 sandbox 블록 없으면 무시되던 버그 수정
• 🚨 --dangerously-skip-permissions 가 .claude/, .git/, .vscode/, 셸 설정 파일까지 우회
• 🚨 동시 자격증명 쓰기 race 로 OAuth refresh 토큰 지워지던 문제 수정
• 🪟 PowerShell 도구 활성화 시 PowerShell 이 기본 셸로 동작
• 🪟 PowerShell 7 자동 감지 확대 (Microsoft Store / 미PATH MSI / .NET global tool)
• 🪟 클립보드 쓰기가 프로세스 인자에 노출되지 않음 + 22KB 초과 처리
• 🪟 한·일·중 텍스트가 no-flicker 모드에서 깨지던 문제 수정
• 🪟 PowerShell 도구의 bare -- (git diff -- file) 가 --% (stop-parsing) 토큰으로 오인되던 버그 수정
• 2000px 초과 이미지 붙여넣기로 세션 깨지던 문제 — 자동 다운스케일, 히스토리 초과 이미지 자동 제거 후 재시도
• Read 도구의 파일별 malware 평가 reminder 제거 (레거시 모델에서 잘못된 거부 유발)
• 백그라운드·원격 세션이 긴 thinking pause 중 "Stream idle timeout" 으로 끊기던 문제 수정
• OpenTelemetry — claude_code.skill_activated 가 사용자 슬래시 명령에서도 발화. invocation_trigger 속성(user-slash/claude-proactive/nested-skill)

2.1.123

• OAuth 인증이 CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1 환경에서 401 retry loop 에 빠지던 문제 수정 (단일 핫픽스)

2.1.122

• /resume 검색창에 PR URL 붙여넣기 로 해당 PR 만든 세션 검색 (GitHub·GHE·GitLab·Bitbucket)
• ANTHROPIC_BEDROCK_SERVICE_TIER 환경변수 — default/flex/priority 중 선택, X-Amzn-Bedrock-Service-Tier 헤더로 전달
• /mcp 가 동일 URL 수동 서버에 가려진 claude.ai 커넥터를 표시하고 중복 제거 안내
• OpenTelemetry — claude_code.at_mention 이벤트 추가, 숫자 속성을 number 로 전송
• /branch 가 rewind 된 타임라인 entry 가진 source session 에서 실패하던 문제 수정
• bash 모드의 !exit / !quit 가 셸 명령 대신 CLI 를 종료시키던 문제 수정
• 신규 모델용 이미지가 2000px 대신 2576px 로 리사이즈되던 문제 수정

2.1.121

• MCP 서버 alwaysLoad: true — tool-search deferral 우회, 도구 즉시 사용
• claude plugin prune — 고아 자동설치 플러그인 의존성 제거 (plugin uninstall --prune 으로 cascade)
• /skills 에 type-to-filter 검색창
• PostToolUse 훅의 hookSpecificOutput.updatedToolOutput 이 모든 도구 출력 교체 가능 (이전엔 MCP 전용)
• 풀스크린 입력 시 위로 올린 스크롤이 자동 하단 점프하지 않음
• MCP 서버 startup 일시 오류 시 자동 재시도 3회
• 🚨 메모리 누수 다수 수정 — 다수 이미지(수GB RSS), /usage 큰 transcript(~2GB), progress event 미전달 도구
• --resume 외부 빌드 startup crash 수정
• --resume 이 unclean shutdown 손상 transcript 라인으로 실패하던 문제 — 손상 라인 스킵
• Bash 도구가 시작 디렉토리 mid-session 삭제·이동 시 영구 사용 불가가 되던 문제 수정
• /terminal-setup 이 iTerm2 클립보드 옵션 활성화 → tmux 에서도 /copy 동작
• Vertex AI X.509 Workload Identity Federation (mTLS ADC) 지원

2.1.120

• 🪟 Git for Windows (Git Bash) 의존성 제거 — 미설치 시 PowerShell 이 셸 도구로 동작
• claude ultrareview [target] — /ultrareview 비대화형 실행. stdout 출력, --json 옵션
• 스킬 콘텐츠에서 ${CLAUDE_EFFORT} 로 현재 effort 수준 참조 가능
• 서브프로세스용 AI_AGENT 환경변수 — gh 가 트래픽을 Claude Code 에 귀속
• 🚨 DISABLE_TELEMETRY / CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC 가 사용량 메트릭을 못 막던 문제 수정
• stdio MCP 도구 호출 중 Esc 누르면 서버 연결 전체 닫히던 회귀(2.1.105) 수정
• claude --resume 으로 시작한 세션에서 /rewind 등 인터랙티브 오버레이가 키 입력에 무반응이던 문제 수정
• 큰 디렉토리 트리에서 Bash 도구의 find 가 file descriptor 고갈 → 호스트 전체 크래시 유발하던 문제 (macOS·Linux 네이티브)
• auto mode 의 파이프+리다이렉트 멀티라인 bash 에 대한 "Dangerous rm operation" 오탐지 수정
• VSCode /usage 가 네이티브 Account & Usage 다이얼로그로 변경

---

액션 아이템

• --dangerously-skip-permissions 사용 정책 재검토 — 2.1.126 부터 .claude//.git//.vscode//셸 설정까지 우회됨
• 관리 설정 점검 — allowManagedDomainsOnly/allowManagedReadPathsOnly 사용 시 상위 설정에 sandbox 블록이 명시되어 있는지 확인
• 텔레메트리 비활성화하던 환경 → 즉시 2.1.120 이상으로 업그레이드 (이전 버전은 환경변수 무시하고 메트릭 전송)
• Windows + PowerShell 도구 사용자 → 2.1.126 부터 PowerShell 이 기본 셸로 동작. 자동화 스크립트의 셸 가정 검증
• 자주 쓰는 MCP 서버 → config 에 alwaysLoad: true 추가
• CI 의 PR 코드리뷰 자동화 검토 → claude ultrareview --json

업데이트 방법

공식 권장은 네이티브 설치 (백그라운드 자동 업데이트). 즉시 적용하거나 다른 설치 방법을 쓰는 경우:

# 네이티브 설치 — 즉시 업데이트
claude update

# 🪟 WinGet (Windows)
winget upgrade Anthropic.ClaudeCode

# Homebrew (macOS / Linux)
brew upgrade claude-code            # stable 채널
brew upgrade claude-code@latest     # latest 채널

# npm
npm install -g @anthropic-ai/claude-code

네이티브 미설치 시 신규 설치 (PowerShell):

irm https://claude.ai/install.ps1 | iex

업데이트 후 claude --version 과 claude doctor 로 확인. 자세한 설치·채널·자동 업데이트 옵션은 공식 Setup 문서 참고.