클로드 코드 무인 재시도 모드가 사용 한도 풀릴 때까지 기다리지 않게 하는 환경변수 설정법

클로드 코드(Claude Code)를 CI나 야간 작업처럼 사람이 없는 곳에서 무인 재시도 모드(CLAUDE_CODE_RETRY_WATCHDOG=1)로 돌리면, 사용 한도에 걸린 세션은 한도가 풀릴 때까지 남은 시간을 그대로 기다린다. 10월 15일 나온 2.1.301의 CLAUDE_CODE_RETRY_WATCHDOG_MAX_USAGE_LIMIT_WAIT_MS를 같이 설정해 두면, 한도가 풀리기까지 너무 오래 남았을 때 기다리지 않고 요청을 끝낸다.

export CLAUDE_CODE_RETRY_WATCHDOG=1
export CLAUDE_CODE_RETRY_WATCHDOG_MAX_USAGE_LIMIT_WAIT_MS=<기다릴 최대 시간>

값 형식과 기본값은 아직 어디에도 적혀 있지 않다. 이 변수는 체인지로그에만 있고 환경변수 문서에는 올라오지 않았다. 이름이 비슷한 CLAUDE_CODE_RETRY_WATCHDOG_MAX_WAIT_MS는 429·529 오류를 기다리는 최대 시간을 밀리초 정수로 받는다(1800000이 30분). 새 변수도 이름이 _MS로 끝나지만, 단위는 문서에 올라오면 확인하고 넣는다.