Claude Code 업데이트 노트 — 2.1.128 → 2.1.132

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

메모: 2.1.127, 2.1.130 은 공식 changelog 에 항목이 없음(미공개·취소 추정). 2.1.131 은 Windows VS Code 활성 실패만 다룬 핫픽스.

---

이번 업데이트 한눈에

워크플로우에 바로 영향

• 게이트웨이 /v1/models 자동 발견 → opt-in 으로 되돌림 — 2.1.126 에서 자동이었던 동작이 CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY=1 가 있어야 동작하도록 변경. 사내 게이트웨이 환경에서 /model 목록이 빈 경우 환경변수 추가 (2.1.129)
• Ctrl+R 히스토리 검색 범위 — 전 프로젝트 기본으로 복원 (pre-2.1.124 동작). 현재 프로젝트·세션으로 좁히려면 Ctrl+S (2.1.129)
• 새 환경변수 다수 — CLAUDE_CODE_SESSION_ID(Bash 서브프로세스에 hook 의 session_id 전달), CLAUDE_CODE_DISABLE_ALTERNATE_SCREEN=1(풀스크린 렌더러 끄고 native scrollback 유지), CLAUDE_CODE_FORCE_SYNC_OUTPUT=1(자동감지 누락 터미널 강제) (2.1.129, 2.1.132)
• --plugin-url <url> — 플러그인 .zip 을 URL 에서 임시 로드 (현재 세션 한정, 2.1.129)
• --plugin-dir 가 .zip 도 허용 — 디렉토리 외 zip 아카이브 직접 지정 (2.1.128)
• /mcp 가 서버별 도구 수 표시 — 0 도구로 연결된 서버 플래그도 표시 (2.1.128)

자동화·CI 영향

• EnterWorktree 가 로컬 HEAD 에서 새 브랜치 생성 — 이전엔 origin/<default-branch> 에서 생성해 미푸시 커밋 유실. worktree 자동화 스크립트 점검 (2.1.128)
• 병렬 셸 도구 호출 — 한 read-only 실패가 다른 호출을 취소하지 않음 (2.1.128)
• --print / SDK 의 init.plugin_errors 에 --plugin-dir 로드 실패가 포함되도록 확장 (2.1.128)
• CLAUDE_CODE_PACKAGE_MANAGER_AUTO_UPDATE — Homebrew·WinGet 설치에서 백그라운드 업그레이드 + 재시작 프롬프트 (2.1.129)
• --permission-mode 가 resume + plan-mode 에서 무시되던 버그 수정 — -p --continue/--resume + plan mode 사용하는 CI 잡 점검 (2.1.132)

🚨 보안·중요 수정

• stdio MCP 서버 비프로토콜 stdout → 메모리 무한 증가(10GB+) 수정 — stdout 에 로그 찍는 MCP 서버가 있었다면 즉시 영향. 업그레이드 권장 (2.1.132)
• OAuth refresh race (wake-from-sleep) — 모든 실행 중인 세션이 로그아웃되던 문제 수정 (2.1.129)
• 1시간 prompt cache TTL 이 silently 5분으로 다운그레이드 되던 회귀 수정 (2.1.129)
• 서브프로세스(Bash·hooks·MCP·LSP) 가 OTEL_* 환경변수 상속 차단 — Bash 도구로 실행하는 OTEL 계측 앱이 Claude Code 의 OTLP endpoint 로 잘못 전송되던 문제 (2.1.128)
• MCP workspace 가 예약 서버명 — 동명 기존 서버는 경고 후 스킵. 해당 이름 쓰던 환경은 사전 개명 필요 (2.1.128)
• deniedMcpServers 의 *:// 스킴 와일드카드 가 대소문자 섞인 호스트네임에 매칭 안 되던 보안 우회 가능성 수정 (2.1.129)
• enterprise/team OAuth credentials 에 user:inference scope 누락 시 managed-settings 정책 미적용 버그 수정 (2.1.129)
• Bash(mkdir *), Bash(touch *) 등 allow 규칙이 in-project 경로에 적용 안 되던 버그 수정 (2.1.129)

