Claude Code API 오류 429 요청 제한: 해결 방법

오류 텍스트

API Error: 429 {"type":"error","error":{"type":"rate_limit_error","message":"..."}}

의미

종량제 API 사용에는 5시간 또는 주간 허용량이 없지만, 속도 및 동시성 제한은 있습니다. 요청이 폭주하여 이를 초과하면 추가 요청에 429가 발생하며 잠시 후 재시도할 수 있습니다.

단계별 해결 방법

1. 1. 병렬성 줄이기

   추가 Claude Code 세션을 닫고 병렬 하위 에이전트 수를 줄이세요. 동일한 키를 공유하는 스크립트 및 CI 작업도 포함됩니다.

2. 2. 기다린 후 재시도

   잠시 멈추고 메시지를 다시 보내세요.

3. 3. 키 분할

   각 팀원 또는 파이프라인에 자체 키를 부여하여 사용 기록에서 바쁜 작업을 쉽게 식별할 수 있습니다.

4. 4. 잔액 및 한도 확인

   오류가 대신 잔액 또는 지출 한도를 언급하는 경우, 충전하거나 키의 한도를 높이세요.

방지 방법

• •동시 에이전트 수를 적당히 유지하세요.
• •스크립트와 CI에 백오프를 포함한 재시도를 추가하세요.
• •/compact 및 /clear를 사용하여 각 턴에서 더 적은 컨텍스트를 전송하세요.

실패한 요청에 요금이 부과되나요?

실패한 요청(4xx/5xx, 시간 초과, 연결 끊김)에는 요금이 부과되지 않습니다. 성공적으로 완료된 요청에만 요금이 부과됩니다. 업스트림 실패가 자동으로 재시도되어 성공하면 한 번만 청구됩니다.

여전히 실패하나요?

• •aicodewith에서 모델 페이지를 확인하세요: 각 채널의 최근 상태를 보여줍니다.
• •대시보드 사용 기록에서 요청을 조회하여 모델, 상태 및 비용을 확인하세요.
• •오류 발생 시간, 모델 및 오류 텍스트를 support@aicodewith.com으로 이메일로 보내주세요(전체 API 키는 절대 보내지 마세요).

모델 상태 및 가격지원팀 문의문서

FAQ