Claude Code v2.1.199 릴리스 노트 살펴보기

안녕하세요. 이번 글에서는 Claude Code v2.1.199 릴리스 노트의 변경 사항을 정리합니다.

도입#

v2.1.199는 2.1.x 계열의 패치 릴리스입니다. 릴리스 노트에는 24개 항목이 올라와 있고, 이 중 대부분은 Fixed로 시작하는 버그 수정입니다. 이미 있던 동작의 안정성을 다듬는 변경이 중심이지만, UX 관점에서 꽤나 좋은 영향을 줄 수 있는 아래 두 가지 업데이트도 존재합니다.

• 이제 최대 5개의 스킬을 단일 프롬프트에서 로드할 수 있습니다.
• 병렬 workflow를 실행하던 도중 rate limit 에 걸려도 reset 이후 작업을 보다 안정적으로 시작할 수 있습니다.

아래에서는 24개 항목을 주제별로 묶어 정리합니다. 항목 이름·환경 변수·명령어는 릴리스 노트에 적힌 그대로 옮겼습니다.

스킬 실행#

• /skill-a /skill-b do XYZ처럼 슬래시 스킬을 여러 개 이어 붙여 호출하면, 이전에는 맨 앞 스킬 하나만 로드됐습니다. 이제는 앞쪽에 놓인 스킬을 최대 5개까지 모두 로드합니다.

네트워크 오류와 재시도#

• SSL 인증서 오류(TLS를 검사하는 프록시, NODE_EXTRA_CA_CERTS 누락, 만료된 인증서 등)가 나면 이전에는 재시도를 다 소진한 뒤에야 안내 메시지를 보여줬습니다. 이제는 곧바로 실패하면서 해결 힌트를 함께 표시합니다.
• API가 응답을 스트리밍하던 중간에 과부하(overloaded)나 서버 오류를 보내면, 이전에는 이미 받은 부분 응답까지 버려졌습니다. 이제는 받은 부분을 유지하고 "응답이 완결되지 않았다"는 안내를 붙입니다.
• 사용량 한도와 무관한 일시적 서버 rate-limit 오류(429)는, 이전에는 해당 턴을 실패 처리했습니다. 이제는 구독 사용자에 한해 백오프를 적용해 자동으로 재시도합니다.
• CLAUDE_CODE_RETRY_WATCHDOG가 용량 문제가 아닌 일시적 오류에 대한 기본 재시도 횟수를 300으로 올립니다. 또한 CLAUDE_CODE_MAX_RETRIES에 걸려 있던 상한 15를 없앱니다.

서브에이전트 결과 전달#

• rate limit이나 서버 오류로 중간에 끊긴 서브에이전트가, 이전에는 아무것도 남기지 않고 조용히 실패했습니다. 이제는 그때까지 한 작업(부분 결과)을 부모 에이전트에 돌려줍니다.
• 서브에이전트가 API 오류(예: 사용량 한도 도달)를 겪고도 성공한 결과처럼 보고하던 문제를 수정했습니다. 이제는 오류를 부모 에이전트에 그대로 알립니다.
• SendMessage가, 다시 생성된 에이전트가 이전 에이전트의 이름을 재사용했을 때 엉뚱한 대상으로 조용히 전달되던 문제를 수정했습니다. 이제는 이름이 어긋난 것을 감지하고 호출자에게 대상을 다시 지정하도록 요청합니다.
• 서브에이전트 화면을 보는 상태에서 /model이나 /fast를 입력하면, 이전에는 아무 설명 없이 리드(lead) 에이전트의 모델 선택창이 열렸습니다. 이제는 해당 명령이 리드에 적용된다는 안내를 표시합니다.

백그라운드 에이전트 안정성#

