2026년 7월, Claude Code의 v2.1.199가 출시되었습니다. 이번에는 신기능보다는 안정성 강화에 중점을 둔 릴리스로, 특히 멀티 에이전트(Multi-agent, 서브 에이전트) 운용 시의 신뢰성과 관련된 수정 사항이 많이 포함되어 있습니다.

그중에서도 놓쳐서는 안 될 부분은 Linux 환경에서 발생하던 "백그라운드 에이전트 데몬(Daemon)이 약 50초마다 모든 에이전트를 강제 종료하는" 중대한 결함의 수정입니다. 백그라운드 에이전트나 서브 에이전트를 일상적으로 활용하는 개발자는 본 기사에서 변경 사항을 확인한 후 업데이트할 것을 강력히 권장합니다.

또한, 슬래시 스킬(Slash skill)의 연속 지정 대응이나 일시적인 429 에러의 자동 재시도(Retry) 등, 일상적인 개발 경험을 개선하는 변경 사항도 포함되어 있습니다.

이번 릴리스를 영향 영역별로 정리하면 다음과 같습니다.

ID	제목	내용	대응 필요 여부
change-005	Linux 백그라운드 데몬의 반복적인 kill 수정	비정상 종료로 손상된 워커(Worker) 레코드가 남을 경우, 데몬이 자신과 모든 에이전트를 약 50초 주기로 계속해서 강제 종료하는 심각한 결함	업데이트 필요
change-004	서브 에이전트의 에러 처리 수정	레이트 리밋(Rate limit)/서버 에러로 중단된 서브 에이전트가 부분적인 결과를 반환하도록 수정. API 에러를 성공으로 오보고하는 문제도 수정	권장

ID	제목	개요
change-007	claude stop과 리스폰(Respawn)의 충돌 수정	정지 명령이 에이전트 재시작 처리와 충돌하여 조용히 무효화되는 문제를 해결
change-013	SendMessage의 이름 재사용 탐지	재스폰(Respawn)된 에이전트가 이전 이름을 재사용했을 때의 오전송을 탐지하고 재지정을 요구
change-009	유휴(Idle) 서브 에이전트 표시 개선	패널에서 사라지는 대신 펼칠 수 있는 요약 행으로 접어서 표시
change-010	/model /fast 실행 시의 알림	서브 에이전트 표시 중 실행이 리드 에이전트(Lead agent)에 적용된다는 점을 명시

ID	제목	개요
change-002	SSL 인증서 에러의 즉시 실패화	TLS 검사 프록시 등에 의한 에러를 재시도하지 않고 즉시 실패 처리하며, 대처 힌트를 표시
...	CLAUDE_CODE_RETRY_WATCHDOG 확장	기본 재시도 횟수를 300으로 상향하고, CLAUDE_CODE_MAX_RETRIES의 상한선인 15를 철폐

ID	제목	개요
change-001	슬래시 스킬의 연속 지정 대응	선두의 스킬 호출을 최대 5개까지 로드 (기존에는 1개만 가능)
...	exit code 2 발생 시 stderr가 트랜스크립트(Transcript)에 표시되도록 변경
change-016	설정 리셋 시 백업 생성	복구 다이얼로그에서의 리셋이 복구 불가능해지는 문제를 수정
change-017	Claude in Chrome의 재연결 페이지 문제 수정	여러 빌드/설정 디렉토리를 사용할 때 반복적으로 표시되는 현상을 해소
change-018	플랜 모드(Plan mode)의 브라우저 도구 권한 수정	상태 변경을 동반하는 조작에 확인 프롬프트를 표시하고, 읽기 전용 조작은 자동 허용
change-012	--dangerously-skip-permissions daemon의 오해석 수정	서브 명령어가 채팅 프롬프트로 오처리되는 문제를 수정
change-014	세션 재개 시 트랜스크립트 비대화 수정	새로운 메시지가 없어도 파일이 커지는 낭비를 해소
change-015	/color 설정 소실 수정	세션의 백그라운드화 조작 시 설정이 사라지는 현상을 해소
change-008	백그라운드 작업 표시의 여러 수정 사항	진행 정체, 저메모리 알림, 상태 플래핑(Flapping)을 수정
change-021	PR 링크 표시 간소화	claude agents에서의 PR 링크를 #N 표기로 단순화

📌 영향을 받는 사람

