Claude Code v2.1.302: 자동 모드 모델 및 유휴 압축

Claude Code v2.1.302가 출시되었습니다. 대부분 버그 수정 릴리스이지만 알아둘 만한 새 설정 두 가지와 플러그인, MCP, Windows 파일 쓰기 관련 수정 사항이 다수 포함되어 있습니다.

새로운 기능

CLAUDE_CODE_AUTO_MODE_MODEL로 클라이언트 측 자동 모드 분류기가 사용할 모델을 선택할 수 있습니다. 서버 측 자동 모드에는 영향을 주지 않으며, 이는 별개의 코드 경로입니다.
/config에 유휴 압축(Idle compaction) 행이 추가되어 유휴 압축을 끄거나 다시 켤 수 있습니다. 유휴 압축 후 표시되는 알림에 이제 끄는 방법도 안내됩니다.
/design-sync와 /design-login이 이제 독립형 Claude Design(claude.ai/design)이 2026년 12월 14일 종료된다는 알림을 출력합니다.

주요 수정 사항

Read 도구 메모리 폭증: Read 도구가 이미지처럼 보이는 파이프나 장치를 포함해 크기에 상관없이 모든 이미지 파일을 메모리에 전부 로드하던 문제를 수정했습니다. 이제 128MB를 초과하는 소스는 거부합니다.
Vertex / Bedrock 세션 중 전환: 세션 중 제공자를 전환한 후 요청이 diagnostics: Extra inputs are not permitted 오류로 실패하던 문제를 수정했습니다.
게이트웨이 접두사가 붙은 Opus: 게이트웨이가 Opus 4 또는 4.1에 접두사를 붙인 경우(예: anthropic/claude-opus-4-1) /autocompact와 /effort가 잘못된 모델에 저장되던 문제를 수정했습니다.
프롬프트 캐시 미스: 세션 중에 추가되어 ToolSearch 또는 압축 후 재로드된 도구가 더 이상 프롬프트 캐시를 무효화하지 않습니다.
플러그인 하위 명령: claude plugin 및 관련 명령이 대기 중인 설정/구성 쓰기가 완료되기 전에 종료되어 변경 사항이 유실되거나 .tmp 파일이 남던 문제를 수정했습니다.
reftable 참조 형식: git이 기본적으로 reftable을 사용할 때 플러그인 마켓플레이스가 새로고침할 때마다 다시 복제되고 새로 설치된 git 플러그인이 버전 unknown으로 표시되던 문제를 수정했습니다. 또한 reftable 체크아웃을 재사용하는 자체 호스팅 러너에서 발생하던 bad object refs/heads 페치 오류도 수정했습니다.
PowerShell 도구: 이제 플러그인의 bin/ 폴더에서 명령을 찾으며, 아무것도 찾지 못한 검색(rg, grep, findstr, git grep)이 Select-Object나 다른 형식 지정 cmdlet으로 파이프될 때 더 이상 오류를 발생시키지 않습니다.
MCP 프로토콜 2026-07-28: 해당 버전을 협상하면서 resultType, ttlMs, cacheScope를 누락한 서버가 더 이상 도구를 0개로 표시하거나 모든 호출이 실패하지 않습니다.
크레딧 청구 모델: 크레딧으로 청구된 응답 후에는 프롬프트 제안이 건너뛰어져, 플랜에서 크레딧으로만 지불하는 모델에 사용 크레딧을 낭비하지 않게 되었습니다.
OTel: 대부분의 자동 모드 분류기 차단에 대해 tool_decision 이벤트에서 classifier_category가 누락되던 문제를 수정했습니다. 또한 OTEL_LOGRECORD_ATTRIBUTE_COUNT_LIMIT가 낮을 때 새로운 tool_decision 속성이 tool_use_id, tool_source, tool_parameters를 밀어내던 문제도 수정했습니다.
Windows exFAT/FAT32: 해당 드라이브의 프로젝트에서 모든 파일 쓰기가 거부되거나 프롬프트가 표시되던 문제를 수정했습니다. --plugin-dir로 시작한 세션도 포함됩니다.
워크트리 격리: 잘못된 .git 파일이 존재하지 않는 디렉터리를 가리킬 때 git 2.56 이상에서 워크트리 생성 또는 재개를 거부하던 문제를 수정했습니다.

개선 사항

플러그인 명령 및 에이전트 파일 로드에 필요한 파일 시스템 호출이 크게 줄었습니다. Windows에서 가장 큰 효과를 보이며, 플러그인을 많이 활성화한 경우 시작 시 체감할 수 있습니다.
서버 측 자동 모드: 안전 검사에 비해 너무 긴 대화는 이제 검사된 모든 도구 호출이 거부되는 대신 압축됩니다.
LLM 게이트웨이 없이 다른 폴더에서 다시 열린 백그라운드 세션이 이제 잘린 메시지 대신 이유를 설명합니다.

Windows에서 플러그인과 함께 Claude Code를 사용하거나, Anthropic API와 Vertex/Bedrock을 세션 중에 전환한다면 이번 버전을 적용할 가치가 있습니다.

📖 Read the full source: GitHub Claude-Code