정확한 메시지와 각 메시지의 의미
API Error: 429 {"type":"rate_limit_error", ...}/ "요청 제한에 도달했습니다" — 해당 시간 구간의 요청 수, 토큰 수 또는 동시성 한도를 초과했습니다. 다음에 따라 기다리세요:retry-after.rate limit reached for <model>에 모델별 안내가 함께 표시되는 경우 — 제한은 모델별로 적용되므로 다음으로 등급을 전환하면/model즉시 해결되는 경우가 많습니다.- "사용량 한도에 도달했습니다" / "한도 초기화 시점: …" — 요청 제한이 아니라 Pro/Max 구독의 이동 기간 사용량 상한입니다. 초기화를 기다리거나 API 키를 사용하세요.
529 overloaded_error— 사용자 문제가 아니라 처리 용량 문제입니다. 대기 간격을 늘리며 재시도하세요. 오류 가이드에서 이를 다룹니다.400 … tool use concurrency— 한 턴에서 병렬 도구 호출이 너무 많다는 뜻입니다. 429은 아니지만 같은 세션에서 나타납니다.
Claude 요청 제한: 세 가지 상한
Anthropic은 모델별, 조직별로 분당 요청 수(RPM), 분당 입력 및 출력 토큰 수(ITPM/OTPM), 동시에 처리 중인 요청 수에 제한을 적용하며, 사용량 등급에 따라 한도가 달라집니다. 누적 지출이 늘어나면 등급은 자동으로 올라갑니다. 게이트웨이는 계정별로 이에 상응하는 자체 제한을 적용합니다. 수치는 Anthropic 문서에 공개되어 있으며 콘솔에도 표시됩니다. Claude Code에서 중요한 것은 동시성과 OTPM입니다. 에이전트 세션에서는 출력량이 많은 긴 요청이 병렬로 이어지기 때문입니다.
채팅 클라이언트는 괜찮은데 Claude Code는 제한에 도달하는 이유
채팅 클라이언트는 한 번에 하나의 요청을 보냅니다. Claude Code는 매 턴마다 스트리밍하고(전체 처리 시간 동안 동시성 슬롯을 점유), 하위 에이전트를 병렬로 실행하며(각각 추가 슬롯을 점유), 매 턴마다 전체 대화를 다시 전송합니다(세션이 길어질수록 분당 토큰 수가 증가). 대규모 저장소에서 하위 에이전트 열 개를 실행하면 스트림 열 개가 동시에 실행되고 분당 수십만 개의 토큰이 사용됩니다. 이것이 바로 429입니다.
효과가 나타나는 빈도순으로 정리한 해결 방법
- 1. 재시도하도록 두세요. Claude Code는 다음을 준수합니다:
retry-after; 대부분의 429 오류는 몇 초 안에 해소됩니다. - 2. 병렬로 실행하는 하위 에이전트 수를 줄이세요. 무거운 작업은 동시에 분산 실행하지 말고 순차적으로 실행하세요.
- 3.
/compact— 컨텍스트가 작아지면 턴당 토큰 수가 줄어들므로 TPM을 줄이는 데 도움이 됩니다. - 4. 다음을 사용해 등급을 전환하세요:
/model현재 작업에 맞춰 전환하세요. 제한은 모델별로 적용됩니다. - 5. 백그라운드 작업은 Haiku로 옮기고, 주 작업 루프에는 Sonnet/Opus를 사용하세요.
- 6. 한도 상향을 요청하세요. Anthropic에서는 지출 등급을 높이거나 영업팀에 요청하고, 이 게이트웨이에서는 계정과 워크로드 정보를 포함해 지원팀에 이메일을 보내세요. 신규 계정에는 제어를 벗어난 에이전트 하나가 전체 풀을 소진하지 못하도록 동시성 한도를 보수적으로 설정하며, 요청 시 상향합니다.
/compact focus on the current task
/model claude-sonnet-5
# in scripts: cap the loop and let retries happen
claude -p "..." --max-turns 20이 게이트웨이의 요청 제한
요청 비용은 잔액에서 차감되거나 정액 요금제에 따라 청구됩니다. 요청 제한은 계정별로 적용되며 가격과는 무관합니다. 게이트웨이는 여러 업스트림 계정을 풀로 묶으므로, 한 계정에서 모델별 429이 발생해도 다른 계정에 여유가 있으면 오류를 표시하는 대신 해당 계정으로 전환합니다. 이는 여기서의 세션이 단일 콘솔 키를 사용할 때보다 429 오류를 덜 겪는 이유 중 하나입니다. 가장 도달하기 쉬운 한도는 동시성입니다. 실행하는 병렬 에이전트 수를 지원팀에 보내면 한도를 조정해 드립니다.
| 계획 | 기간 | 가격 |
|---|---|---|
| 1시간 무제한 | 1시간 | $1 |
| 24시간 무제한 | 24시간 | $10 |
| 1주 무제한 | 1주 | $49 |
| 15일 무제한 | 15일 | $89 |
먼저 무료로 사용해 보세요
신규 계정에는 $5의 무료 API 크레딧이 제공됩니다 사용할 코드: CLAUDECODE — Sonnet으로 저녁 한나절 Claude Code를 사용하기에 충분합니다. 이후에는 액면가의 7.69231배에 해당하는 크레딧이 제공됩니다.
export ANTHROPIC_BASE_URL=https://aiprimetech.io
export ANTHROPIC_API_KEY=your_key자주 묻는 질문
Claude Code에서 'API 오류: 요청 제한에 도달했습니다'는 무슨 뜻인가요?
HTTP 429을 뜻합니다. 해당 모델의 분당 요청 수, 토큰 수 또는 동시 요청 수를 초과한 것입니다. Claude Code는 retry-after에 따라 기다렸다가 재시도합니다. 문제가 지속되면 병렬 하위 에이전트 수를 줄이고 /compact를 실행하세요.
Claude의 요청 제한에는 무엇이 있나요?
모델별 분당 요청 수, 분당 입력/출력 토큰 수, 동시 요청 수입니다. Anthropic에서는 사용량 등급에 따라, 게이트웨이에서는 계정별로 한도가 정해집니다. 에이전트 세션은 동시성과 출력 토큰 한도에 도달합니다.
Claude 요청 한도를 높이려면 어떻게 해야 하나요?
Anthropic에서는 지출을 늘리거나(등급은 자동으로 올라갑니다) 영업팀에 문의하세요. 이 게이트웨이에서는 워크로드 정보를 포함해 지원팀에 이메일을 보내세요. 요청 시 동시성 한도를 상향합니다.
'사용량 한도 도달'은 요청 제한과 같은 뜻인가요?
아니요. 이는 Pro/Max 구독의 이동 기간 사용량 상한입니다. 요청 제한은 분 단위로 적용되며 자동으로 해소됩니다. 사용량 상한은 정해진 일정에 따라 초기화됩니다.
게이트웨이에서 Claude Code 실행하기
동일한 모델, 환경 변수 두 개, 액면가의 7.69231배에 해당하는 크레딧 또는 정액 무제한 요금제를 이용하세요. 신규 계정: 코드 CLAUDECODE로 $5의 무료 API 크레딧을 받으세요.
API 키 발급받기 무제한 요금제 보기AI Prime Tech는 독립 API 게이트웨이이며 Anthropic과 제휴 관계가 없고, Anthropic의 보증이나 후원을 받지 않습니다. “Claude”와 “Claude Code”는 Anthropic의 상표입니다. 여기에 설명된 Claude Code 기능은 작성 당시 Anthropic의 공개 문서를 기준으로 하며 자주 변경됩니다. 이 페이지의 가격과 모델 목록은 이 게이트웨이의 실시간 설정에서 가져옵니다.