클로드코드 529 에러가 반복될 때 대응 순서

작업 중 API Error: Repeated 529 Overloaded errors가 뜨면 Anthropic API가 일시적으로 수용량 한계에 이른 상태입니다. API 키나 프로젝트 코드가 틀렸다는 뜻은 아닙니다.

따라서 인증 정보를 다시 넣거나 설정을 바꾸기 전에 잠시 기다리는 편이 낫습니다. 과부하는 모델별 용량에 따라 다를 수 있어서 한 모델만 응답하지 않는 경우도 있습니다.

429와 500은 같은 오류가 아닙니다

429가 떴다고 해서 무조건 요금제 사용량을 다 쓴 것은 아닙니다. You've hit your session/weekly limit는 구독의 세션·주간 한도, Request rejected (429)는 API 키나 프로젝트의 속도 제한을 가리킵니다. Server is temporarily limiting requests (not your usage limit)라면 계정 한도가 아니라 서버가 잠시 요청을 제한하는 상황입니다.

500과 529는 시간을 두고 다시 요청하는 것이 기본 대응입니다.

Repeated 529가 보인다면

Claude Code는 과부하, 서버 오류, 타임아웃, 일시적인 429를 만나면 간격을 늘려 다시 시도합니다. 기본 설정에서는 최대 10회 지수 백오프로 재시도하며, 환경 변수로 횟수를 바꿨다면 달라질 수 있습니다. 화면에 Repeated 529가 남았다면 이 재시도까지 끝난 상태입니다. 몇 분 쉬었다가 방금 보냈던 메시지를 다시 보내 보세요.

같은 오류가 이어지면 Claude 상태 페이지를 확인합니다. "Elevated errors" 같은 공지가 올라와 있다면 서비스 쪽 장애가 해소되기를 기다려야 합니다. Bedrock, Google Cloud, Foundry 또는 사용자 지정 게이트웨이를 거쳐 Claude Code를 쓰는 중이라면 오류 메시지에 표시된 공급자의 상태 페이지도 함께 봐야 합니다.

다른 모델로 이어서 작업하기

상태 페이지에 전체 장애가 없고 529가 계속된다면 /model을 입력해 모델을 바꿔 볼 수 있습니다. 예를 들어 Opus에서 막혔을 때 Sonnet이나 Haiku가 응답하는지 확인하는 식입니다.

상태 페이지에 장애가 없는데 오류가 계속되면 Claude Code에서 /feedback을 실행해 요청 정보를 함께 신고하세요. 직접 API를 호출한 경우에는 응답의 request_id를 지원 문의에 포함합니다. 그전까지는 설정을 여러 번 바꾸기보다 상태 공지를 보며 간격을 두고 다시 시도하는 쪽이 맞습니다.