Claude Code v2.1.302 — idle compaction에 스위치가 달리고, 클라이언트 분류기 모델도 선택합니다
어제(299)의 idle compaction에 정식 스위치가 달렸습니다. v2.1.302는 비용·컨텍스트 통제의 후속 마무리와, Claude Design 독립 앱이 12월 14일 종료된다는 제품 공지가 함께 담긴 정비 릴리스입니다.
한마디로 말하면, 클라이언트 측 auto mode 분류기의 모델을 직접 선택할 수 있게 됐고, idle compaction을 /config에서 끄고 켤 수 있게 된 — 통제권 정리 업데이트입니다.
idle compaction 완성 — 스위치와 안내
299에서 도입한 idle compaction이 /config에 "Idle compaction" 행으로 정식 편입됐습니다. 끄거나 다시 켤 수 있고, idle compaction 후 표시되는 안내에도 끄는 방법이 명시됩니다. 비용 최적화 기능이 "조용히 작동"에서 "명시적으로 통제"로 정착한 단계입니다. 함께 들어온 CLAUDE_CODE_AUTO_MODE_MODEL은 클라이언트 측 auto mode 분류기가 쓰는 모델을 선택하는 옵션입니다 — 서버 측 auto mode(278)에는 영향을 주지 않습니다. 분류기는 가볍게(Haiku 5.5), 작업은 무겁게(Sonnet/Opus 5.5) 같은 비용 튜닝이 가능해진 것입니다.
안정성·메모리 — 128MB 이미지 거부와 캐시 미스 픽스
안전 픽스가 눈에 띕니다. Read tool이 어떤 크기든 이미지로 보이는 파일(파이프·디바이스 포함)을 통째로 메모리에 올릴 수 있었던 문제를 막아, 128MB 이상 이미지 소스는 거부합니다. 또 ① turn 종료가 compaction 도중 "Prompt is too long" 에러를 내던 문제, ② 세션 중 Vertex·Bedrock으로 전환 시 "Extra inputs are not permitted" 실패, ③ 세션 도중 추가된 tool이 ToolSearch·compaction 뒤 다시 로드될 때 프롬프트 캐시 미스가 나던 문제, ④ 게이트웨이가 anthropic/claude-opus-4-1 같은 접두사로 Opus를 지칭할 때 /autocompact·/effort가 잘못된 모델에 저장되던 문제까지 정리됐습니다. git이 reftable ref 형식일 때 플러그인 마켓플레이스가 매번 재클론되고 버전이 "unknown"으로 보이던 문제도 고쳐졌습니다.
Claude Design 종료 공지 — 12월 14일
/design-sync와 /design-login에 안내가 추가됐습니다. 독립 Claude Design(claude.ai/design)이 2026년 12월 14일 종료됩니다. 디자인 워크플로우를 Design 앱으로 운영하던 사용자는 이전 계획을 세워야 합니다. 이 밖에 PowerShell tool이 플러그인 bin/ 폴더의 명령을 못 찾던 문제, rg·grep 등이 0건을 찾을 때 파이프된 Select-Object가 에러로 처리하던 문제, claude plugin 서브커맨드가 설정 쓰기 완료 전 종료해 변경 유실이나 .tmp 파일 잔존을 일으키던 문제도 픽스됐습니다.
실전에서 어떻게 쓸까?
비용 통제 삼종 세트를 정리하면: ① /config → Idle compaction 상태 확인(299), ② CLAUDE_CODE_AUTO_MODE_MODEL로 분류기 모델 지정, ③ OTel의 cache_creation_5m/1h_tokens(300)로 캐시 회계 점검. Claude Design 사용자는 12월 14일 종료 전 마이그레이션이 필요하고, reftable 기본 설정을 쓰는 git 사용자는 플러그인 마켓플레이스 동작이 이 버전에서 정상화됩니다.
마무리로 — 300번째 이후의 릴리스들이 공통적으로 다루는 주제는 통제권의 명문화입니다. 컴팩션도, 분류기도, 어트리뷰션도 — 이제 사용자와 관리자가 끄고 켜는 선택지로 제공됩니다. 자동화가 늘어날수록 그 스위치의 정리가 곧 제품 품질이라는 방향성이 뚜렷한 한 주였습니다.
출처: https://github.com/anthropics/claude-code/releases/tag/v2.1.302
태그: AI Claude Claude Code 개발도구