클로드(Claude)가 안 될 때 원인은 서버 문제(529, 용량 제약), 내 사용량 한도(429, limit), 내 환경(로그인 반복, 무한 로딩) 셋 중 하나예요. 서버 문제는 status.claude.com 에서 확인하고 기다리면 되고, 한도는 오류 메시지에 적힌 리셋 시각까지 기다리면 풀리고, 환경 문제만 직접 고칠 수 있어요. 아래에 오류 메시지별 진단표, 원인별 해결 순서, 제가 실제로 429 에 걸린 사례를 정리했어요.
저는 클로드코드(Claude Code)로 자동매매 봇과 AI 비서를 매일 돌려요. 어제 밤에도 한 번 막혔었는데, 그 사례까지 포함해서 오류 메시지별로 뭘 하면 되는지 적었어요. 설치와 기본 사용법은 클로드코드 사용방법 글에서 다뤘어요.
클로드 오류, 누구 문제인지 30초 만에 가르는 방법은?
같은 “안 됨”이어도 해결법이 완전히 달라요. 오류 메시지의 숫자와 문구로 어느 쪽인지 먼저 가르는 게 제일 빨라요.
| 구분 | 이런 메시지 | 확인 | 해결 |
|---|---|---|---|
| ① 서버 문제 | 529, Overloaded, “high demand”, “용량 제약”, 500, Request timed out | status.claude.com | 기다리기, 모델 바꾸기 |
| ② 내 한도 | 429, “You’ve hit your session limit”, “weekly limit”, “Opus limit”, 메시지 제한 | 메시지의 리셋 시각 | 리셋 대기, 작게 나눠 쓰기 |
| ③ 내 환경 | 401, “Not logged in”, “Login expired”, “Unable to connect”, 무한 로딩, 로그인 반복 | 다른 기기·시크릿창 | 재로그인, 캐시·확장 정리, VPN 끄기 |
①은 내가 할 게 없고, ②는 기다리면 되고, ③만 직접 고칠 수 있어요. 상태 페이지 주소는 status.claude.com 이고, 예전 주소 status.anthropic.com 을 치면 여기로 넘어와요.
① 서버 문제: 529 Overloaded, 용량 제약, 장애일 때는?
가장 흔한 게 529 Overloaded 예요. 내가 고른 모델의 서버 용량이 잠깐 꽉 찬 거고, 공식 문서 기준으로 내 사용량 한도에 포함되지 않아요. 내 잘못이 아니고 내 한도도 안 깎여요.
- status.claude.com 에서 지금 장애 공지가 있는지 봐요. 클로드 앱, API, 클로드코드가 따로 표시돼요
- 공지가 있으면 그냥 기다려요. 대부분 몇 분에서 30분 안에 풀려요
- 클로드코드라면 /model 로 다른 모델로 바꿔보세요. 용량은 모델별로 따로 잡혀서, Opus 가 막혀도 Sonnet 은 되는 경우가 많아요
- 클로드코드는 서버 오류를 알아서 여러 번 재시도해요. “Waiting for API response · will retry in” 이 뜨면 손대지 말고 두세요
클로드 웹이나 앱의 “Something went wrong”, “Claude is experiencing high demand right now” 도 같은 계열이에요. 한국 시간 밤 9시부터 새벽 사이(미국 낮)에 유독 잦아서, 급하지 않으면 시간을 옮기는 게 제일 확실해요.
② 내 한도: 429, 세션 한도, 주간 한도에 걸렸을 때는?
이건 제가 어제 직접 당한 거예요.
블로그 글 14편을 한꺼번에 고치려고 클로드코드 에이전트 5개를 동시에 돌렸더니, “You’ve hit your session limit · resets 7pm” 이 뜨면서 4개가 중간에 죽었어요. 서버 장애인 줄 알고 상태 페이지부터 봤는데 멀쩡했고, 메시지를 다시 보니 429 였어요.
한도 관련 메시지는 세 가지예요.
- session limit : 5시간 단위 창이에요. 창 안에서 많이 쓰면 걸리고, 메시지에 적힌 시각에 풀려요
- weekly limit : 주 단위 총량이에요. 이건 요일과 시각까지 적혀요 (예 : resets Mon 12:00am)
- Opus limit : 특정 모델만 막힌 거예요. 이때만 /model 로 다른 모델 바꾸면 계속 쓸 수 있어요
중요한 건 세션·주간 한도는 모든 모델이 공유한다는 점이에요. Opus 한도가 아니라 세션 한도에 걸렸으면 모델을 바꿔도 안 풀리고, 리셋 시각까지 기다려야 해요.
해결이라기보다 예방인데, 다음날부터 제가 바꾼 건 이거예요.
- 병렬 에이전트는 2~3개까지만. 5개는 한 번에 한도를 태워요
- 큰 작업은 중간 결과를 파일로 저장하게 시켜요. 끊겨도 절반은 남게요
- 클로드코드에서 /usage 치면 지금 플랜 한도와 리셋 시각이 나와요. 큰 작업 전에 한 번 보세요
- 매번 걸리면 플랜을 올리는 게 답이에요. Pro 대비 Max 는 5배, 20배 한도예요 (클로드코드 비용 정리 글 참고)
클로드 웹의 “메시지 한도에 도달했어요” 도 같은 5시간 창 구조예요. 설정의 사용량(Usage) 메뉴에서 내 플랜 한도와 리셋 시각을 볼 수 있어요.
③ 내 환경: 로그인 반복, 네트워크, 브라우저 문제는?
상태 페이지도 멀쩡하고 한도도 아닌데 안 되면 내 쪽이에요. 순서대로 해보세요.
- 새 대화를 열어요. 대화가 너무 길면 “Prompt is too long” 이나 무응답이 나요. 긴 대화는 요약해서 새로 시작하는 게 빨라요
- 시크릿 창에서 열어봐요. 되면 확장 프로그램(광고 차단, 번역기)이나 캐시 문제예요. 확장을 끄고 캐시를 지워요
- 다른 네트워크로 바꿔봐요. 회사 프록시, VPN, 일부 공용 와이파이가 막는 경우가 있어요. 휴대폰 핫스팟으로 되면 네트워크 문제예요
- 클로드코드는 /doctor 를 먼저 쳐요. 설정 문제 대부분을 한 번에 짚어줘요
- “Not logged in”, “Login expired”, 401 이 뜨면 /logout 하고 /login 이에요. 로그인 토큰이 만료된 거라 이것만으로 대부분 풀려요
- “Unable to connect to API”, SSL 오류는 네트워크나 인증서 문제예요. 회사 보안 프로그램이 있으면 그쪽을 먼저 의심하세요
자주 묻는 질문 (FAQ)
Q. 클로드 장애인지 어떻게 확인하나요?
status.claude.com 에서 확인하면 돼요. 초록이면 서버는 정상이고 내 쪽 문제예요. 클로드 앱, API, 클로드코드 상태가 따로 표시되니 내가 쓰는 항목을 보세요.
Q. 529 오류가 나면 내 사용량이 깎이나요?
안 깎여요. 공식 문서에 529 는 사용 한도에 포함되지 않는다고 명시돼 있어요. 기다렸다가 다시 하면 되고, 클로드코드는 알아서 재시도해요.
Q. 한도에 걸렸는데 모델을 바꾸면 되나요?
Opus 한도일 때만 돼요. 세션 한도와 주간 한도는 모든 모델이 같이 쓰기 때문에 바꿔도 안 풀려요. 메시지에 어떤 한도인지 적혀 있으니 그걸 먼저 보세요.
Q. 세션 한도는 몇 시간마다 풀리나요?
5시간 단위예요. 정확한 리셋 시각은 오류 메시지와 /usage 명령, 웹에서는 설정의 사용량 메뉴에 나와요.
Q. 로그인이 계속 반복되면 어떻게 하나요?
시크릿 창에서 먼저 열어보면 원인을 가를 수 있어요. 시크릿 창에서 되면 확장 프로그램이나 쿠키 문제예요. 클로드코드라면 /logout 후 /login 으로 토큰을 새로 받으면 돼요.
관련 글
한도에 자주 걸린다면 플랜별 한도를 정리한 클로드코드 비용 2026, 처음 세팅 중이라면 클로드코드 사용방법 2026, 같은 한도로 더 오래 쓰고 싶다면 명령 출력을 최대 90% 압축하는 rtk 스킬편을 이어서 보세요.
출처 : Claude Code 공식 오류 참조 문서(code.claude.com/docs/ko/errors), Claude 상태 페이지(status.claude.com). 2026년 9월 4일 기준이고, 오류 메시지 문구는 버전에 따라 조금씩 달라질 수 있어요.
이 글은 제가 실제로 겪은 사례와 공식 문서를 기준으로 썼어요. 다른 오류 메시지를 만나면 확인해서 이 글에 추가할게요.
Leave a Reply