🟢 🏥 실무 게시일: · 3 분 읽기 ·

Claude Code v2.1.205: 세션 보안, 버그 수정, 400MB RAM 절약

에디토리얼 일러스트: Anthropic Claude Code v2.1.205 CLI 개발 도구 신규 릴리스 및 개선 사항

Anthropic이 2026년 7월 8일 Claude Code v2.1.205를 출시했다. 세션 트랜스크립트 파일 조작을 차단하는 새로운 보안 규칙, 자동으로 실패하던 JSON 및 Windows worktree 버그 수정, 그리고 이진 파일을 메모리 대신 디스크로 직접 스트리밍하는 자동 업데이터 최적화로 최대 400MB RAM이 절약된다.

🤖

이 기사는 AI가 1차 출처를 기반으로 생성했습니다.

Claude Code v2.1.205가 2026년 7월 8일 21:22 UTC에 출시되었으며, 여러 버그 수정, 보안 개선, 그리고 메모리 제한 환경에서 작업하는 사용자에게 반가운 최적화 하나를 담고 있다.

새로운 보안 규칙: 세션 트랜스크립트 보호

이번 릴리스에서 가장 주목할 만한 변경 사항은 활성 세션의 트랜스크립트 파일 조작 시도를 차단하는 auto-mode의 새로운 규칙이다. 트랜스크립트는 전체 대화 및 명령 흐름을 기록한다. 이 파일을 보호함으로써 악성 콘텐츠나 손상된 외부 의존성이 이전 작업 기록을 소급하여 수정하거나 세션 컨텍스트에 허위 명령을 삽입하려는 시나리오를 방지한다.

멈춰 있던 백그라운드 에이전트는?

백그라운드 에이전트가 세션 재개 후 더 이상 「failed」 또는 「completed」 상태에 멈춰 있지 않는다. 이는 백그라운드 에이전트가 「죽은」 것처럼 보였지만 시스템이 이를 해제하지 않던 장기 개발 워크플로에서 특히 불편했던 문제였다. 또한, 백그라운드 작업 알림이 이제 사람의 입력이 없었음을 명확히 표시하여 에이전트가 모니터링되지 않는 동안 실제로 무엇을 했는지를 사용자가 더 정확히 파악할 수 있게 한다.

일상적인 작업에 영향을 미쳤던 버그 수정

여러 수정 사항이 가시적인 경고 없이 발생할 수 있어 오랫동안 눈에 띄지 않을 수 있었던 시나리오와 관련된다.

format 키워드가 있는 JSON 스키마는 지금까지 지정된 스키마를 올바르게 적용하는 대신 비구조화된 출력을 자동으로 반환했다. 도구가 작동하는 것처럼 보였지만 실제로는 경고나 오류 없이 구조를 우회하고 있었다. v2.1.205에서는 format 키워드가 있는 스키마가 이제 완전히 올바르게 수용되고 처리된다.

에이전트 활성 작업 중에 Claude에 전송된 메시지는 에이전트가 당시 --max-turns 한도에 도달했을 경우 손실되었다. 이제 에이전트가 턴을 완료해도 메시지가 올바르게 보존되고 처리된다.

Windows 사용자는 NTFS 정션 포인트와 관련된 특정 동작이 수정된 혜택을 받는다. worktree 제거가 동일한 경로를 가리키는 정션이 존재할 때 대상 디렉터리 외부의 파일을 더 이상 삭제하지 않는다. 이는 복잡한 Windows 개발 환경에서 의도치 않은 파일 손실을 초래할 수 있었다.

자동 업데이트 최적화: 최대 RAM 약 400MB 절감

지금까지 자동 업데이트 메커니즘은 디스크에 기록하기 전에 전체 이진 파일을 작업 메모리에 다운로드했다. 새로운 구현은 다운로드가 시작되는 즉시 이진 파일을 디스크로 직접 스트리밍하여 업데이터의 최대 RAM 소비량을 약 400MB 줄인다. 메모리 리소스가 제한된 시스템이나 Claude Code가 다른 도구와 병렬로 실행되는 환경에서는 구체적이고 측정 가능한 이점이 된다.

에이전트 목록 표시 및 /doctor 명령 개선

에이전트 목록 표시에 색상이 적용된 상태 표시와 자동 생성된 제목이 추가되었다. 목록의 각 에이전트에는 이제 여러 병렬 에이전트 환경에서 탐색을 용이하게 하는 간단한 설명 텍스트가 표시된다.

/doctor 명령이 환경 설정 확인을 위한 본격적인 진단 도구로 확장되었다. 몇 가지 기본 확인만 제공하던 이전과 달리, 이제는 도구 작동에 영향을 미치는 구성, MCP 서버, 인증 및 기타 구성 요소에 대한 포괄적인 개요를 제공한다.

이 외에도 에이전트 표시에서 헤더 잘림 현상이 수정되었고, Windows에서 작업 디렉터리가 삭제되거나 마운트 해제된 경우의 시작 충돌이 해결되었으며, 이전에 다른 유효한 서버의 시작을 차단하던 잘못된 LSP 플러그인 서버 초기화 문제도 수정되었다.

결론

v2.1.205는 스타일 업데이트가 아닌 기술적 업데이트이다. 프로덕션 워크플로에서 도구 신뢰성에 영향을 미쳤던 자동 실패 오류를 수정하고, 세션 트랜스크립트 보안을 강화하며, 업데이트 시 메모리 점유량을 줄인다. 복잡한 worktree 설정을 사용하는 Windows 사용자, format 키워드가 있는 JSON 스키마를 사용하는 사용자, 또는 장기 세션에서 백그라운드 에이전트에 의존하는 사용자는 이번 릴리스에서 직접적인 혜택을 얻을 것이다.

자주 묻는 질문

Claude Code v2.1.205의 새로운 보안 규칙은 무엇인가?
새로운 auto-mode 규칙이 활성 세션의 트랜스크립트 파일 조작 시도를 자동으로 차단하여, 대화 기록에 대한 무단 수정이나 허위 명령 삽입을 방지한다.
새로운 자동 업데이터 시스템은 RAM을 얼마나 절약하는가?
자동 업데이터가 이제 메모리에 버퍼링하는 대신 이진 파일을 디스크로 직접 스트리밍하여, 업데이터의 최대 RAM 사용량을 약 400MB 줄인다.
v2.1.205에서 Windows 사용자에게 무엇이 달라졌는가?
동일한 경로를 가리키는 NTFS 정션 포인트가 존재할 때 worktree 제거가 대상 디렉터리 외부의 파일을 삭제할 수 있었던 버그가 수정되었다.