🟢 🤝 에이전트 게시일: · 3 분 읽기 ·

Claude Code v2.1.203 — 세션 만료 경고, 더 작은 바이너리, 빠른 시작

편집 일러스트: 로그인 만료 수정과 세션 복구가 포함된 Claude Code v2.1.203

Anthropic이 7월 7일 Claude Code v2.1.203을 출시했습니다. 로그인 토큰 만료 경고, 정지된 백그라운드 세션 자동 복구, 약 7MB 바이너리 크기 감소가 포함됩니다. macOS 속도 저하와 서브 에이전트 동작을 방해하는 여러 버그도 수정되었습니다.

🤖

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

Anthropic은 2026년 7월 7일 UTC 21:06에 Claude Code 도구의 v2.1.203 버전을 출시했습니다. 이 업데이트는 백그라운드 세션 안정성, 시작 성능, 서브 에이전트 동작 수정에 초점을 맞춘 여러 개선 사항을 제공하며, 로그인 토큰이 만료되기 전에 사용자에게 경고하는 실용적인 새 기능도 포함됩니다.

토큰 만료가 왜 문제였나요?

이전까지 데몬 세션 토큰이 만료되면 백그라운드 세션이 영구적으로 응답하지 않게 되었습니다 — attach할 수 없고, 응답을 수락하지 않으며, stop 명령도 효과가 없었습니다. 사용자는 겉으로는 활성 상태로 보이지만 실제로는 정지된 세션으로 작업을 재개하려 할 때야 문제를 발견했습니다.

v2.1.203은 이 문제를 두 가지 방식으로 해결합니다. 첫째, 세션이 끊기기 전에 사용자가 재인증을 할 수 있도록 충분히 일찍 표시되는 로그인 자격증명 만료 경고가 추가되었습니다. 둘째, 만료된 토큰으로 이미 응답하지 않게 된 세션이 이제 자동으로 복구됩니다.

수정된 버그: macOS, 서브 에이전트, 컨텍스트 지표

이 버전에는 구체적이고 재현 가능한 문제를 해결하는 여러 수정 사항이 포함됩니다:

macOS 백그라운드 세션 열기 시 지연. macOS에서 백그라운드 에이전트 세션을 열거나 전환할 때 잘못된 저메모리 감지로 인해 15~20초 지연이 발생했습니다. 버그가 완전히 수정되었습니다.

워크트리 격리의 서브 에이전트. 워크트리 격리 환경에서 작동하는 서브 에이전트가 격리된 워크트리 대신 부모 체크아웃에서 명령을 자동으로 실행했습니다. 이 동작은 주 저장소에 원치 않는 변경을 초래할 수 있었습니다.

작업 재위임. 서브 에이전트가 작업을 계속하는 대신 전체 작업을 재위임하는 경향을 보였습니다. 이번 버전에서는 중단된 서브 에이전트가 완료한 작업이 올바르게 전달되어 중복 및 불필요한 반복이 줄어듭니다.

컨텍스트 사용량 지표. 컨텍스트 사용량 지표가 매 턴 후 전체 트랜스크립트를 다시 분석했으며, 이는 특히 긴 세션에서 눈에 띄는 성능 저하를 일으켰습니다. 이 저하가 수정되었습니다.

Bash “인수 목록이 너무 길다”. 많은 수의 git 워크트리가 있는 저장소에서 Bash 명령이 “인수 목록이 너무 길다” 오류와 함께 실패했습니다. 버그가 해결되었습니다.

성능 개선

바이너리 크기가 약 ~7MB 감소했으며 시작 메모리도 약 ~7MB 줄었습니다. 두 개선 모두 지연 로딩을 통해 달성되었습니다 — 이전에는 시작 시 로드되던 대용량 의존성이 이제 실제로 필요할 때만 로드됩니다. 결과적으로 시작 속도가 빨라지고 시작 직후 메모리 사용량이 줄어듭니다.

스트리밍 응답 중 라이브 프리뷰 업데이트가 더 반응적이 되었으며, 컨텍스트 사용량 지표가 더 이상 턴 사이에 불필요하게 CPU 자원을 소비하지 않습니다.

v2.1.203의 기타 변경 사항

이번 버전에는 몇 가지 소소하지만 유용한 변경 사항도 있습니다:

  • 수동 권한 모드에서 푸터에 회색 일시정지 배지가 추가되어 도구가 대기 상태임을 항상 시각적으로 확인할 수 있습니다.
  • 세션의 작업 디렉토리가 이제 변경 알림과 함께 MCP roots/list에 포함되어 작업 컨텍스트에 의존하는 MCP 서버와의 통합이 개선됩니다.
  • Windows에서 백그라운드 에이전트가 이제 디스패칭 셸에서 PATH를 올바르게 상속하여 에이전트 세션에서 도구를 사용할 수 없던 문제가 해결됩니다.
  • 왼쪽 화살표 키가 더 이상 백그라운드 작업 보기를 닫지 않습니다. 이제 닫으려면 Esc를 사용해야 합니다.

배경: 에이전트 안정성이 우선순위

v2.1.203의 변경 사항은 여러 연속 Claude Code 버전에서 볼 수 있는 패턴을 보여줍니다 — Anthropic이 여러 에이전트, 백그라운드 세션, 장기 작업으로 작업할 때 발생하는 안정성 문제를 체계적으로 해결하고 있습니다. 백그라운드 및 서브 에이전트 아키텍처가 개발자들이 Claude Code를 사용하는 방식의 점점 더 중심이 되고 있어, 해당 인프라의 버그가 수정 우선순위가 높습니다.

업데이트는 Claude Code 도구의 표준 업데이트 메커니즘을 통해 이용 가능합니다.

자주 묻는 질문

이전 버전에서 데몬 토큰이 만료되면 백그라운드 세션에 어떤 일이 일어났나요?
백그라운드 세션이 영구적으로 응답하지 않게 되었습니다 — attach, 응답, stop 명령에 반응하지 않았습니다. v2.1.203은 이러한 세션을 자동으로 복구합니다.
이번 버전에서 Claude Code 바이너리 크기가 얼마나 줄었나요?
바이너리는 약 7MB 작아졌으며, 대용량 의존성의 지연 로딩 덕분에 시작 메모리도 약 7MB 감소했습니다.
macOS에서 백그라운드 세션을 열 때 15~20초 지연의 원인은 무엇이었나요?
잘못된 저메모리 감지가 지연을 일으켰습니다. 이 버그는 이번 버전에서 수정되었습니다.