Claude Code v2.1.311 — 200K 넘으면 끊기지 않는다, 자동 컴팩션 이어달리기
AI

Claude Code v2.1.311 — 200K 넘으면 끊기지 않는다, 자동 컴팩션 이어달리기

zaq · · 3 min read

v2.1.311의 주인공은 단 한 줄입니다. 표준 컨텍스트 세션이 200K 토큰을 넘기며 "Usage credits required for 1M context"로 멈추던 문제가 수정됐고, 이제 Claude Code는 대화를 자동 컴팩션한 뒤 이어서 진행합니다.

한마디로 말하면, 긴 세션의 '유료 벽'을 소프트 랜딩으로 바꾼 릴리스입니다. 1M 컨텍스트 크레딧이 없어도 작업이 죽지 않습니다.

200K 벽이 사라진 방식

이전 동작은 냉정했습니다. 표준 컨텍스트 세션의 요청이 200K를 넘는 순간 세션이 에러로 정지했죠. 이제는 컴팩션이 개입해 대화를 압축하고 흐름을 이어갑니다. 무인 장기 작업 — 대규모 리팩터링, 문서 한바퀴 순회 — 에서 가장 흔한 사망 지점이었던 만큼, 체감은 "세션이 덜 죽는다"로 직결됩니다. 함께 고쳐진 연관 항목도 컨텍스트 신뢰성입니다. 자동 컴팩션 직후 세션 안에서 편집한 MEMORY.md·CLAUDE.md의 오래된 내용을 보던 문제가 잡혀, 메모리 기반 에이전트가 "방금 고친 기억을 잊는" 현상이 사라졌습니다.

장기 실행의 정확성 — 훅·워크트리·기록

서브에이전트를 돌리는 팀을 위한 수정이 밀집했습니다. SubagentStop 훅이 종료 시 1번이 아니라 실행 중인 서브에이전트마다 2분에 한 번씩 발화하던 문제(알림·자동화 오염의 원인), 서브에이전트의 격리 워크트리를 그 워크트리에서 아직 일하는 백그라운드 서브에이전트가 있는데도 제거하던 문제, 접속이 늦게 끝난 MCP 서버의 도구를 서브에이전트가 못 쓰던 문제가 닫혔습니다. 대용량 파일에서 Write·Edit가 최대 5초 멈추며 "0 lines changed"로 잘못 보고하던 것, MCP 리소스 응답 대기 중 인터럽트가 타임아웃까지 무시되던 것도 실사용 통증이었습니다.

실전 가이드 — 누가 지금 올려야 하나

200K를 자주 넘는 헤비 세션 사용자와 SubagentStop 훅으로 알림을 붙여둔 자동화라면 즉시 업데이트 대상입니다. 셀프호스티드 러너 운영자에게는 신규 옵션 --hold-idle-file·--max-hold-min이 추가돼, 호스트가 남긴 프로세스를 보고하는 동안 유휴 세션을 지정한 시간만큼 유지할 수 있습니다. 참고로 CLAUDE.md에 아주 긴 리스트 항목이 있으면 시작·파일 읽기마다 긴 프리즈가 걸리던 문제도 고쳐졌으니, 방대한 CLAUDE.md를 쓰는 모노레포 팀도 수혜입니다.

마무리로 — 306(불필요한 컴팩션 제거)→309(컴팩션 누수)→311(컴팩션으로 하드스톱 대체)로 이어진 흐름은 한 문장으로 요약됩니다. 컴팩션은 이제 장애가 아니라 안전망이라는 것. 1M 크레딧의 진짜 가치도 이번부터는 "끊기지 않아서"가 아니라 "압축 없이 정밀함을 유지하기 위한 것"으로 재정의됐습니다.

출처: https://github.com/anthropics/claude-code/releases/tag/v2.1.311

태그: AI Claude Claude Code 개발도구