전체 가이드

Claude Code 장애인가요? 서비스 장애와 내 쪽 문제를 구분하는 방법

먼저 status.claude.com을 확인하고 오류를 읽으세요. 500, 529 Overloaded, 사용 한도, 429, 연결 오류가 각각 무엇을 뜻하고 어떻게 해야 하는지 정리했습니다.

기준 버전
CLI
0.2.17
프리뷰 ref
a2c45c8

요약

status.claude.com을 여세요. Claude Code나 API에 진행 중인 인시던트가 있다면 다른 사람들도 쓸 수 없는 상태이고, 기다리는 것이 해결책입니다.

상태 페이지가 정상이라면 정확한 오류 문구를 읽으세요. Anthropic의 오류 레퍼런스는 오류를 몇 가지 계열로 나눕니다.

보이는 메시지보통 의미첫 단계
API Error: 500 Internal server error서버 측 문제다시 시도한 뒤 상태 페이지 확인
API Error: Repeated 529 Overloaded errorsAPI 용량 포화기다리기. 할당량에 포함되지 않음
Server is temporarily limiting requests (not your usage limit)서버 측의 짧은 제한잠시 기다리기
You've hit your session limit · resets …요금제 사용 한도초기화를 기다리거나 한도 가이드 참고
Request rejected (429)API 키나 클라우드 프로젝트의 속도 제한속도를 줄이거나 한도 올리기
Unable to connect to API 및 변형네트워크, VPN, 프록시, DNScurl -I https://api.anthropic.com

Claude Code는 일시적인 실패를 백오프와 함께 최대 10번까지 자동으로 재시도한 뒤에 오류를 보여 줍니다. 오류가 보인다면 재시도가 이미 소진된 것입니다.

문제

Claude Code가 응답을 멈추거나 작업 도중 빨간 오류가 뜹니다. "Claude Code 장애"를 검색하는 것이 자연스러운 반응이지만, 실제로는 서비스는 멀쩡하고 사용 한도, 프록시, VPN, 만료된 로그인처럼 가까운 곳에 원인이 있는 경우가 많습니다. 두 경우는 대응이 정반대입니다. 기다린다고 프록시가 고쳐지지 않고, 재설치한다고 장애가 해결되지 않습니다.

1단계: Claude 상태 페이지 확인

status.claude.com에는 Claude Code가 사용하는 API를 포함해 Claude 서비스의 인시던트가 올라옵니다. Anthropic의 오류 메시지도 이곳을 안내합니다. v2.1.198부터는 529 과부하가 원인일 때 재시도 카운트다운에 상태 확인 위치가 표시됩니다.

Amazon Bedrock, Google Cloud의 Agent Platform, Microsoft Foundry 또는 게이트웨이를 사용한다면 오류에 해당 공급자나 호스트 이름이 나옵니다. Anthropic이 아니라 그 공급자의 상태 페이지를 확인하세요.

2단계: 오류 메시지 읽기

API Error: 500 Internal server error

Anthropic은 이를 서버 측 문제이며 보통 일시적이라고 설명합니다. 잠시 후 다시 시도하고, 계속되면 상태 페이지를 확인하세요.

API Error: Repeated 529 Overloaded errors

API 용량이 가득 찼습니다. Anthropic 레퍼런스에 따르면 529는 사용 한도가 아니며 할당량에 포함되지 않습니다. Opus is experiencing high load 같은 메시지도 같은 계열입니다. 부하가 지나갈 때까지 /model로 다른 모델로 바꾸면 작업을 이어 갈 수 있습니다.

Server is temporarily limiting requests (not your usage limit)

요금제와 무관한 짧은 제한입니다. v2.1.199부터 Claude Code가 표시하기 전에 자동으로 재시도합니다. 잠시 기다린 뒤 다시 시도하세요.

You've hit your session limit 또는 weekly limit

장애가 아닙니다. 요금제 사용량을 다 썼고, 메시지에 초기화 시각이 나와 있습니다. Claude Code 사용량은 언제 초기화되나요?와 한도에 도달했을 때 할 일을 참고하세요.

Request rejected (429)

API 키, Bedrock 프로젝트 또는 Google Cloud 프로젝트에 설정된 속도 제한에 걸렸습니다. 프록시나 게이트웨이가 자체 429 페이지로 응답했다면 그 제목이 · 뒤에 표시됩니다.

Unable to connect to API

API 연결에 실패했습니다. 최근 버전은 원인을 표시하고 ConnectionRefused, ENOTFOUND, EHOSTUNREACH 같은 오류 코드를 괄호 안에 남깁니다. 메시지 예시:

Unable to connect to API. Check your internet connection
Couldn't connect through your proxy (ERR_PROXY_TUNNEL)
Connection dropped (ECONNRESET)

