클로드 코드 과부하(529) 오류 때 재시도 간격 늘리는 환경변수 설정법

API가 529 과부하 오류로 요청을 거절하면 클로드 코드는 간격을 점점 늘려 가며 자동으로 다시 보낸다. 이 간격은 환경변수로 늘릴 수 있다.

CLAUDE_CODE_OVERLOADED_RETRY_BASE_DELAY_MS는 첫 대기 시간이다. 기본값은 500밀리초이고, 500에서 32000 사이의 정수만 받는다. 그 밖의 값은 설정하지 않은 것으로 본다.

v2.1.296에서는 대기 시간의 상한을 늘리는 CLAUDE_CODE_OVERLOADED_RETRY_MAX_DELAY_MS도 생겼다. 이 변수의 값 범위는 체인지로그에 따로 적혀 있지 않고 환경변수 문서에도 아직 없다.

// ~/.claude/settings.json
{
  "env": {
    "CLAUDE_CODE_OVERLOADED_RETRY_BASE_DELAY_MS": "4000"
  }
}

API가 붐비는 시간에 재시도가 금방 바닥나면 첫 대기 시간을 늘려 재시도를 더 긴 시간에 걸쳐 나눈다. v2.1.296보다 낮은 버전이면 claude update로 먼저 올린다.