Claude Code에 « 한도에 도달했습니다 »가 표시되면 먼저 어떤 한도인지 확인하세요: 구독, API 처리량, 지출 한도 또는 계정 문제입니다. 올바른 해결책은 재설정을 기다리거나, 공식 크레딧을 활성화하거나, 동시 호출을 줄이거나, 키를 수정하는 것일 수 있습니다. 진단 전에 다른 요금제를 구매하면 문제가 그대로 남을 수 있습니다.
어떤 메시지가 표시되나요?
| 증상 | 확인 | 적절한 조치 |
|---|---|---|
| 요금제 할당량에 도달했으며 재개 시간이 표시됨 | Claude 계정 및 사용량 페이지 | 기다리거나 다른 요금제 또는 사용 크레딧 비교 |
| 처리량 표시가 있는 API 429 | 메시지, 동시 요청 및 재개 헤더 | 속도를 늦추고 전달된 지연 시간 준수 |
| 지출 한도 또는 결제 거부 | 잔액, 계정 한도 및 결제 | 해당 한도 또는 결제 수정 |
| API 401 또는 403 | 키, 대상 도메인 및 권한 | 식별 또는 권한 부여 수정 |
| 대화가 너무 김 | 컨텍스트 크기 및 정확한 메시지 | 작업을 요약하고 유용한 컨텍스트 줄이기 |
아래 코드는 Anthropic API를 설명합니다. Claude Code가 다른 공급자를 거치는 경우 해당 공급자의 문서도 확인하세요. 중개자가 자체 메시지와 한도를 표시할 수 있습니다.
1. Claude 구독을 사용하는 경우
연결된 계정의 사용량 설정을 여세요. 다른 곳에서 찾은 메시지를 바탕으로 보편적인 지속 시간을 추론하지 말고 해당 할당량과 표시된 시간을 기록하세요. Claude Code가 실제로 예상한 계정을 사용하는지도 확인하세요.
Anthropic은 사용량 및 길이 한도를 구분합니다. Claude와 Claude Code의 사용량은 동일한 계정 할당량을 공유할 수 있습니다. 따라서 새 창이나 새 대화를 열어도 추가 할당량이 생성되지 않습니다. 반면 컨텍스트가 지나치게 커진 경우 이를 줄이면 후속 호출에서 모델이 처리해야 할 작업량을 줄일 수 있습니다.
포함된 할당량을 초과해 계속 사용하려면 자격을 갖춘 개인 요금제에서 공식 사용 크레딧을 이용할 수 있습니다. 이 크레딧은 표준 API 요금으로 별도 청구됩니다. 사용량 설정에서 활성화 여부, 사용 가능한 잔액 및 지출 한도를 확인하세요. 기다리기, 요금제 변경 또는 별도의 API 계정과 비교할 수 있는 옵션입니다.
2. API가 429를 반환하는 경우
오류 텍스트와 API 한도를 확인하세요. 처리량 한도라면 동시 작업을 줄이고 retry-after 지연 시간을 준수하세요. 해당 값이 표시된 경우에는 즉시 여러 에이전트를 다시 실행하면 동일한 차단이 계속될 수 있습니다.
429는 API 계층의 월별 한도 또는 Claude Code 공간의 특정 지출 한도에 해당할 수도 있습니다. 월별 한도에는 재개 시간이 제공되지 않을 수 있습니다. 이 경우 계정의 결제와 관련 한도를 확인하세요. 반복 시도 루프가 이를 증가시키지는 않습니다. 헤더가 없다는 사실만으로 결론을 내려서는 안 되며 메시지도 읽으세요.
3. 잔액 또는 인증과 관련된 문제인 경우
Anthropic 오류 참조는 특히 인증에는 401, 권한에는 403, 결제에는 402를 구분합니다. 일부 지출 한도는 400 코드로도 표시될 수 있습니다. 따라서 HTTP 코드만으로는 오류 세부 정보를 대체할 수 없습니다.
요청이 전송되는 도메인과 키를 생성한 계정을 확인하세요. Claude 구독, Console 잔액 및 타사 공급자의 잔액은 서로 대체할 수 없습니다. 한 공급자에 충전해도 다른 공급자에 자동으로 자금이 추가되지 않습니다. 수정 후에는 중요한 작업을 재개하기 전에 소량의 요청으로 실제 청구 계정을 확인하세요.
4. 별도의 API 결제로 계속하기
게이트웨이 문서는 활성 게이트웨이 식별자가 세션에서 구독 신원을 대체한다고 설명합니다. 기본 주소만 설정한다고 이 변경이 적용되지는 않으며, 등록된 연결이 계속 활성 상태일 수 있습니다. 따라서 주소, 식별자 및 모델을 함께 구성하세요.
Claude Code 가격 및 설정 가이드는 Kunavo를 이용하는 방법을 프랑스어로 설명합니다. 현재 카탈로그에는 Claude Sonnet 4.6의 가격이 토큰 백만 개당 입력 $2.10, 출력 $10.50로 표시되어 있습니다. Claude API 가격 가이드는 비교할 단위를 자세히 설명합니다. 하나의 작업에는 여러 호출이 포함될 수 있으며, 비용은 컨텍스트, 캐시 및 재시도에도 영향을 받습니다.
이러한 분리가 적합하다면 Kunavo 계정을 생성하고 키를 구성한 다음 사용량 기록에서 첫 번째 호출을 확인하세요. 이 계정에는 자체 제약이 있으며 Claude Code가 무제한 서비스로 바뀌는 것은 아닙니다.
유용한 도움 요청 준비하기
차단이 계속되면 다음 정보를 보관하세요. 비밀 키를 공개하지 않고 구성 문제인지 올바른 계정에 적용된 한도인지 구분하는 데 도움이 됩니다:
Interface et version de Claude Code :
Compte utilisé : abonnement / Console / fournisseur tiers
Modèle et nom de domaine de l'API :
Message exact et code HTTP éventuel :
Heure de réinitialisation affichée :
En-tête retry-after, s'il existe :
Identifiant de requête, s'il existe :로컬 작업과 작업 상태도 유지하세요. 액세스가 복구된 후에는 다시 시작하기 전에 에이전트에게 이미 변경된 파일을 확인하도록 요청하여 완료된 단계를 반복하거나 수정 컨텍스트를 잃지 않도록 하세요.
자주 묻는 질문
Claude Code에 « 한도에 도달했습니다 »가 표시되면 어떻게 해야 하나요?
먼저 응답을 제공하는 계정을 확인하세요. 구독을 사용하는 경우 재설정 시간과 사용 크레딧 옵션을 확인하세요. API를 사용하는 경우 전체 메시지를 읽으세요. 처리량, 지출 한도, 결제 및 인증은 서로 다른 수정이 필요합니다.
429 코드가 항상 기다려야 한다는 뜻인가요?
아니요. Claude API는 일부 지출 한도에도 429를 사용합니다. 처리량 초과에는 기다리고 동시 요청 수를 줄여야 할 수 있으며, 재정 한도 초과에는 계정 한도와 결제를 확인해야 합니다. 메시지와 헤더를 통해 올바른 분기를 선택할 수 있습니다.
새 대화가 할당량을 0으로 재설정하나요?
아니요. 새 대화는 전송되는 컨텍스트를 줄일 수 있지만 계정 할당량을 재설정하지는 않습니다. 대화 길이 한도와 구독의 사용량 한도는 서로 다른 제약입니다.
Kunavo 키가 모든 한도를 없애나요?
아니요. Kunavo 키를 사용하는 API 구성은 Claude 구독과 별도의 계정 및 결제를 사용합니다. Kunavo에서 제공하는 잔액, 한도 및 모델의 적용을 받습니다. 올바른 식별자를 구성하지 않고 기본 주소만 변경하는 것으로는 결제가 변경되지 않습니다.
2026년 9월 17일에 공식 출처를 확인했습니다.