🪟 Windows·IDE 환경

• VS Code 확장이 Windows 에서 활성 실패 — bundled SDK 하드코딩 빌드 경로(createRequire 폴리필 버그). 2.1.131 핫픽스로 해결 (2.1.131)
• /terminal-setup 의 Windows Terminal 모순 메시지 수정 — Shift+Enter 는 Windows Terminal 에서 네이티브 지원 (2.1.132)
• claude agents 백그라운드 세션 재오픈 시 키보드 입력 죽음 수정 (2.1.132)
• 풀스크린이 sleep/wake·Ctrl+Z/fg 후 빈 화면 표시 되던 버그 수정 (2.1.132)

---

버전별 상세 변경사항

2.1.132 (최신)

• 🚨 stdio MCP 서버가 비프로토콜 데이터를 stdout 에 쓰면 메모리 무한 증가(10GB+ RSS) → 수정
• CLAUDE_CODE_SESSION_ID 환경변수 — Bash 도구 서브프로세스에 hooks 의 session_id 와 동일 값 전달
• CLAUDE_CODE_DISABLE_ALTERNATE_SCREEN=1 — 풀스크린 alternate-screen 렌더러 끄고 대화를 터미널 native scrollback 에 유지
• --permission-mode 플래그가 -p --continue/--resume 로 plan-mode 세션 재개 시 무시되던 버그 수정. ExitPlanMode 후 plan mode 재적용 누락도 수정
• 외부 SIGINT(IDE stop, kill -INT)가 graceful shutdown 안 되던 문제 수정 — 터미널 모드 복원, --resume 힌트 표시
• 🪟 claude agents 백그라운드 세션 재오픈 후 Windows 키보드 입력 죽던 문제 수정
• 🪟 /terminal-setup 이 Windows Terminal 에서 모순 에러 표시 — Shift+Enter 네이티브 지원 안내로 수정
• --resume 가 emoji 가 truncation 으로 분리될 때 no low surrogate in string 으로 실패 — 사전 손상 세션은 로드 시 sanitize
• 풀스크린이 laptop sleep/wake 또는 Ctrl+Z/fg 후 빈 화면 → 다음 keystroke 까지 안 그려지던 문제 수정
• / 로 시작하는 텍스트 붙여넣기가 silently 삼켜지거나 unknown-command reply 유발하던 문제 수정
• /effort picker 가 CLAUDE_CODE_EFFORT_LEVEL 환경변수 override 를 반영 안 하던 문제
• statusline context_window 토큰이 세션 누적이 아니라 현재 컨텍스트 사용량을 반영하도록 수정
• "Pasting…" 푸터 힌트 — Ctrl+V 이미지 붙여넣기 진행 중 표시
• 슬래시 명령 자동완성 팝업이 ~3–5 개로 캡되던 문제 수정 (터미널 높이에 맞춰 확장)
• Bedrock/Vertex 가 ENABLE_PROMPT_CACHING_1H 설정 시 400 에러 내던 문제 수정
• MCP 서버가 연결됐으나 tools/list 실패 시 0 도구로 표시되던 문제 — 한 번 재시도 후 /mcp 에 "connected · tools fetch failed" 표시
• 미인증 claude.ai MCP 커넥터가 "failed" 대신 "needs auth" 로 표시 + headless -p 모드의 비일시적 4xx 재시도 중단
• /tui fullscreen 시작 배너에 추가 렌더러 이점(낮은 메모리, mouse, auto-copy on select) 설명

2.1.131 (Windows 핫픽스)

• 🪟 VS Code 확장이 Windows 에서 활성 실패 — bundled SDK 의 하드코딩 빌드 경로 (createRequire 폴리필 버그) 수정
• Mantle endpoint 인증이 x-api-key 헤더 누락으로 실패하던 문제 수정

