클로드 오류·서버 장애 대처법: status 페이지 확인부터 오류 문구별 해결까지
클로드(Claude) 오류가 나면 먼저 status.claude.com에서 서버 장애인지 확인하고, 아니면 오류 문구별로 대처합니다. 앱의 용량·한도 문구, 클로드 코드 500·529·429·로그인 오류, API 오류 코드와 지원팀 문의 경로를 정리했습니다.

클로드(Claude)에서 오류가 나면 먼저 status.claude.com을 열어 지금 장애가 났는지 확인하세요. 내가 쓰는 곳(claude.ai, Claude Code, Claude API)이 초록색 "Operational"이 아니면 클로드 서버 쪽 문제라서, 내 쪽에서 고칠 것은 없고 복구를 기다리면 됩니다. 장애가 아니라면 화면에 뜬 오류 문구를 보고 문구별로 대처합니다.
이 글에서는 상태 페이지 읽는 법, 앱·클로드 코드(Claude Code)·API에서 자주 보는 오류 문구와 대처, 장애 때 할 수 있는 일, 지원팀에 문의하는 경로를 순서대로 정리했습니다. 오류 문구는 2026년 11월 21일에 Claude 도움말과 Claude Code·Claude Platform 공식 문서에 실린 것만 옮겼어요. 설치 단계에서 나는 오류는 Claude Code Windows 설치 오류 해결에 따로 정리해 두었습니다.
오류가 나면 장애 확인, 오류 문구 확인, 다시 시도, 지원 문의 순서로 봅니다.
1단계: status.claude.com에서 장애인지 확인
status.claude.com은 Anthropic이 운영하는 공식 상태 페이지입니다. 맨 위 띠가 초록색 "All Systems Operational"이면 확인된 장애가 없다는 뜻이에요. 그 아래에는 서비스별로 지난 90일 동안의 막대가 있고, 오른쪽에 지금 상태가 적혀 있습니다.
2026년 11월 21일 화면 기준. 막대 하나가 하루이고, 빨간색·주황색 막대에 마우스를 올리면 그날 있었던 일이 나옵니다.
2026년 11월 21일 기준 상태 페이지에 있는 항목은 이렇습니다. 내가 쓰는 곳 한 줄만 보면 돼요.
| 상태 페이지 항목 | 해당하는 곳 |
|---|---|
| claude.ai | 웹, 데스크톱 앱, 모바일 앱에서 하는 대화 |
| Claude Code | 터미널·IDE·데스크톱 앱의 클로드 코드 |
| Claude Cowork | 데스크톱·웹·모바일 앱의 코워크 |
| Claude API (api.anthropic.com) | API 키로 부르는 개발용 API |
| Claude Console (platform.claude.com) | API 키 발급·결제를 하는 콘솔 화면 |
그 밖에 Claude Platform on AWS, Claude in Microsoft Foundry, Claude Models on Google Cloud, Claude for Government 같은 클라우드·기관용 항목도 있습니다. 상태는 Operational(정상), Degraded Performance(느려짐), Partial Outage(일부 장애), Major Outage(큰 장애) 순으로 나빠져요.
과거 장애 기록 보는 법
첫 화면 아래 "View historical uptime"이나 status.claude.com/history로 가면 월별 장애 기록이 나옵니다. "Filter Components"로 내가 쓰는 항목만 골라 볼 수 있어요.
2026년 11월 21일 화면 기준. 시각은 UTC라서 한국 시간은 9시간을 더합니다.
예를 들어 11월 19일 기록 "Elevated errors for Claude Mythos 5.2 and Claude Fable 5.2"에는 claude.ai, Claude API, Claude Code, Claude Cowork가 영향을 받았고 08:56~09:11 UTC(한국 시간 17:56~18:11)에 문제가 있었다고 적혀 있습니다. 제목에 모델 이름이 들어간 장애는 그 모델에서 오류가 많았다는 뜻이니 다른 모델로 바꿔 보세요.
장애 알림 받기
오른쪽 위 "SUBSCRIBE TO UPDATES"를 누르면 알림 받을 방법을 고르는 창이 뜹니다. 이메일 주소를 넣으면 장애가 생기거나, 갱신되거나, 해결될 때 메일이 와요. 문자 메시지, 웹훅, RSS(Atom) 피드도 고를 수 있고 슬랙·팀즈 아이콘도 있습니다.
2026년 11월 21일 화면 기준. 메일은 장애가 생길 때, 갱신될 때, 해결될 때 옵니다.
상태 페이지가 초록색인데 안 될 때
Claude 도움말의 오류 안내에 따르면 "용량 부족(capacity constraints)"은 장애가 아니라서 상태 페이지에 올라오지 않습니다. 사용자가 몰려 잠깐 요청을 덜 받는 상태라 몇 분 뒤 다시 하면 대부분 풀려요. 그러니 초록색이어도 아래 표의 용량 문구가 보이면 잠시 기다리면 됩니다.
2단계: 앱(claude.ai) 오류 문구별 대처
웹·데스크톱·모바일 앱에서 보는 문구는 Claude 도움말에 실린 것을 옮겼습니다. 화면에는 영어로 나와서 원문 그대로 적었어요.
| 화면에 뜨는 문구 | 뜻 | 할 일 |
|---|---|---|
| Due to unexpected capacity constraints, Claude is unable to respond to your message. Please try again soon. | 사용자가 몰려 잠시 응답을 못 함(장애 아님) | 몇 분 뒤 다시 보내기 |
| 5-hour limit reached - resets [time] | 5시간 단위 사용 한도 도달 | 적힌 시각까지 기다리기 |
| You've reached your weekly limit. It resets [day] at [time]. | 주간 한도 도달 | 적힌 날짜·시각까지 기다리기 |
| Your message will exceed the length limit for this chat. Try attaching fewer or smaller files or starting a new conversation. | 이번 메시지가 대화 길이 한도를 넘음 | 첨부를 줄이거나 나눠 보내기, 새 대화 |
| There was an error logging you in | 로그인 실패 | VPN 끄기, 브라우저 확장 끄기, 캐시·쿠키 지우기 |
사용 한도는 유료 플랜에서 사용량 크레딧(usage credits)을 켜 두면 멈추지 않고 크레딧으로 이어서 쓰게 됩니다. 이때는 오류 대신 "Now using credits" 같은 문구가 떠요. 한도가 얼마나 남았는지 보는 법은 클로드 사용량 확인에 정리했습니다.
길이 한도 오류는 유료 플랜에서 코드 실행이 켜져 있으면 클로드가 앞 대화를 요약해 이어 가기 때문에 드뭅니다. 첫 메시지에 아주 큰 파일을 붙였을 때 주로 나요. 대화가 길어지며 답이 흐려지는 문제는 긴 대화를 파일로 저장하고 새 대화로 이어 가는 법을 참고하세요.
3단계: 클로드 코드 오류 문구별 대처
클로드 코드는 일시적인 오류를 최대 10번까지 간격을 늘려 가며 다시 보낸 뒤에야 오류를 보여 줍니다(Claude Code Error reference). 그래서 화면에 오류가 떴다면 이미 자동 재시도가 끝난 상태예요. 다시 보내는 동안에는 Retrying in Ns · attempt x/y 표시가 돕니다.
서버·용량 오류
| 화면에 뜨는 문구 | 할 일 |
|---|---|
API Error: 500 Internal server error. This is a server-side issue, usually temporary — try again in a moment. If it persists, check https://status.claude.com. | 상태 페이지 확인, 1분 뒤 다시 보내기. 긴 요청은 try again만 쳐도 됨 |
API Error: Repeated 529 Overloaded errors. The API is at capacity — this is usually temporary. ... | 몇 분 뒤 다시. /model로 다른 모델로 바꾸기 |
API Error: Server is temporarily limiting requests (not your usage limit) | 잠깐 기다렸다 다시. 계속되면 상태 페이지 확인 |
Request timed out | 다시 보내기. 계속되면 인터넷·프록시 확인 |
공식 문서에 따르면 500 오류는 내 요청이나 설정, 계정 때문에 생기는 오류가 아닙니다. 529는 사용 한도와 상관없고 한도에서 차감되지도 않아요. 용량은 모델별로 따로 잡혀서 /model로 다른 모델을 고르면 계속 일할 수 있습니다.
한도·인증 오류
| 화면에 뜨는 문구 | 할 일 |
|---|---|
You've hit your session limit · resets 3:45pm (weekly·Opus·Sonnet도 같은 꼴) | 적힌 시각까지 기다리기, /usage로 남은 양 확인. Opus·Sonnet 한도는 다른 모델로 바꾸면 이어서 됨 |
API Error: Request rejected (429) · ... | /status로 지금 쓰는 인증이 맞는지 확인. 남아 있는 ANTHROPIC_API_KEY가 구독 대신 쓰일 수 있음 |
Not logged in · Please run /login | /login으로 다시 로그인 |
세션·주간 한도는 모든 모델이 함께 쓰는 한도라서 모델을 바꿔도 풀리지 않습니다. 시간 예시(3:45pm)는 공식 문서에 실린 예시이고, 실제로는 내 리셋 시각이 나와요.
연결·길이 오류
| 화면에 뜨는 문구 | 할 일 |
|---|---|
Unable to connect to API. Check your internet connection | 같은 터미널에서 curl -I https://api.anthropic.com으로 연결 확인, VPN·회사 프록시 확인 |
Context limit reached · /compact or /clear to continue | /compact로 대화를 줄이거나 /clear로 새로 시작 |
Windows PowerShell에서는 curl 대신 curl.exe -I https://api.anthropic.com을 써야 합니다. 그냥 curl이라고 치면 PowerShell의 다른 명령이 실행돼요.
원인을 모르겠으면 /status와 claude doctor
/status는 클로드 코드 안에서 지금 버전, 로그인 방식, 모델을 보여 줍니다. 429나 인증 오류가 나면 "Login method"가 내가 생각한 계정인지 먼저 보세요.
2026년 11월 21일, 강의 촬영용 데모 설정에서 찍은 예시 화면입니다. 계정 정보 줄은 가렸어요.
클로드 코드가 아예 켜지지 않으면 터미널에서 claude doctor를 칩니다. 설치 방식, 버전, 자동 업데이트 상태를 보여 주고 문제가 없으면 "No installation issues found."가 나와요. 클로드 코드 안에서는 /doctor가 설정까지 점검하고 고칠 수 있는 것은 고쳐 줍니다.
2026년 11월 21일, 데모 설정에서 찍은 예시 화면입니다. 설치 경로 줄은 가렸어요.
4단계: API 오류 코드
API로 직접 부를 때는 Claude Platform 오류 문서의 HTTP 코드를 봅니다.
| 코드 | 오류 종류 | 뜻과 할 일 |
|---|---|---|
| 400 | invalid_request_error | 요청 형식·내용 문제. 직접 정한 지출 한도에 닿아도 400 |
| 401 | authentication_error | API 키 문제(형식 오류, 폐기, 만료) |
| 402 | billing_error | 결제 정보 문제. Console에서 확인 |
| 403 | permission_error | 이 키에 해당 기능 권한이 없음 |
| 404 | not_found_error | 주소나 ID가 없음 |
| 413 | request_too_large | 요청 크기 초과(Messages API 128MB) |
| 429 | rate_limit_error | 속도 제한, 월 지출 상한 도달 |
| 500 | api_error | Anthropic 내부 오류. 간격을 늘려 다시 시도 |
| 504 | timeout_error | 처리 시간 초과. 긴 요청은 스트리밍으로 |
| 529 | overloaded_error | 전체 사용자 요청이 몰려 일시 과부하 |
공식 SDK는 연결 오류, 429, 5xx 오류를 기본 두 번 다시 보내고, retry-after 헤더가 있으면 그 시간을 지킵니다. 문제가 계속되면 응답에 붙은 요청 ID(request ID)를 적어 두세요. 지원팀에 문의할 때 이 ID가 있으면 바로 찾을 수 있습니다.
API 요금과 크레딧 충전은 클로드 API 가격에 따로 정리했습니다.
장애 때 할 수 있는 일
-
다른 곳으로 옮겨 보기: 상태 페이지에서 장애가 claude.ai에만 있으면 클로드 코드나 API는 될 수 있습니다. 장애 제목에 특정 모델이 적혀 있으면
/model이나 앱의 모델 선택에서 다른 모델로 바꿔 보세요. -
하던 작업을 파일로 남기기: 긴 작업 중이었다면 지금까지 정한 것과 남은 일을 파일로 적어 두세요. 복구 뒤 새 대화에서 그 파일을 읽게 하면 이어서 할 수 있어요.
-
바로 연달아 다시 보내지 않기: 클로드 코드와 공식 SDK는 이미 간격을 늘려 가며 다시 보냈습니다. 직접 만든 스크립트라면 공식 문서대로 간격을 점점 늘려 다시 보내게 하세요.
-
알림 걸어 두기: 상태 페이지 구독을 해 두면 해결됐을 때 메일이 옵니다. 새로고침을 반복하지 않아도 돼요.
-
긴 프롬프트는 다시 붙여 넣지 않기: 클로드 코드는 보낸 메시지가 대화에 남아 있어서
try again만 쳐도 됩니다.
지원팀에 문의하는 법
상태 페이지에 장애가 없는데 같은 오류가 계속되면 지원팀에 문의합니다. How to get support에 따르면 claude.ai에 로그인한 뒤 왼쪽 아래 이름(이니셜)을 누르고 "Get help"를 고르면 지원 메신저가 열립니다. 먼저 AI 상담 봇 Fin이 답하고, 더 조사가 필요하면 담당 팀으로 넘겨요.
전화 지원은 없고 답변은 메신저와 계정 이메일로 옵니다. Pro·Max·Ultra는 사람 상담까지 갈 수 있고, Free 플랜은 도움말과 Fin까지예요. API·Console 문제는 platform.claude.com에 로그인해 같은 방법으로 "Get help"를 엽니다.
문의할 때는 오류 문구 원문, 처음 난 시각, 쓰던 곳(앱·클로드 코드·API), API라면 요청 ID를 첫 메시지에 같이 적으세요. 같은 문제로 문의를 두 번 열면 처리가 더 늦어진다고 도움말에 적혀 있습니다. 클로드 코드에서는 /feedback으로 대화 기록과 함께 문제를 보낼 수도 있어요.
정리
- 오류가 나면 먼저 status.claude.com에서 내가 쓰는 항목(claude.ai, Claude Code, Claude API)이 Operational인지 봅니다.
- 초록색인데 "capacity constraints" 문구가 뜨면 장애가 아니라 일시적인 혼잡이라 몇 분 뒤 다시 하면 됩니다.
- 한도 문구는 적힌 리셋 시각까지 기다리거나, Opus·Sonnet 한도라면 다른 모델로 바꿉니다.
- 클로드 코드는 오류를 보여 주기 전에 이미 여러 번 다시 보냈습니다. 529는
/model, 429는/status, 로그인은/login, 설치는claude doctor부터 봅니다. - 그래도 안 되면 "Get help"로 지원 메신저를 열고 오류 문구와 시각을 같이 보냅니다.
출처와 확인 (2026-11-21)
- Claude Status (서비스 항목, 상태 단계, 알림 구독 방법; 2026-11-21 화면과 공개 API
components.json으로 확인) - Claude Status History (2026년 11월 장애 기록, 11월 19일 Mythos 5.2·Fable 5.2 오류 기록)
- Claude 도움말: Troubleshoot Claude error messages (사용 한도·길이 한도·로그인·용량 부족 문구, 용량 부족은 상태 페이지에 안 올라옴)
- Claude 도움말: How to get support (Get help, Fin, 플랜별 지원 범위, 전화 지원 없음, 문의 하나에 한 문제)
- Claude Code: Error reference (자동 재시도 10회, 500·529·429·한도·로그인·연결·길이 오류 문구와 대처)
- Claude Code: Troubleshooting (
/doctor,claude doctor,/feedback, 계정·결제 문의 경로) - Claude Platform: Errors (HTTP 오류 코드, 요청 크기 한도, SDK 자동 재시도, 요청 ID)