• Linux에서 백그라운드 에이전트 데몬이, 비정상 종료로 워커 기록이 손상된 뒤 약 50초마다 자기 자신과 실행 중인 모든 에이전트를 종료시키던 문제를 수정했습니다.
• macOS에서 SSH로 백그라운드 에이전트를 콜드 스타트할 때 "Could not switch to audit session" 오류로 실패하던 문제를 수정했습니다. 이는 2.1.196에서 생긴 회귀입니다.
• claude stop이 백그라운드 에이전트의 재생성(respawn)과 겹칠 때 조용히 무효가 되던 문제를 수정했습니다. 이제는 재생성이 stop 요청을 존중합니다.
• 백그라운드 작업이 오래 걸리는 명령을 실행하는 동안, 진행 표시가 몇 분씩 멈춰 있던 문제를 수정했습니다.
• 메모리가 부족한 환경에서 백그라운드 세션이 원인을 알 수 없는 일반 오류만 보여주던 문제를 수정했습니다. 이제는 메모리 부족임을 알리고 자원을 확보하라고 안내합니다.
• 백그라운드 에이전트가 완료될 때, 에이전트 뷰에서 원격 세션 상태가 잠깐 Working과 Idle 사이를 오가며 깜빡이던 문제를 수정했습니다.
• 다른 서브에이전트가 아직 작업 중인데도 유휴 상태의 서브에이전트가 에이전트 패널에서 사라지던 문제를 수정했습니다. 이제는 남는 유휴 에이전트가 펼칠 수 있는 요약 행으로 접힙니다.

훅과 CLI#

• SessionStart, Setup, SubagentStart 훅이 종료 코드 2로 끝날 때 stderr를 조용히 숨기던 문제를 수정했습니다. 이제는 오류가 트랜스크립트에 표시됩니다.
• claude --dangerously-skip-permissions daemon <subcommand>가 서브커맨드를 실행하지 않고 채팅 프롬프트로 취급되던 문제를 수정했습니다.

세션과 설정 파일#

• 새 메시지가 없는 세션을 열거나 이어서 재개할 때, 트랜스크립트 파일이 불필요하게 커지던 문제를 수정했습니다.
• ←나 /background로 세션을 백그라운드로 보낼 때 에이전트 뷰 행에서 /color가 사라지던 문제를 수정했습니다.
• 시작 시 복구 대화상자에서 손상된 설정 파일을 초기화할 때, 파일이 복구 불가능하게 지워지던 문제를 수정했습니다. 이제는 먼저 파일을 백업합니다.

브라우저(Claude in Chrome)와 플랜 모드#

• 세션이 서로 다른 빌드나 설정 디렉터리에서 실행될 때, Claude in Chrome이 재연결 페이지를 반복해서 열던 문제를 수정했습니다.
• 플랜 모드에서 상태를 바꾸는 브라우저 도구 호출에 대해 확인을 요청하지 않던 문제를 수정했습니다. 읽기 전용 browser_batch 호출은 이제 올바르게 자동 허용됩니다.

기타#

• claude agents 세션 행에서 풀 리퀘스트 링크를, 중복되던 "PR" 라벨 없이 #N 형태로만 표시합니다.

정리#

v2.1.199는 새 기능보다 안정성 수정이 중심인 패치 릴리스입니다. 크게 보면 네 갈래입니다.

• 네트워크·재시도: SSL 오류 즉시 실패, 스트리밍 부분 응답 보존, 429 자동 재시도, 재시도 횟수 관련 환경 변수 조정.
• 서브에이전트: 중단됐을 때 부분 결과와 오류를 부모에게 정확히 전달, SendMessage 오배달 방지.
• 백그라운드 에이전트: Linux 데몬 자기 종료, macOS SSH 콜드 스타트 회귀, claude stop 경합 등 실행 안정성 수정.
• 훅·세션·브라우저: 훅 stderr 노출, 설정 파일 초기화 시 백업, 플랜 모드의 브라우저 도구 확인 처리.

스택형 스킬 호출(최대 5개 로드) 한 가지가 동작 자체가 바뀌는 변경이고, 나머지는 대부분 기존 동작의 버그 수정입니다.

참고 자료#

• Claude Code v2.1.199 릴리스 페이지
• Claude Code CHANGELOG.md