Claude Code v2.1.301 — 무인 재시도 watchdog에 사용량 한도 컷오프가 생겼다: 잠들어도 안전한 운영
AI

Claude Code v2.1.301 — 무인 재시도 watchdog에 사용량 한도 컷오프가 생겼다: 잠들어도 안전한 운영

zaq · · 4 min read

무인(unattended) 운영의 마지막 구멍이 막혔습니다. v2.1.301의 retry watchdog 개선은 사용량 한도 리셋이 먼 요청을 기다리지 않고 종료시켜, 밤새 돌리는 자동화 세션이 대기 지옥에 빠지지 않게 합니다.

한마디로 말하면, 295~296의 과부하 백오프 변수에 이어 사용량 한도 컷오프까지 — 무인 운영 스택의 완성형 릴리스입니다.

retry watchdog — 기다릴지 끝낼지가 이제 정책이다

CLAUDE_CODE_RETRY_WATCHDOG 무인 재시도 모드에서 **CLAUDE_CODE_RETRY_WATCHDOG_MAX_USAGE_LIMIT_WAIT_MS**를 설정하면, 사용량 한도의 리셋이 너무 먼 요청은 대기하지 않고 종료합니다. 이로써 과부하(529) 재시도 백오프의 3단 구성이 완성됩니다 — 기본 지연(295), 최대 지연(296), 그리고 사용량 한도 컷오프(301). 야간 배치가 사용량 리셋까지 몇 시간씩 멈춰 있던 상황이 "정해진 시간 안에 못 하면 포기하고 보고"로 바뀝니다.

관측성 — 분류기 판정이 이제 추적 가능하다

tool_decision OTel 이벤트에 **classifier_verdict와 permission_mode**가 추가돼 auto mode 분류기의 결정과 권한 규칙의 결정을 구분할 수 있게 됐고, OTEL_LOG_TOOL_DETAILS=1에서는 **classifier_category**로 분류기가 어떤 내장 규칙에 걸렸는지까지 확인됩니다. 290의 GenAI 시맨틱 컨벤션(290 릴리스에서 소개)에 이어, "왜 이 tool이 막혔나"의 답이 권한 규칙 때문인지 분류기 때문인지 감사 로그에서 바로 답변됩니다. claude-api 스킬에는 ant CLI로 trace destination을 세팅하는 OTel 추적 가이드도 추가됐습니다.

안전·품질 — 미푸시 worktree 보호와 모델 폴백

안전 쪽 픽스가 눈에 띕니다. ① 종료 시 WorktreeCreate 훅이 만든 worktree에 미푸시 커밋이 있을 수 있으면 묻지도 않고 삭제하던 문제 — 이제 확인합니다. ② fable/best 모델 별칭이 조직에 최신 Fable 모델이 없을 때 에러를 내던 것 — 이전 Fable 모델로 1회 재시도합니다(286의 동티어 폴백 패턴과 동일). ③ 전체 디스크 때문에 로그인 갱신이 실패할 때 "Please run /login"이라던 오도성 에러 — 이제 디스크를 지목하고 파일 삭제를 안내합니다. ④ Grep·Glob이 검색 프로그램 자체 실패를 "no matches"로 보고하던 문제(296 픽스의 연속)도 실패 명시로 바뀌었습니다.

실전에서 어떻게 쓸까?

workflow agent가 harness 노트("task text carries no user authority")를 읽고 자기 step을 건너뛰면서도 run이 성공을 보고하던 문제 픽스도 중요합니다 — 멀티 에이전트 파이프라인에서 조용히 빠진 단계를 잡은 것입니다. mod 개발자에게는 Input의 rows로 터미널에서 여러 줄 텍스트 필드(Enter 제출, Shift+Enter 줄바꿈)가, 아티팩트가 PreToolUse 훅으로 보호되는 세션에서는 파일 편집 후 재발행 흐름이 추가됐습니다. 인자가 많거나 긴 스킬·커맨드 호출이 몇 초씩 멈추던 스타일도 정리됐습니다.

마무리로 — 300번째 마일스톤 직후의 첫 릴리스가 화려한 기능이 아닌 무인 운영의 신뢰성 완성이라는 점이 상징적입니다. 밤새 돌리는 에이전트가 있고, OTel 감사를 붙였다면, 이 버전이 그 운영의 정리선입니다.

출처: https://github.com/anthropics/claude-code/releases/tag/v2.1.301

태그: AI Claude Claude Code 개발도구