Anthropic은 흔한 원인으로 인터넷 연결 없음, api.anthropic.com을 차단하는 VPN, 설정되지 않은 회사 프록시를 꼽습니다.

3단계: 같은 셸에서 연결 테스트

curl -I https://api.anthropic.com

Windows PowerShell에서는 내장 별칭을 피하기 위해 curl.exe -I https://api.anthropic.com을 사용하세요.

  • curl이 실패: 이 머신의 네트워크 문제입니다. Wi-Fi, VPN, DNS를 확인하세요. 회사 프록시 뒤에 있다면 Claude Code를 실행하기 전에 HTTPS_PROXY를 설정하세요.
  • curl은 되는데 Claude Code는 안 됨: 런타임과 네트워크 사이에 무언가가 있습니다. 게이트웨이를 쓴다면 ANTHROPIC_BASE_URL을, 그리고 Anthropic 네트워크 구성 페이지에 있는 방화벽 허용 호스트를 확인하세요.

4단계: 로컬 설치 문제 배제

상태 페이지가 정상이고 네트워크도 괜찮다면:

  1. 업데이트: claude update
  2. 예상한 계정으로 로그인했는지 확인: Claude Code 안에서 /status
  3. 환경에 남아 있는 ANTHROPIC_API_KEY가 없는지 확인하세요. 이 값은 구독 로그인보다 우선합니다.
  4. 오류가 아니라 멈춤이나 높은 CPU 사용률이라면 Anthropic의 문제 해결 페이지에 흔한 원인이 정리되어 있습니다.

무인 실행의 경우

CI처럼 아무도 지켜보지 않는 작업을 위해 Anthropic은 CLAUDE_CODE_RETRY_WATCHDOG=1을 안내합니다. 일반 재시도 후 실패하는 대신 429와 529 용량 오류를 무기한 재시도합니다. 지출 한도로 인한 429는 여전히 즉시 실패합니다. 긴 장애 동안 러너를 계속 붙잡지 않도록 작업 타임아웃과 함께 사용하세요.

자리에 없을 때 공급자 문제와 컴퓨터 문제 구분하기

앉아 있지 않은 컴퓨터에서 세션이 실행 중일 때 "Claude Code가 안 된다"는 세 가지를 뜻할 수 있습니다. 공급자에 문제가 있거나, 세션이 한도에 걸렸거나, 컴퓨터 자체가 오프라인이 된 경우입니다.

이를 휴대폰에서 구분하고 싶다면, Happier는 Claude Code, Codex 등 여러 에이전트를 휴대폰, 데스크톱, 웹에서 크로스 디바이스로 실행하고 오케스트레이션할 수 있는 오픈 소스 앱입니다.

보여 주는 정보:

  • 각 머신이 online 또는 offline으로 표시되며, 마지막으로 확인된 시각도 나옵니다. 컴퓨터가 오프라인이면 다시 연결될 때까지 공급자 상태는 의미가 없습니다.
  • 사용 한도는 세션 안의 배너 Usage limit reached로 표시되며, 공급자가 알려 준 초기화 시각이 함께 나옵니다. 이것으로 할당량 정지와 장애를 구분할 수 있습니다.

컴퓨터에서는 happier daemon status로 백그라운드 서비스가 실행 중인지 확인할 수 있습니다. Happier는 공급자 장애, 네트워크 끊김, 꺼진 컴퓨터를 해결하지 않습니다. 설정 방법은 휴대폰에서 Happier 사용하기에 있습니다. GitHub에 공개되어 있고, 여기서 다운로드할 수 있으며, Discord도 있습니다.

자주 묻는 질문

지금 Claude Code 장애인가요?

status.claude.com을 확인하세요. Anthropic의 오류 메시지가 안내하는 곳입니다.

529 오류도 사용량을 소모하나요?

아니요. Anthropic의 오류 레퍼런스에 따르면 529는 사용 한도가 아니며 할당량에 포함되지 않습니다.

Claude 채팅은 되는데 Claude Code는 안 되는 이유는?

계정은 같아도 경로가 항상 같지는 않습니다. Claude Code는 API 키, 프록시, 게이트웨이, 클라우드 공급자를 쓰고 있을 수 있습니다. /status와 환경 변수를 확인하세요.

"Connection lost while your computer was asleep"으로 멈추는 이유는?

요청 도중 컴퓨터가 절전 모드에 들어갔습니다. Claude Code는 끊긴 연결을 재시도하며, 그래도 턴이 끝났다면 메시지를 다시 보내세요.

관련 가이드

claudetroubleshootingerrorsoutage
마지막 업데이트: 2026-10-26