Claude API 429 (rate_limit_error · 속도 제한)
지금 장애가 있나요?
Claude API 공식 상태는 정상입니다. 이 오류가 계속되면 구현(코드) 또는 사용자 환경 문제일 가능성이 높습니다.
Claude API의 가동 상태 보기 →오류의 의미
429는 속도 제한에 도달했다는 의미입니다. RPM/ITPM/OTPM(분당 입력/출력 토큰 수) 한도를 초과했을 때 발생합니다.
자주 있는 원인
- •분당 요청/토큰 한도 초과
- •과도한 병렬 처리
- •낮은 등급(tier)의 낮은 한도
- •Anthropic 측의 일시적 수요 급증
해결 방법
- 1.Retry-After를 준수해 지수 백오프
- 2.병렬 수와 빈도 낮추기
- 3.프롬프트 캐시 또는 Batch로 소비 줄이기
- 4.사용 등급 한도 확인·상향 신청
- 5.이 페이지 상단에서 장애 여부 확인
기다리면 되는 경우 / 기다려도 안 되는 경우
수요 급증이면 시간이 지나며 해소될 수 있습니다. 본인 한도 초과면 기다려도 안 되므로 빈도를 낮추세요.
Claude API을(를) 쓸 수 없을 때의 대체
관련 오류
자주 묻는 질문
429 rate_limit_error은(는) 무엇인가요?
429는 속도 제한에 도달했다는 의미입니다. RPM/ITPM/OTPM(분당 입력/출력 토큰 수) 한도를 초과했을 때 발생합니다.
429 rate_limit_error은(는) 어떻게 해결하나요?
Retry-After를 준수해 지수 백오프 / 병렬 수와 빈도 낮추기 / 프롬프트 캐시 또는 Batch로 소비 줄이기 / 사용 등급 한도 확인·상향 신청 / 이 페이지 상단에서 장애 여부 확인