Claude Code v2.1.203 — 백그라운드 에이전트 대대정비, 15개 버그 수정

zaq · 2026년 7월 9일 · 4 min read

Claude Code v2.1.203에서 백그라운드 에이전트와 워크트리 관련 버그가 대거 수정됐습니다. CI/CD나 장시간 실행 환경에서 겪던 끊김, 멈춤, 경로 꼬임 문제가 한꺼번에 해결됐네요.

핵심 변화 한 줄 요약

백그라운드 세션 안정성, 워크트리 격리, 성능 회귀 수정이 주요 내용입니다. 그중에서도 "세션이 멋대로 죽거나 멈추는" 문제가 대부분이라, 자동화에 의존하는 팀에게 체감 효과가 큰 업데이트입니다.

이번 릴리스의 가장 큰 테마입니다. 그동안 백그라운드 에이전트가 의외로 자주 끊기거나 먹통이 됐는데, 원인별로 꼼꼼히 잡았습니다.

세션 토큰 만료 → 데몬의 토큰이 낡으면 세션이 attach, reply, stop 전부 안 먹는 현상이 있었습니다. 이제 자동 복구됩니다.
macOS 저메모리 오탐지 → 2.1.196에서 회귀된 버그로, 백그라운드 세션 전환 시 15~20초씩 멈추던 문제를 수정했습니다.
데몬 자동 업데이트 실패 → 조용히 모든 백그라운드 세션을 죽이던 치명적인 케이스도 잡았습니다.
PATH / BASE_URL 누락 → Windows에서 데몬의 낡은 PATH를 물려받아 도구가 안 보이거나, ANTHROPIC_BASE_URL이 무시돼 API 키가 엉뚱한 엔드포인트로 가던 문제도 해결됐습니다. 프록시 환경에서 특히 골치 아팠을 텐데 드디어 정상입니다.

추가로 작업 디렉토리가 삭제되거나 파일로 바뀌면 에이전트가 crash loop에 빠지던 현상도, 이제 명확한 에러로 한 번만 실패하고 끝납니다.

Git worktree 기반 서브에이전트 격리도 많이 다듬졌습니다.

로그인 만료 경고 — 세션이 끊기기 전에 미리 재인증하라고 알려줍니다. 백그라운드 작업이 중간에 끊기는 걸 사전에 방지할 수 있어요.
수동 권한 모드 표시 — 푸터에 ⏸ 배지가 표시돸으로써, 현재 모드가 항상 눈에 보입니다.
MCP roots/list 지원 — 세션의 추가 작업 디렉토리가 MCP 서버에 노출되고, 변경 시 roots/list_changed 알림이 전송됩니다.
메모리·CPU 회귀 수정 — 매 턴마다 전체 트랜스크립트를 재분석하던 context-usage 표시기의 비효율을 잡았습니다. 긴 세션일수록 체감됩니다.

버그픽스 위주의 릴리스지만, 백그라운드 에이전트와 워크트리를 실전에서 쓰는 팀에게는 그동안 쌓인 스트레스가 한 번에 풀리는 업데이트입니다. 특히 CI/CD 파이프라인에서 안정성이 확 올라갈 것 같네요.