Claude Code API 오류 529 과부하: 원인 및 해결 방법

오류 텍스트

API Error: 529 {"type":"error","error":{"type":"overloaded_error","message":"Overloaded"}}

의미

API가 키와 요청을 수락했지만 모델이 과부하 상태여서 처리할 수 없었습니다. 피크는 짧고 특정 모델에 묶여 있으므로 모델을 전환하거나 잠시 기다리면 일반적으로 해결됩니다.

단계별 해결 방법

1. 1. 재시도

   잠시 후 메시지를 다시 보내세요. Claude Code는 대화를 유지하므로 손실되는 것은 없습니다.

2. 2. 모델 전환

   /model을 실행하고 다른 Claude 모델(예: Opus 대신 Sonnet)을 선택하여 작업을 완료한 후 나중에 다시 전환하세요.

3. 3. 채널 전환

   aicodewith에서 각 모델 페이지는 채널 상태를 보여줍니다. 한 채널이 사용 중이면 키에 대해 다른 채널을 선택하세요.

4. 4. 엔드포인트 확인

   /status를 실행하고 엔드포인트가 api.aicodewith.ai인지 확인하세요. 잘못된 엔드포인트는 다른 오류를 표시하지만 확인해 볼 가치가 있습니다.

   ~/.claude/settings.json

   {
     "env": {
       "ANTHROPIC_AUTH_TOKEN": "YOUR_API_KEY",
       "ANTHROPIC_API_KEY": "",
       "ANTHROPIC_BASE_URL": "https://api.aicodewith.ai"
     }
   }

예방 방법

• •일상적인 작업에는 Sonnet 또는 Haiku를 사용하고 어려운 문제에는 Opus를 아껴두세요. 사용량이 많은 피크에는 가장 큰 모델부터 영향을 받습니다.
• •피크 시간에는 병렬 서브에이전트 실행 수를 줄이세요.
• •CI 작업의 경우 첫 529에서 작업을 실패시키는 대신 백오프를 사용하여 재시도하세요.

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

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

여전히 실패하나요?

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

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

FAQ