Claude Code "API Error: 529 overloaded_error"의 원인과 해결 방법
지금 장애가 있나요?
Claude Code 공식 상태는 정상입니다. 이 오류가 계속되면 구현(코드) 또는 사용자 환경 문제일 가능성이 높습니다.
Claude Code의 가동 상태 보기 →오류의 의미
Anthropic API가 일시적으로 과부하 상태(HTTP 529)이며, Claude Code에서는 "API Error: 529 {\"type\":\"overloaded_error\"}"로 표시됩니다. 수요 급증 시 발생하며 대부분 일시적입니다.
자주 있는 원인
- •Anthropic 전체의 수요 급증
- •모델 용량 부족
- •신규 모델 출시 직후의 접속 폭주
- •피크 시간대 혼잡
해결 방법
- 1.잠시 후 다시 실행(Claude Code가 자동 재시도; 계속되면 수동으로 간격 두기)
- 2./model로 일시적으로 모델 전환
- 3.다른 시간대에 실행
- 4.이 페이지 상단과 공식 상태에서 상황 확인
기다리면 되는 경우 / 기다려도 안 되는 경우
과부하가 원인이라 시간이 지나면 복구되는 경우가 많습니다. 연속 실행을 피하고 간격을 두세요.
Claude Code을(를) 쓸 수 없을 때의 대체
관련 오류
자주 묻는 질문
API Error 529 (overloaded)은(는) 무엇인가요?
Anthropic API가 일시적으로 과부하 상태(HTTP 529)이며, Claude Code에서는 "API Error: 529 {\"type\":\"overloaded_error\"}"로 표시됩니다. 수요 급증 시 발생하며 대부분 일시적입니다.
API Error 529 (overloaded)은(는) 어떻게 해결하나요?
잠시 후 다시 실행(Claude Code가 자동 재시도; 계속되면 수동으로 간격 두기) / /model로 일시적으로 모델 전환 / 다른 시간대에 실행 / 이 페이지 상단과 공식 상태에서 상황 확인