본문으로 건너뛰기
블로그로
블로그팁 & 트릭

클로드 오류·서버 장애 대처법: status 페이지 확인부터 오류 문구별 해결까지

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

공식 출처 7건 · 본문 하단 확인 섹션과 동일

클로드 오류·서버 장애 대처법: status 페이지 확인부터 오류 문구별 해결까지 표지 이미지

클로드(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일 동안의 막대가 있고, 오른쪽에 지금 상태가 적혀 있습니다.

Claude Status 첫 화면. All Systems Operational 띠 아래 claude.ai, Claude Console, Claude API, Claude Code 항목별 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"로 내가 쓰는 항목만 골라 볼 수 있어요.

Claude Status 장애 기록 화면. Incidents 탭에 2026년 11월 장애 제목과 영향 시간이 UTC로 적혀 있다 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) 피드도 고를 수 있고 슬랙·팀즈 아이콘도 있습니다.

SUBSCRIBE TO UPDATES를 누르면 뜨는 창. 이메일, 전화, 슬랙, 팀즈, 웹훅, RSS 아이콘과 이메일 주소 입력칸이 있다 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"가 내가 생각한 계정인지 먼저 보세요.

클로드 코드에서 /status를 연 화면. Version, Login method, Model, MCP servers 항목이 보이고 세션 ID·이메일 등은 가려져 있다 2026년 11월 21일, 강의 촬영용 데모 설정에서 찍은 예시 화면입니다. 계정 정보 줄은 가렸어요.

클로드 코드가 아예 켜지지 않으면 터미널에서 claude doctor를 칩니다. 설치 방식, 버전, 자동 업데이트 상태를 보여 주고 문제가 없으면 "No installation issues found."가 나와요. 클로드 코드 안에서는 /doctor가 설정까지 점검하고 고칠 수 있는 것은 고쳐 줍니다.

터미널에서 claude doctor를 실행한 화면. 버전, 플랫폼, 자동 업데이트 상태와 No installation issues found 문구가 보인다 2026년 11월 21일, 데모 설정에서 찍은 예시 화면입니다. 설치 경로 줄은 가렸어요.

4단계: API 오류 코드

API로 직접 부를 때는 Claude Platform 오류 문서의 HTTP 코드를 봅니다.

표가 잘리면 좌우로 넘겨보세요.
코드오류 종류뜻과 할 일
400invalid_request_error요청 형식·내용 문제. 직접 정한 지출 한도에 닿아도 400
401authentication_errorAPI 키 문제(형식 오류, 폐기, 만료)
402billing_error결제 정보 문제. Console에서 확인
403permission_error이 키에 해당 기능 권한이 없음
404not_found_error주소나 ID가 없음
413request_too_large요청 크기 초과(Messages API 128MB)
429rate_limit_error속도 제한, 월 지출 상한 도달
500api_errorAnthropic 내부 오류. 간격을 늘려 다시 시도
504timeout_error처리 시간 초과. 긴 요청은 스트리밍으로
529overloaded_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)