Claude Code v2.1.302 — idle compaction에 스위치가 달리고, 클라이언트 분류기 모델도 선택합니다
AI

Claude Code v2.1.302 — idle compaction에 스위치가 달리고, 클라이언트 분류기 모델도 선택합니다

zaq · · 4 min read

어제(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 개발도구