---
title: "Claude overloaded 529 오류와 rate limit 429 오류 해결하기"
description: "529 overloaded_error는 Claude API가 모든 사용자에게 혼잡하다는 뜻이에요. 429 rate_limit_error는 조직이 한도에 걸렸다는 뜻이에요. 둘 다 백오프를 두고 다시 시도하세요."
canonical: "https://logbrew.co/ko/guides/claude-overloaded-rate-limit-error"
last_updated: "2026-11-10"
---

# Claude overloaded 529 오류와 rate limit 429 오류 해결하기

529 `overloaded_error`는 Claude API가 모든 사용자에게 혼잡하다는 뜻이에요. 429 `rate_limit_error`는 조직이 한도에 걸렸다는 뜻이에요. 둘 다 백오프를 두고 다시 시도하세요.

Claude Code 2.1.319 및 @anthropic-ai/sdk 1.7.0 환경에서 2026년 11월 10일에 테스트

글 [Furkan Erday](https://github.com/furkanerday). LogBrew 창업자 Furkan Erday. 매일 Claude Code와 Codex로 LogBrew를 만들어요.

Canonical: https://logbrew.co/ko/guides/claude-overloaded-rate-limit-error

## 각 클라이언트가 다시 시도하기 전에 기다린 시간

|  | 다시 시도 전 대기 시간, 초 단위 | 다시 시도 횟수 | 총 시간 |
| --- | --- | --- | --- |
| Claude Code, 모든 응답이 529 | 0.6 · 1.1 | 2 | 2.4초 |
| Claude Code, 모든 응답이 429 | 0.5 · 1.2 · 2.5 · 4.1 · 8.8 · 18.8 · 34.2 · 35.4 · 36 · 39.9 | 10 | 182초 |
| `maxRetries: 5`를 쓴 TypeScript SDK, 모든 응답이 529 | 0.4 · 1 · 1.9 · 3.5 · 7.4 | 5 | 14.3초 |

## Claude Code에서 해결하기

### Claude 상태 페이지 확인

status.claude.com에 용량 관련 공지가 있다면 Anthropic 쪽 문제예요. 시간이 지나야 풀려요.

### 기다렸다가 다시 시도

`API Error: Repeated 529 Overloaded errors`는 Claude Code가 이미 여러 번 다시 시도했다는 뜻이에요. 529는 사용 한도에 포함되지 않아요.

### 다른 모델로 바꾸기

Anthropic은 모델별로 용량을 관리해요. 다른 모델을 고르세요. 예를 들어 Opus가 혼잡하면 Sonnet을 쓰세요.

```bash
/model
```

### 스크립트용 대체 모델 설정

print 모드에서 `--fallback-model`을 쓰면 529 오류가 반복될 때 두 번째 모델로 넘어가요. 테스트에서는 요청 3개 뒤에 넘어갔어요.

```bash
claude -p "Run the tests" --fallback-model sonnet
```

### 무인 실행 계속 돌리기

CI처럼 지켜보는 사람이 없는 실행에서는 이 설정이 용량이 돌아올 때까지 529와 429 오류를 계속 다시 시도해요.

```bash
export CLAUDE_CODE_RETRY_WATCHDOG=1
```

## 내 앱에서 해결하기

### 백오프를 두고 다시 시도

공식 Claude SDK는 기본으로 429, 529, 기타 5xx 오류를 지수 백오프로 2번 다시 시도하고 `retry-after` 헤더를 따라요. 앱이 더 오래 기다릴 수 있다면 `maxRetries`를 늘리세요.

```bash
import Anthropic from "@anthropic-ai/sdk";

const client = new Anthropic({ maxRetries: 5 });
```

### 오류와 요청 ID 기록

다시 시도를 모두 쓰고 나면 SDK가 `OverloadedError` 또는 `RateLimitError`를 던져요. Anthropic 지원팀이 요청을 찾을 수 있도록 `error.requestID`를 저장하세요.

```bash
try {
  await client.messages.create(request);
} catch (error) {
  if (
    error instanceof Anthropic.OverloadedError ||
    error instanceof Anthropic.RateLimitError
  ) {
    console.warn("Claude API busy", error.status, error.requestID);
  }
  throw error;
}
```

### 트래픽은 천천히 늘리기

트래픽이 갑자기 크게 늘면 429 가속 한도에 걸릴 수 있어요. 트래픽은 단계적으로 늘리고 일정하게 유지하세요.

## 직접 테스트해 보니

실제 529는 일부러 일으킬 수 없어요. 그래서 Claude Code와 TypeScript SDK를 모든 요청에 529나 429로 응답하는 로컬 테스트 서버에 연결했어요. Claude Code는 이런 서버를 게이트웨이로 다루기 때문에 실제 API 세션에서는 결과가 다를 수 있어요.

Claude Code는 529를 받은 요청 3개를 보낸 뒤 2.4초 만에 `Repeated 529 Overloaded errors`를 표시하고 멈췄어요. `--fallback-model sonnet`을 쓰자 그 요청 3개 뒤에 Sonnet으로 넘어가 약 3분 동안 10번 더 다시 시도했어요. 429에서는 182초 동안 10번 다시 시도했고, 대기 시간이 0.5초에서 40초까지 늘어난 뒤 `Request rejected (429)`가 나왔어요. `CLAUDE_CODE_RETRY_WATCHDOG=1`을 설정하니 150초 뒤 실행을 멈출 때까지도 Claude Code는 529를 계속 다시 시도하고 있었어요.

기본 설정에서 SDK는 첫 요청과 다시 시도 2번, 모두 3개의 요청을 보낸 뒤 1.3초 만에 `OverloadedError`를 던졌어요. `maxRetries: 5`로는 14.3초 동안 요청 6개를 보냈어요. 429에 `retry-after: 3`이 있으면 SDK는 다시 시도하기 전에 매번 3초를 기다렸고, Claude Code는 처음 3번의 다시 시도 전에 각각 3초를 기다렸어요.

## 529와 429는 다른 오류예요

529 `overloaded_error`는 API가 모든 사용자에게 혼잡하다는 뜻이에요. 내 한도 문제가 아니고, 할당량에도 포함되지 않아요.

429 `rate_limit_error`는 조직에 해당하는 오류예요. 속도 제한, 사용 등급의 월 지출 한도, Claude Code 워크스페이스의 지출 한도 중 하나에 걸린 거예요. 지출 한도로 생긴 429에는 `retry-after` 헤더가 없고, 접근이 다시 열릴 때까지 계속 실패해요. 이때는 다시 시도해도 소용없어요.

## Claude Code 요금제 한도는 API 오류가 아니에요

`You've hit your session limit`와 `You've hit your weekly limit`는 Claude 요금제에서 나오는 메시지예요. 세션 한도는 흔히 5시간 한도라고 부르는 롤링 윈도우예요. `/usage`를 실행하면 두 한도와 초기화 시각을 볼 수 있어요.

`Server is temporarily limiting requests (not your usage limit)`는 서버의 짧은 요청 제한이고, Claude Code가 알아서 다시 시도해요. `Request rejected (429)`는 API 키, Amazon Bedrock 프로젝트, Google Cloud 프로젝트 중 하나가 자체 속도 제한에 걸렸다는 뜻이에요.

셸에 `ANTHROPIC_API_KEY`가 있으면 요금제보다 우선 적용돼요. 그래서 Claude Code가 그 키의 더 낮은 한도에 걸릴 수 있어요. `/status`로 어떤 로그인이 활성 상태인지 확인하세요.

댓글 1,499개가 달린 #16157에는 Max 사용자가 거의 바로 한도에 걸린다는 제보가 모여 있어요. 2026년 1월, Anthropic 엔지니어는 팀이 아직 납득할 만한 설명을 찾지 못했다고 적었어요. #29579는 사용량 16%에서 `Rate limit reached`가 뜬다고, #6457은 90분도 안 돼서 5시간 한도에 걸린다고 제보했어요. 3개 모두 아직 열려 있어요.

## 자주 묻는 질문

### 529 오류도 Claude 사용 한도에 포함되나요?

아니요. Claude Code 문서에 따르면 529는 사용 한도 문제가 아니고, 할당량에도 포함되지 않아요.

### Claude overloaded 오류는 얼마나 오래 가나요?

Anthropic은 보통 일시적이라고 해요. status.claude.com에서 진행 중인 장애와 업데이트를 확인하세요.

### Claude Code에 rate limit reached가 뜨는 이유는 뭔가요?

요금제 한도를 다 썼거나, 서버가 잠시 요청을 제한했거나, API 키가 속도 제한에 걸린 경우예요. `/usage`와 `/status`로 어느 쪽인지 알 수 있어요.

### Claude Code 한도는 언제 초기화되나요?

메시지에 시각이 나와요. 예를 들면 `resets 3:45pm`이에요. `/usage`에서도 볼 수 있어요.

### 앱에서 529 오류를 다시 시도해야 하나요?

네, 지수 백오프로 다시 시도하세요. 공식 SDK는 기본으로 2번 다시 시도해요. 테스트에서 TypeScript SDK는 `retry-after`가 요청한 시간만큼 정확히 기다렸어요.

## 앱의 모든 Claude API 오류를 한눈에

앱에서 Claude API를 호출한다면 LogBrew가 반복되는 529와 429 오류를 이슈 1개로 묶고, 각 오류가 얼마나 자주 생기는지 보여 줘요. 넉넉한 무료 요금제로 시작하세요. 카드 등록은 필요 없어요.

[무료로 시작](https://logbrew.co/ko)

## 출처

- [Claude API docs, Errors](https://platform.claude.com/docs/en/api/errors)
- [Claude API docs, Rate limits](https://platform.claude.com/docs/en/api/rate-limits)
- [Claude Code docs, Error reference](https://code.claude.com/docs/en/errors)
- [anthropics/claude-code#16157](https://github.com/anthropics/claude-code/issues/16157)
- [anthropics/claude-code#29579](https://github.com/anthropics/claude-code/issues/29579)
- [anthropics/claude-code#6457](https://github.com/anthropics/claude-code/issues/6457)

## AI 코딩 에이전트 가이드 더 보기

- [Claude Code와 Codex에 MCP 서버 추가하기](https://logbrew.co/ko/guides/mcp-server-claude-code-codex)
- [Claude Code와 Codex에서 AGENTS.md 쓰기](https://logbrew.co/ko/guides/agents-md)
- [Claude Code, Codex, 브라우저 JavaScript 오류 해결법](https://logbrew.co/ko/guides)