2.1.129

• 🚨 게이트웨이 /v1/models 자동 발견이 opt-in 으로 변경 — 2.1.126–2.1.128 까지 자동이었음. 이제 CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY=1 필요
• Ctrl+R 히스토리 검색 기본값 — 전 프로젝트 모든 프롬프트 (pre-2.1.124 동작 복원). Ctrl+S 로 현재 프로젝트/세션 좁히기
• --plugin-url <url> — 플러그인 .zip 아카이브를 URL 에서 현재 세션 한정으로 로드
• CLAUDE_CODE_FORCE_SYNC_OUTPUT=1 — 자동감지 누락 터미널에서 synchronized output 강제 (Emacs eat 등)
• CLAUDE_CODE_PACKAGE_MANAGER_AUTO_UPDATE — Homebrew·WinGet 설치에서 백그라운드 업그레이드 + 재시작 프롬프트
• 플러그인 manifest — themes 와 monitors 는 "experimental": { ... } 안에 선언 권장. top-level 도 동작하나 claude plugin validate 가 경고
• 3P 배포(Bedrock, Vertex, Foundry, ANTHROPIC_BASE_URL 게이트웨이) 사용자에게 first-party Anthropic 표면 가리키는 spinner tip 안 표시
• skillOverrides 설정 동작 수정 — off 는 모델·/ 양쪽 숨김, user-invocable-only 는 모델만 숨김, name-only 는 설명 접음
• claude_code.pull_request.count OTel 메트릭이 MCP 도구로 만든 PR/MR 도 카운트 (이전엔 셸 명령만)
• 정책 거부 에러 메시지에 API Request ID 포함 (지원 디버깅 용이)
• 🚨 wake-from-sleep 후 OAuth refresh race 로 모든 실행 중인 세션이 로그아웃되던 문제 수정
• 🚨 1시간 prompt cache TTL 이 silently 5분으로 다운그레이드되던 문제 수정
• 🚨 Bash(mkdir *), Bash(touch *) 등 allow 규칙이 in-project 경로에 적용 안 되던 버그 수정
• 🚨 deniedMcpServers *:// 스킴 와일드카드가 mixed-case 호스트네임에 매칭 안 되던 문제 수정
• 🚨 enterprise/team 사용자의 OAuth credentials 에 user:inference scope 누락 시 server-managed settings 정책 미적용 수정
• /clear 이후에도 터미널 탭 제목 리셋 안 되던 문제 수정
• /rename 의 세션 제목 칩이 permission/dialog 활성 중 사라지던 문제 수정
• 서브에이전트 실행 중 prompt 아래 agent panel 이 가려지던 회귀(2.1.122) 수정
• 외부 에디터 핸드오프(Ctrl+G) 가 prompt 위쪽 대화 히스토리를 비우던 문제 수정
• /context 가 ASCII 시각화 그리드를 대화에 덤프해 호출당 ~1.6k 토큰 낭비하던 문제 수정
• API 1시간 prompt cache TTL 이 silently 5분으로 다운그레이드되던 문제
• /branch 성공 메시지에 새 브랜치 세션 id 가 포함되도록 (resume 용)
• 1-hour prompt cache 가 silently 5 minutes 로 downgrade 되던 회귀 수정
• VSCode /clear 가 대화 컨텍스트·표시된 transcript 를 안 지우던 문제 수정

2.1.128