Linux에서 백그라운드 에이전트 (background agent)를 사용 중인 개발자: change-005의 대상입니다. 업데이트하지 않으면, 비정상 종료 후 데몬 (daemon)이 모든 에이전트를 반복적으로 kill(종료)할 가능성이 있습니다. 서브 에이전트 (sub-agent) / 멀티 에이전트 워크플로우 (multi-agent workflow)를 구성 중인 개발자: change-004, 007, 013 등 여러 신뢰성 수정의 혜택을 받습니다. CI/무인 실행 환경에서 Claude Code를 장시간 구동하는 개발자: change-020의 CLAUDE_CODE_RETRY_WATCHDOG 확장이 유용합니다. 기업 프록시 환경 (TLS 검사 포함)에서 Claude Code를 사용하는 개발자: change-002를 통해 에러 진단이 빨라집니다. macOS 호스트로 SSH 접속하여 백그라운드 에이전트를 사용하는 개발자: change-006 (v2.1.196의 리그레션 (regression) 수정)의 대상입니다.

⚠️ Breaking Change

파괴적 변경 (Breaking Change)은 없으나, change-005는 방치할 경우 실운영상의 중대한 지장 (모든 에이전트의 강제 종료 루프)으로 이어질 수 있으므로, 실질적으로 필수 업데이트로 취급해야 합니다.

Before (v2.1.198까지): 맨 앞의 스킬 (skill)만 로드됨

# skill-b가 무시되고, skill-a만 로드됨
> /review-code /summarize-diff 이 PR을 리뷰하고 요약해줘

After (v2.1.199~): 맨 앞의 연속된 스킬을 최대 5개까지 로드

# review-code와 summarize-diff가 모두 로드되어,
# 1개의 명령어로 조합 워크플로우 실행 가능
> /review-code /summarize-diff 이 PR을 리뷰하고 요약해줘

Before: CLAUDE_CODE_MAX_RETRIES는 최대 15회까지만 설정 가능

export CLAUDE_CODE_MAX_RETRIES=15 # 이 이상은 무시됨
claude -p "장시간 자동 태스크 실행"

After: CLAUDE_CODE_RETRY_WATCHDOG를 활성화하면 상한이 철폐되며, 기본값도 300회로 변경

# 비 캐파시티 (non-capacity) 계열의 일시적 에러에 대해 기본 300회 재시도
# CLAUDE_CODE_MAX_RETRIES의 15회 상한도 철폐됨
export CLAUDE_CODE_RETRY_WATCHDOG=1
...

💡 Tips

CI 환경이나 야간 배치 (batch) 등 "사람이 보지 않는 사이에 장시간 구동하는" 케이스에서는, CLAUDE_CODE_RETRY_WATCHDOG를 활성화해 두면 일시적인 서버 에러로 인해 태스크 전체가 실패할 리스크를 크게 줄일 수 있습니다.

Before: 레이트 리밋 (rate limit)이나 서버 에러로 중단된 서브 에이전트는, 성과를 반환하지 않고 조용히 실패함

After: 중단되더라도, 그때까지의 부분적인 성과와 정확한 에러 정보가 반환되도록 개선

Claude Code v2.1.199는 화려한 신기능보다는 멀티 에이전트 운용의 신뢰성에 초점을 맞춘 릴리스입니다. 요점을 정리하면 다음과 같습니다.

최우선 사항: Linux에서 백그라운드 에이전트의 강제 종료 루프가 발생하는 버그 (change-005) 수정. 해당 환경에서는 신속한 업데이트 권장
멀티 에이전트 신뢰성 향상: 서브 에이전트의 부분 결과 반환 및 에러 정확 보고 (change-004), claude stop과의 충돌 수정 (change-007), SendMessage 오전송 탐지 (change-013) 등
무인 실행의 내결함성 (fault tolerance) 강화: CLAUDE_CODE_RETRY_WATCHDOG의 재시도 상한 철폐 (change-020), 일시적 429 에러의 자동 재시도 (change-019)
신기능: 슬래시 스킬 (slash skill) 최대 5개 연속 지정 대응 (change-001)

• 그 외 SSL 인증서 에러의 즉시 실패 처리, 설정 리셋 시 백업 생성 등 세세한 안정성 및 안전성 개선이 다수 포함됨

백그라운드 에이전트나 서브 에이전트를 활용한 워크플로우를 구성 중인 개발자일수록 이번 업데이트의 혜택이 클 것입니다. 아직 업데이트하지 않았다면, 특히 Linux 환경 사용자는 우선적인 대응을 검토하시기 바랍니다.