Claude Code "Connection error" / "fetch failed"(연결 오류)의 원인과 해결 방법
지금 장애가 있나요?
Claude Code 공식 상태는 정상입니다. 이 오류가 계속되면 구현(코드) 또는 사용자 환경 문제일 가능성이 높습니다.
Claude Code의 가동 상태 보기 →오류의 의미
Claude Code가 Anthropic API(api.anthropic.com)에 연결하지 못하는 상태입니다. 네트워크, 기업 프록시/방화벽, DNS, TLS(시계 오차) 또는 API 측 장애가 원인입니다.
자주 있는 원인
- •네트워크 불안정 또는 오프라인
- •기업 프록시/방화벽이 api.anthropic.com 차단
- •VPN / 제로트러스트 경유 차단
- •DNS 해석 실패
- •시스템 시계 오차로 TLS 검증 실패
- •Anthropic API 측 장애
해결 방법
- 1.네트워크를 확인하고 다시 연결
- 2.프록시 환경에서 HTTPS_PROXY / HTTP_PROXY 올바르게 설정
- 3.방화벽/VPN에서 api.anthropic.com 통신 허용
- 4.DNS 변경 또는 재연결
- 5.시스템 날짜·시간 정확히 맞추기
- 6.잠시 후 재시도
- 7.이 페이지 상단과 Claude API에서 장애 확인
기다리면 되는 경우 / 기다려도 안 되는 경우
API 측 장애면 시간이 지나면 복구됩니다. 대부분 본인 네트워크/프록시 설정 문제이므로 기다려도 해결되지 않습니다. 위 항목을 확인하세요.
Claude Code을(를) 쓸 수 없을 때의 대체
관련 오류
자주 묻는 질문
Connection error / fetch failed은(는) 무엇인가요?
Claude Code가 Anthropic API(api.anthropic.com)에 연결하지 못하는 상태입니다. 네트워크, 기업 프록시/방화벽, DNS, TLS(시계 오차) 또는 API 측 장애가 원인입니다.
Connection error / fetch failed은(는) 어떻게 해결하나요?
네트워크를 확인하고 다시 연결 / 프록시 환경에서 HTTPS_PROXY / HTTP_PROXY 올바르게 설정 / 방화벽/VPN에서 api.anthropic.com 통신 허용 / DNS 변경 또는 재연결 / 시스템 날짜·시간 정확히 맞추기 / 잠시 후 재시도 / 이 페이지 상단과 Claude API에서 장애 확인