Claude Code v2.1.325 — zstd 보안 수정, 게이트웨이는 이제 컴팩션합니다
v2.1.325의 첫 줄은 보안입니다. zstd 압축 응답을 디코딩하는 방식의 보안 이슈가 수정됐습니다 — 세부 공개는 없지만 목록 최상단의 'security issue' 분류가 말하는 바는 명확합니다.
한마디로 말하면, 압축 응답 파이프라인의 보안 구멍을 메우고, 서드파티 게이트웨이에서 매 턴 컨텍스트 에러로 죽던 세션을 컴팩션으로 살리는 정밀 수정이 중심인 릴리스입니다.
zstd 디코딩 — 압축 파이프라인의 재점검
압축 응답 처리는 이번 달 두 번째입니다. 310이 "압축 응답이 잘리거나 손상됐을 때 네트워크 요청이 멈추던" 문제를 고쳤고, 325는 그 디코딩 경로 자체의 보안 이슈를 닫았습니다 — 응답을 압축 해제하는 코드는 신뢰할 수 없는 입력을 펼치는 자리라, 여기서의 결함은 일반 버그와 등급이 다릅니다. 프록시·CDN 뒤에서 Claude Code를 쓰는 환경이라면 이번 버전이 보안 업데이트로 분류됩니다.
게이트웨이의 '매 턴 에러'가 컴팩션으로 바뀌다
실무에서 가장 체감 큰 수정은 이것입니다. 수많은 서드파티 게이트웨이와 Foundry에서 세션이 매 턴 컨텍스트 길이 에러로 멈추고, 컴팩션은 작동하지 않던 문제가 고쳐졌습니다. 게이트웨이가 모델의 실제 컨텍스트 한도를 정확히 보고하지 않으면 Claude Code는 언제 압축해야 하는지 몰라서 — 매 턴마다 같은 벽에 부딪히던 것이죠. 305(Vertex/Bedrock 회귀)→310(압축 응답)→314(게이트웨이 effort)→325(컴팩션)로 이어지는 게이트웨이 신뢰성 시리즈의 연장선입니다.
서브에이전트의 모델별 정확성
서브에이전트 관련 수정 2건이 짝을 이룹니다. 모델 설정이 opusplan이나 haiku일 때 자체 모델을 가진 서브에이전트가 플랜 모드 모델로 강제 이동하던 것, 그리고 다른 모델을 쓰는 서브에이전트가 메인 세션 모델 기준으로 파일 읽기와 MCP 결과 크기를 잡아 과소·과대 샘플링하던 것 — 서브에이전트 팬아웃이 일상이 된 지금, 모델별 컨텍스트 창 크기가 다르다는 사실을 설정 체계가 존중하게 된 것입니다.
세션 무결성 — 비정상 종료와 유실 방지
비정상 종료 후 재개된 세션에서 최근 턴들이 사라지던 문제, 작업 디렉터리가 삭제된 뒤 셸 명령이 시작 디렉터리에서 실행되던 것(이제 메시지와 함께 실패), 승인된 플랜 편집이 plansDirectory에 저장 실패 시 기본 폴더에 저장하고 위치·사유를 경고하도록 바꾼 것 등이 이어집니다. 조직 정책이 요청을 차단했을 때의 에러 아래에는 이제 /rewind로 메시지를 고치거나 /clear로 계속하는 방법이 안내됩니다 — 차단을 벽으로만 두지 않고 회로로 만든 것이죠.
실전 가이드
서드파티 게이트웨이·Foundry 사용자는 즉시 업데이트 1순위입니다 — 매 턴 컨텍스트 에러는 긴 세션의 생산성을 통째로 먹는 버그였습니다. 프록시 뒤 운영 환경은 보안 수정 취지에 따라 서둘러 적용하고, WSL·네트워크 경로 사용자는 321, 노트북 사용자는 312에서 이미 비슷한 정리를 받았다는 점도 함께 기억하세요.
마무리로 — 322의 한 줄(Vertex fast mode)과 325의 다다익선(정밀 수정)을 나란히 두면, 릴리스 리듬이 기능 스프린트와 안정화 스프린트를 번갈아 도는 성숙기 리듬임이 보입니다. zstd 수정이 어떤 취약점이었는지 후속 공개가 나오면 다시 다루겠습니다.
출처: https://github.com/anthropics/claude-code/releases/tag/v2.1.325
태그: AI Claude Claude Code 개발도구