claudekit / updates / claude-code-2-1-199
[ PATCH · ]

Claude Code 2.1.199

여러 스킬을 한 줄에 붙여 호출하면 앞쪽 스킬을 최대 5개까지 모두 로드하고, 사용량 한도와 무관한 서버 rate-limit(429) 오류는 구독자에게 백오프와 함께 자동 재시도됩니다. TLS 검사 프록시나 만료된 인증서로 인한 SSL 오류가 재시도를 소진하기 전에 즉시 해결 힌트를 표시하고, 부분 출력 뒤 스트림이 끊겨도 응답을 버리지 않고 보존합니다. Linux 백그라운드 에이전트 데몬이 약 50초마다 자신을 종료하던 문제, 서브에이전트가 API 오류를 성공으로 보고하던 문제 등 다수의 백그라운드 작업, 서브에이전트 버그가 수정됐습니다.

Claude Code
공식 발표 →

이 글은 공식 문서를 바탕으로 요약·정리한 내용입니다.

무엇이 바뀌었나?

Claude Code 2.1.199이 2026년 7월 2일 출시됐습니다. 여러 스킬을 한 줄에 붙여 호출할 때 앞쪽 스킬을 모두 로드하고, 사용량 한도와 무관한 일시적 서버 오류를 자동 재시도하도록 개선됐습니다. SSL 인증서 오류 처리, 스트리밍 부분 응답 보존, 백그라운드 에이전트와 서브에이전트의 오류 전달 등 여러 영역의 버그가 정리됐습니다.

주요 개선

  • 스택 슬래시 스킬 호출

    /skill-a /skill-b do XYZ처럼 여러 스킬을 한 줄에 붙여 호출하면 첫 번째 스킬만 로드됐습니다. 이제 앞쪽에 나열한 스킬을 모두(최대 5개) 로드합니다.

  • 일시적 서버 rate-limit 자동 재시도

    사용량 한도와 무관한 서버 429 오류가 나면 턴이 그대로 실패했습니다. 이제 구독자에게는 이런 오류가 백오프와 함께 자동으로 재시도됩니다.

주요 버그 수정

네트워크와 재시도

  • SSL 인증서 오류가 안내 없이 재시도를 소진하던 문제 수정 — TLS 검사 프록시, NODE_EXTRA_CA_CERTS 누락, 만료된 인증서로 인한 오류는 이제 즉시 실패하며 해결 힌트를 표시합니다.
  • API가 부분 출력 뒤 스트림 도중 overloaded, 서버 오류를 보내면 스트리밍 응답 전체가 버려지던 문제 수정 — 이제 부분 응답을 미완료 안내와 함께 보존합니다.

백그라운드 작업과 서브에이전트

  • rate limit이나 서버 오류로 끊긴 서브에이전트가 부분 작업을 부모에게 돌려주지 않고 조용히 실패하던 문제 수정.
  • 서브에이전트가 API 오류(사용량 한도 도달 등)를 성공 결과로 보고하던 문제 수정 — 이제 오류가 부모 에이전트에 보고됩니다.
  • Linux에서 비정상 종료로 손상된 워커 기록이 남으면 백그라운드 에이전트 데몬이 약 50초마다 자신과 실행 중인 모든 에이전트를 종료하던 문제 수정.
  • macOS에서 SSH로 백그라운드 에이전트를 콜드 스타트할 때 “Could not switch to audit session”으로 실패하던 문제(2.1.196 회귀) 수정.
  • claude stop이 백그라운드 에이전트 재생성과 경합하면 조용히 취소되던 문제 수정 — 이제 재생성이 stop을 존중합니다.
  • 백그라운드 작업이 긴 명령을 실행하는 동안 진행 표시가 몇 분씩 멈춰 있던 문제 수정.
  • 메모리가 부족한 머신의 백그라운드 세션이 일반 오류만 표시하던 문제 수정 — 이제 메모리 부족을 알리고 리소스 확보를 제안합니다.
  • 백그라운드 에이전트가 완료될 때 remote 세션이 agent view에서 Working과 Idle 사이를 잠깐 깜빡이던 문제 수정.
  • 다른 서브에이전트가 아직 작업 중인데 유휴 서브에이전트가 agent 패널에서 사라지던 문제 수정 — 남는 유휴 에이전트는 펼칠 수 있는 요약 행으로 접힙니다.
  • 재생성된 에이전트가 이전 에이전트의 이름을 재사용할 때 SendMessage가 조용히 잘못 라우팅되던 문제 수정 — 이제 불일치를 감지해 호출자에게 대상 재지정을 요청합니다.

명령과 설정

  • 서브에이전트를 보는 중 /model이나 /fast를 입력하면 리드의 모델 선택기가 조용히 열리던 문제 수정 — 이제 명령이 리드에 적용된다는 안내가 표시됩니다.
  • SessionStart, Setup, SubagentStart 훅이 종료 코드 2로 끝나면 stderr를 조용히 숨기던 문제 수정 — 이제 오류가 transcript에 표시됩니다.
  • claude --dangerously-skip-permissions daemon <subcommand>가 서브커맨드를 실행하지 않고 채팅 프롬프트로 처리되던 문제 수정.
  • 새 메시지 없이 세션을 열거나 재개하면 transcript 파일이 불필요하게 커지던 문제 수정.
  • 손상된 설정 파일을 시작 복구 대화상자에서 초기화하면 복구 불가능하게 파일이 삭제되던 문제 수정 — 이제 먼저 백업합니다.

UI와 브라우저

  • ←나 /background로 세션을 백그라운드로 보내면 agent view 행에서 /color가 사라지던 문제 수정.
  • 서로 다른 빌드나 설정 디렉토리에서 세션을 실행하면 Claude in Chrome이 재연결 페이지를 반복해서 열던 문제 수정.
  • plan mode가 상태를 바꾸는 브라우저 도구 호출에 확인을 요청하지 않던 문제 수정 — 읽기 전용 browser_batch 호출은 이제 올바르게 자동 허용됩니다.

알아두면 좋은 점

  • CLAUDE_CODE_RETRY_WATCHDOG — 비용량(non-capacity) 일시 오류의 기본 재시도 횟수를 300으로 올리고, CLAUDE_CODE_MAX_RETRIES에 걸려 있던 15회 상한을 없앱니다.
  • 서브에이전트에서 명령 적용 대상 — 서브에이전트를 보는 중 /model이나 /fast를 입력하면 리드 에이전트에 적용됩니다.
  • claude agents PR 링크 표기 — 세션 행의 풀 리퀘스트 링크가 중복된 “PR” 라벨 없이 #N으로만 표시됩니다.