• bare /color (인자 없음) — 랜덤 세션 컬러 선택
• /mcp 가 연결된 서버의 도구 수 표시 + 0 도구로 연결된 서버 플래그
• --plugin-dir 가 .zip 플러그인 아카이브도 허용
• --channels 가 console (API key) 인증과 동작 — managed settings 가진 console org 는 channelsEnabled: true 설정 필요
• /model picker — Opus 4.7 중복 항목 통합, 현재 Opus 가 "Opus 4.7" 대신 "Opus" 로 표시
• 🚨 서브프로세스(Bash, hooks, MCP, LSP) 가 OTEL_* 환경변수 상속 차단 — Bash 로 실행한 OTEL 계측 앱이 CLI 의 OTLP endpoint 로 송신되던 문제
• 🚨 MCP workspace 가 예약 서버명 — 동명 기존 서버는 경고 후 스킵
• MCP 서버 재연결 시 모든 도구명을 대화에 flood 하지 않음 — 서버 prefix 로 요약
• SDK 호스트가 Bash 권한 prompt 에 영구 localSettings 제안 받음 → "Always allow" 가 .claude/settings.local.json 에 기록
• EnterWorktree 가 로컬 HEAD 에서 새 브랜치 생성 (이전: origin/<default-branch>) — 미푸시 커밋 유실 해결
• Auto mode classifier 가 평가 불가일 때 힌트 추가 (retry, /compact, --debug)
• focus mode 가 새 prompt 제출 시 직전 응답 일시 디밍하던 문제 수정
• claude -p 에 매우 큰 입력(>10 MB) 파이프 시 crash loop 수정
• /plugin Components 패널이 --plugin-dir 로드 플러그인에 "Marketplace 'inline' not found" 표시하던 문제
• MCP 도구 결과가 서버가 structured content + content blocks 둘 다 반환할 때 이미지 누락되던 문제
• 1M-context 모델 세션이 작은 autocompact window 로 실제 API limit 전에 "Prompt is too long" 차단되던 문제
• 병렬 셸 도구 호출 — 실패한 read-only 명령(grep, git diff, ls) 이 sibling 호출을 cancel 안 함
• Bedrock 기본 모델이 region-appropriate prefix 대신 global.* 로 resolve 되던 문제
• vim 모드 NORMAL 의 Space 가 표준 vi/vim 동작(커서 우측 이동) 으로 수정
• 🚨 CLAUDE_CODE_SHELL_PREFIX 설정 + 공백/메타문자 인자 시 MCP stdio 서버가 corrupted args 받던 버그 수정
• 서브에이전트 progress summary 가 prompt cache 누락(~3× cache_creation 증가) 수정
• /plugin update 가 npm-sourced 플러그인 새 버전을 감지 못 하던 문제 수정
• headless --output-format stream-json 의 init.plugin_errors 에 --plugin-dir 로드 실패 포함

---

액션 아이템

• stdio MCP 서버 운영자 → 2.1.132 즉시 적용. 이전 버전들은 비프로토콜 stdout 출력으로 메모리 10GB+ 증가 위험
• 사내 게이트웨이 사용자 (ANTHROPIC_BASE_URL) → 2.1.129+ 부터 /model 자동 모델 발견이 꺼짐. 환경변수 CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY=1 추가
• MCP 서버명에 workspace 사용 중인 환경 → 사전 개명 (2.1.128 부터 예약, 경고 후 스킵)
• OTEL 계측 앱을 Bash 도구로 실행하던 환경 → 2.1.128 부터 OTEL_* 상속 차단. 명시적 환경변수 주입 필요한지 점검
• enterprise/team 관리 정책 사용 환경 → 멤버 OAuth credentials 에 user:inference scope 있는지 확인 (없으면 managed-settings 미적용)
• Bash(mkdir *) / Bash(touch *) 등 in-project allow 규칙 사용 → 2.1.129 이전 버전은 미적용. 업그레이드
• deniedMcpServers 로 차단 정책 운영 → 대소문자 섞인 호스트네임 매칭 우회 가능성 있던 버그(2.1.129 수정) 검토
• EnterWorktree 자동화 스크립트 → 2.1.128 부터 로컬 HEAD 기준. 이전 기대 동작(origin/default) 의존 여부 점검
• VS Code 확장이 Windows 에서 동작 안 했다면 → 2.1.131+ 로 업그레이드 (핫픽스)

업데이트 방법

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

# 네이티브 설치 — 즉시 업데이트
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 문서 참고.