Claude Code v2.1.325가 2026년 11월 13일 공개됐습니다. 공식 릴리스 노트 기준으로 장시간 자동화와 대규모 프로젝트 하네스를 운영하는 팀이 주목해야 할 변경은 세 가지 핵심 수정과 샌드박스 기본값 변경입니다. 이 글은 공식 릴리스 문서와 변경 내역을 바탕으로 작성했으며, 독립적인 장시간 벤치마크는 포함하지 않았습니다.

핵심 수정 세 가지

1. 비정상 종료 후 세션 복구 시 최근 대화 턴 누락 수정

장시간 코딩 작업을 수행하다 터미널 강제 종료, 시스템 재시작, 메모리 부족 등으로 프로세스가 비정상 종료된 뒤 세션을 복구할 때, 직전 몇 번의 대화 턴과 도구 실행 결과가 세션 히스토리에 반영되지 않는 문제가 있었습니다.

에이전트는 직전 턴에서 어떤 파일을 수정했는지 알지 못한 채 작업을 재개하여 동일한 코드를 중복 수정하거나 잘못된 가정 위에 후속 명령을 실행하는 위험이 있었습니다. v2.1.325에서는 세션 이벤트 로그의 동기화 플러시(flush) 타이밍을 개선해 비정상 종료 시점 직전의 대화 턴까지 안정적으로 보존되도록 수정됐습니다.

2. 서브에이전트의 모델 컨텍스트 및 MCP 결과 크기 계산 오류 수정

메인 에이전트와 서브에이전트에 서로 다른 모델을 지정한 경우(예: 메인 세션은 Opus, 하위 태스크용 서브에이전트는 Sonnet이나 Haiku를 지정한 아키텍처), 서브에이전트가 수행한 파일 읽기나 Model Context Protocol(MCP) 도구 호출 결과의 크기 계산(sizing)이 서브에이전트의 모델이 아닌 부모 세션의 모델 컨텍스트 기준으로 잘못 계산되는 버그가 수정됐습니다.

또한 서브에이전트 설정 모델이 계획 모드 모델(opusplan 등)로 잘못 덮어씌워지는 현상도 해결됐습니다. 컨텍스트 윈도우 계산이 어긋나 불필요한 조기 압축(compaction)이 발생하거나 토큰 한도 초과 에러가 발생하던 구조적 결함이 해소된 것입니다.

3. zstd 압축 응답 디코딩 보안 취약점 패치

API 페이로드 및 세션 스트림 전송 효율을 위해 사용되는 Zstandard(zstd) 압축 응답을 디코딩하는 과정에서 잠재적인 보안 결함이 발견되어 수정 패치가 적용됐습니다. 릴리스 노트에는 구체적인 CVE 번호나 공격 벡터는 명시되지 않았으나, 악의적으로 조작된 압축 스트림을 처리할 때 발생할 수 있는 버퍼 이상 또는 비정상 디코딩 동작을 차단하는 패치입니다.

샌드박스 및 권한 기본값 변경

보그 수정 외에도 운영 정책과 관련된 중요한 기본값 변경이 포함됐습니다.

  • 샌드박스 내 Bash 실행 시 기본 권한 프롬프트 적용: macOS 및 Linux 샌드박스 환경에서 기존에는 Bash 명령이 프롬프트 없이 자동 실행되었으나, v2.1.325부터는 샌드박스 내에서도 기본적으로 승인 프롬프트를 거치도록 변경됐습니다. 무인 CI/CD 환경 등에서 이전처럼 무승인 실행을 유지하려면 설정 파일(~/.claude/settings.json)의 샌드박스 블록에 autoAllowBashIfSandboxed: true를 명시해야 합니다.
  • 스케줄 태스크 및 /loop 제약 강화: allowed-tools나 훅(hook)이 선언된 스킬을 실행할 때 사전에 permissions.allow에 등록되어 있지 않다면 반드시 사용자 승인을 요구합니다.
  • Git 워크트리 격리: 루트 프로젝트 외부의 신뢰되지 않은 디렉터리에서 읽기 전용 git 명령을 실행할 때 승인을 요청하며, 샌드박스 쉘에서 비인가 워크트리 조작(git worktree add, move, remove)이 차단됩니다.

실무 하네스 점검표

점검 항목 설정 및 확인 방법 기대 동작
세션 복구 안정성 임의 프로세스 kill 후 claude --resume 실행 직전 도구 실행 결과와 사용자 입력이 온전히 유지되는지 확인
서브에이전트 모델 격리 메인/서브에이전트 모델을 다르게 설정한 뒤 대량 MCP 출력 실행 서브에이전트 모델의 컨텍스트 한도 내에서 정상 처리되는지 확인
무인 자동화 파이프라인 sandbox.autoAllowBashIfSandboxed 값 점검 CI 파이프라인에서 예기치 않은 승인 대기로 블로킹되지 않는지 확인

출처: Claude Code v2.1.325 공식 릴리스.