Originally published at twarx.com - 해당 사이트에서 전체 인터랙티브 버전을 읽어보세요.

최종 업데이트: 2026년 6월 20일

만약 여러분이 'response incomplete Claude API error'를 겪고 있다면, 자신의 코드를 탓하는 모든 개발자는 잘못된 문제를 풀고 있는 것입니다. Anthropic의 인프라는 공개적으로는 축하했지만 사적으로는 자원이 부족했던 수요 성장 아래 균열이 가고 있습니다. 'response incomplete Claude API error'는 여러분의 애플리케이션에 있는 버그가 아닙니다. 이는 아무도 실제 이름으로 부르지 않는 AI 플랫폼 경제의 스트레스 균열(stress fracture)입니다.

2026년 6월 20일 토요일, Downdetector는 오후 1시 직후부터 Claude와 관련하여 400건 이상의 보고된 문제를 기록했으며, 그중 약 절반은 Claude Code와 관련이 있었고, 'response incomplete claude'가 Google에서 트렌드에 올랐습니다. 이 가이드는 실시간 검증 단계, 모든 오류 코드의 정확한 의미, 그리고 운영 환경 수준(production-grade)의 해결책을 제공합니다.

이 글을 다 읽을 때쯤이면, 여러분은 60초 안에 클라이언트 대 서버 실패를 진단하고, 스트리밍(streaming) 및 폴백 라우팅(fallback routing)을 구현하며, 정확히 언제 모델을 전환해야 하는지 알게 될 것입니다.

Asbury Park Press가 보고한 2026년 6월 20일 Claude 장애 기간 동안 사용자들이 겪은 'response incomplete' 오류. 출처

조어된 프레임워크 (Coined Framework)

불완전한 응답 루프 (The Incomplete Response Loop) — Claude API 타임아웃이 재시도 폭풍(retry storms)을 유발하고, 이것이 서버 부하를 증폭시키며, 다시 더 많은 불완전한 응답을 생성하여, 표준 상태 페이지(status pages)가 결코 포착하지 못하는 자기 강화적 장애 소용돌이를 만드는 연쇄 실패 패턴

그 메커니즘은 다음과 같습니다: 재시도되는 모든 실패한 요청이 부하를 추가하며, 이는 더 많은 실패를 유발합니다. 이는 status.anthropic.com이 보고하는 내용과 사용자가 실제로 경험하는 것 사이의 시스템적 격차를 명시하며, 그 격차가 바로 실질적인 피해가 발생하는 지점입니다.

긴급 상황: 현재 Claude에서 발생하고 있는 현상 (확인된 장애 보고)

Asbury Park Press (Gannett)에 따르면, 문제는 토요일 오후 1시 직후에 시작되었으며, Downdetector에 400건 이상의 문제가 보고되었습니다. 약 절반은 가장 지배적인 실패 원인인 Claude Code와 관련되었고, 그 뒤를 이어 Claude Chat에서 문제가 발생했으며, 일부 사용자는 앱을 전혀 로드할 수 없었습니다. 수정에 대한 공개된 일정은 없으나, 보고서에는 이러한 문제들이 '종종 빠르게 해결된다'고 언급되어 있습니다. 파이프라인이 불타고 있는 상황에서는 전혀 위안이 되지 않는 말입니다.

400+
Downdetector에 보고된 Claude 문제
[Asbury Park Press, 2026](https://www.app.com/story/news/2026/06/20/is-claude-down-claude-outage-claude-model-overloaded/90628544007/)
...

Anthropic 공식 상태 페이지: 보고 내용 vs 사용자 보고 내용

권위 있는 출처는 status.anthropic.com입니다. 하지만 역사적으로 이 페이지의 운영 상황은 실제 사용자가 보고하는 실패보다 약 15~45분 정도 뒤처집니다. 그 지연 시간이야말로 바로 불완전한 응답 루프 (Incomplete Response Loop)가 탄생하는 지점입니다. 페이지가 '조사 중 (investigating)'으로 전환될 때쯤이면, 재시도 폭풍 (retry storms)이 이미 부하를 증폭시킨 상태이기 때문입니다. Anthropic 문서 (documentation)는 오류 의미론 (error semantics)을 확인해주지만, 실시간 포화 상태 (saturation)를 드러내지는 않습니다. 당신은 가장 중요한 시간 동안 눈을 가린 채 비행하는 것과 같습니다. 더 넓은 모니터링 철학에 대해서는 AI 관측성 및 모니터링 (AI observability and monitoring)에 관한 저희 글을 참조하십시오.

Claude 장애 타임라인: 2025년 4월–7월

이러한 사건은 이번이 처음이 아닙니다. 2025년 4월부터 7월 사이, Claude.ai, Anthropic API, 그리고 Claude Code 전반에 걸쳐 동시다발적인 성능 저하가 발생했다는 검증된 보고들이 있었으며, 당시 엔지니어링 팀들은 '해결을 위해 적극적으로 작업 중'이었습니다. 표준 HTTP 400과는 구별되는 반복적인 오류 시그니처인 'Error Code 400-4'가 수요가 급증하는 시간대에 나타났습니다. 2026년 6월 20일의 사건은 이와 정확히 일치하는 패턴을 보입니다. 즉, 수요 중심의 포화 상태, Claude Code에서 가장 먼저 발생, 그리고 완전한 블랙아웃(blackout)이 아닌 불완전한 응답(incomplete responses) 형태입니다. 날짜만 다를 뿐, 동일한 지문(fingerprint)을 가지고 있습니다.

영향을 받는 Claude 서비스: 웹(Web), API, Claude Code, 모바일(Mobile)

보고된 소스에 따르면, 영향을 받은 접점은 Claude Code (주요 대상), Claude Chat, 그리고 **앱/웹 로그인 레이어(app/web login layer)**였습니다. 완전한 장애가 아닌 부분적인 성능 저하(partial degradation)가 발생했기 때문에 자가 진단이 예상보다 더 어려워집니다. 일부 요청은 성공하는 반면 다른 요청은 불완전한 출력을 반환하기 때문입니다. 이러한 간헐성(intermittency) 때문에 개발자들은 몇 시간 동안 자신의 코드를 붙잡고 원인을 찾으려 헤매게 됩니다.

사용자들이 장애를 겪고 30분이 지나서야 빨간색으로 변하는 상태 페이지(status page)는 모니터링 도구가 아닙니다. 그것은 플랫폼이 Downdetector를 통해 자신의 장애를 인지하고 있다는 고백일 뿐입니다.

'Response Incomplete' Claude 오류란 무엇이며 왜 발생하는가

Response incomplete Claude API error는 Claude가 응답 생성을 시작했으나, *중단 토큰(stop token)*이 나오기 전에 연결이 끊겼거나 생성이 종료되었음을 의미합니다. 이는 사용자 측의 잘못된 입력(malformed input)을 나타내는 400 Bad Request와는 근본적으로 다릅니다. 불완전한 응답은 서버 측(server-side) 또는 전송 측(transport-side)의 증상입니다. 귀하의 프롬프트(prompt)는 문제가 없었습니다. 플랫폼이 응답을 마칠 여유 공간(room)이 부족했던 것입니다.

이 세 가지 실패 모드는 서로 대체될 수 없습니다: 불완전한 응답 (incomplete response, 생성 중 중단), 타임아웃 (timeout, 정해진 시간 내 완료되지 않음), 그리고 400 (400 error, 생성 시작 전 거부됨)입니다. 하나를 다른 것으로 오진하는 것은 수 시간을 낭비하게 만듭니다. 저는 529 오류가 잘못된 입력값(bad input)을 의미한다고 가정했다가, 유효한 페이로드(payload)를 디버깅하며 꼬박 하루를 허비하는 팀들을 목격해 왔습니다.

기술적 정의: 불완전한 응답(Incomplete Response) vs 타임아웃(Timeout) vs API 오류(API Error)

**타임아웃 (timeout)**은 최종 토큰(token)이 도착하기 전에 클라이언트 또는 게이트웨이가 포기했음을 의미합니다. **불완전한 응답 (incomplete response)**은 토큰이 흐르다가 비정상적으로 멈췄음을 의미합니다. 일반적인 **API 오류 (API error, 4xx/5xx)**는 구조화된 거부(rejection)입니다. '불완전한 응답 루프(Incomplete Response Loop)'가 발생하는 동안에는 사용자층 전체에서 이 세 가지가 동시에 나타나며, 이것이 바로 'Claude가 다운되었다'라는 식의 막연한 트윗들이 실제로 일어나고 있는 현상을 과소평가하는 이유입니다. 공식 Anthropic 스트리밍 문서 (Anthropic streaming documentation)에는 이벤트 스트림(event stream)에서 중단 사유(stop reasons)가 어떻게 나타나는지 상세히 설명되어 있습니다.

불완전한 응답 루프: Anthropic의 숨겨진 인프라 문제

불완전한 응답 루프 — 하나의 느린 요청이 어떻게 플랫폼 장애로 이어지는가

  1

    **수요 급증 (Demand Spike) (바이럴 순간 / 업무 시간)**

api.anthropic.com/v1/messages에 대한 동시 요청이 할당된 컴퓨팅 여유분(provisioned compute headroom)을 초과합니다. 오류가 나타나기 전에 지연 시간(latency)이 상승합니다.

↓

  2
...

긴 문맥(long-context) 요청(Claude Code)이 생성 중간에 타임아웃되어, 중단 토큰(stop token) 없이 부분적인 출력만 반환합니다.

↓

  3
...

클라이언트 SDK와 성급한 사용자들이 즉시 재시도(retry)를 수행하며 — 종종 긴 문맥 요청 전체를 다시 보냄으로써 — 동시 부하를 배가시킵니다.

↓

  4
...

Anthropic은 사용자층 전체에 걸쳐 529 '과부하(Overloaded)' 오류를 반환합니다. 상태 페이지(status page)는 아직 업데이트되지 않았습니다.

↓

  5
...

더 많은 529 오류가 더 많은 재시도(3단계)를 유발하며 — 루프가 닫히고 용량이 해소되거나 확장될 때까지 스스로를 계속 먹여 살리는(feeds itself) 구조가 됩니다.

장애의 원인은 수요 급증 그 자체가 아닙니다. 일시적인 급증을 지속적인 실패로 전환하는 것은 바로 재시도 동작(retry behavior)입니다.

Claude Code는 더 긴 컨텍스트 윈도우 (context windows)를 소비하기 때문에 불균형적으로 큰 영향을 받습니다. 요청당 더 많은 연산 (compute)이 필요하다는 것은 부하가 걸렸을 때 가장 먼저 타임아웃 (timeout)이 발생함을 의미합니다. 2026년 6월 20일 보고서에 따르면, 정확히 이 이유로 인해 실패 사례의 약 50%가 Claude Code에서 발생했습니다.

에러 코드 400과 529가 서로 다른 이유

HTTP 400 = 클라이언트 에러 (사용자의 페이로드 (payload)). HTTP 529 = Anthropic 특유의 '과부하 (Overloaded)' — 서버 측 문제이며 사용자의 잘못이 아니며, 루프 (Loop)의 직접적인 지문과 같습니다. 이 둘을 혼동하면 개발자들은 완벽하게 유효한 코드에 대해 디버깅의 늪 (debugging rabbit hole)에 빠지게 됩니다. 저는 팀들이 바로 이 혼동 때문에 이틀을 허비하는 것을 목격했습니다. Anthropic 에러 참조 (Anthropic error reference)를 확인하세요.

Claude API 에러 코드 전체 분석: 각 코드의 의미

코드	의미	귀하의 잘못인가요?	조치 사항
400	Bad Request (잘못된 입력 형식)	보통 그렇습니다	JSON, 파라미터 (params), 토큰 제한 (token limits) 검증
400-4	플랫폼/미디어 파이프라인 변형 (CDN/스트리밍)	아니요	재시도 (Retry); 상태 페이지 확인
401	인증 실패 (Authentication failed)	예	API 키 교체/검증
403	금지됨 (Forbidden) / 권한 없음	예	조직 권한 및 티어 (tier) 확인
429	속도 제한 초과 (Rate limit exceeded)	부분적으로 그렇습니다	백오프 (Backoff); 콘솔 할당량 (quota) 확인
500	내부 서버 에러 (Internal server error)	아니요	백오프를 적용하여 재시도
529	과부하 (Overloaded) (Anthropic 특유)	아니요	지수 백오프 (Exponential backoff) + 폴백 모델 (fallback model) 사용

에러 400: Bad Request — 코드 문제인 경우와 아닌 경우

표준 400은 잘못된 입력 형식을 의미합니다. 하지만 피크 수요 기간 동안 보고되는 플랫폼 계층의 400-4 변형은 CDN 또는 스트리밍 계층에서의 미디어 파이프라인 실패를 나타내며, 이는 일반적인 모니터링으로는 보이지 않습니다. 만약 귀하의 페이로드가 유효함에도 불구하고 여전히 400-4가 나타난다면, 코드 디버깅을 중단하십시오. 대신 상태 페이지를 확인하십시오.

에러 401, 403, 429: 인증 및 속도 제한 실패

트래픽이 몰리는 기간에는 429 에러가 급증합니다. 무료 티어 (Free-tier) 개발자들은 Claude가 트렌드에 오르는 순간 몇 분 내로 이 에러를 마주하게 됩니다. 이들은 해결이 보장되지 않은 채로 오버플로 (Overflow)를 감내해야 합니다. Anthropic Console은 실제 사용 가능한 여유 용량 (Headroom)을 보여주므로, 조용한 속도 제한 (Rate-limiting)이 플랫폼 장애인 것처럼 위장하는 것을 방지할 수 있습니다. 이는 제가 개발자들이 쫓고 있는 가장 흔한 오탐 (False positive) 사례입니다.

Error 500, 529: Anthropic 측의 서버 측 및 과부하 에러

529 에러는 표준 HTTP 코드가 아닙니다. 즉, Datadog과 같은 도구에서 커스텀 매핑 (Custom-map)을 하지 않는 한 이를 올바르게 표시하지 못한다는 의미입니다. 529 에러 폭풍이 몰아치는 동안에도 여러분의 대시보드는 모두 초록색(정상)으로 표시될 수 있습니다. 만약 현재 설정이 그러하다면, 여러분의 모니터링 시스템은 거짓 정보를 제공하고 있는 것입니다.

'Media Could Not Be Loaded' 에러: 네트워크 문제인가 플랫폼 장애인가

이 에러는 사용자의 네트워크 문제인지 Anthropic의 CDN 문제인지 구분하기 어렵게 나타납니다. 가장 빠른 판별 방법은 직접적인 curl 핑 (Ping)을 보내는 것이며, 다음 섹션에서 확인하십시오. VSCode를 사용하는 Claude Code 사용자들은 크래시 (Crash)가 발생하기 전 일부 코드 구현이 디스크에 작성되어, 수동 롤백 (Rollback)이 필요한 손상된 함수 스텁 (Function stubs)이 남는 현상을 보고했습니다. 긴 에이전트 세션 (Agentic sessions)을 시작하기 전에는 반드시 작업 상태를 커밋 (Commit)하십시오. 언제나 말입니다.

만약 사용자들이 비명을 지르고 있는데 여러분의 관측성 스택 (Observability stack)이 모두 초록색을 나타낸다면, 그것은 모니터링의 문제가 아니라 매핑되지 않은 529 에러의 문제입니다. Anthropic의 과부하 코드는 기본적으로 보이지 않습니다.

Claude가 실제로 다운되었는지 확인하는 방법: 실시간 검증 단계

1단계: 공식 Anthropic 상태 페이지 (status.anthropic.com) 확인

status.anthropic.com은 권위 있는 정보원이지만 지연이 발생할 수 있습니다. 페이지가 초록색이라는 것은 장애가 아니라는 필요조건일 뿐, 충분조건은 아닙니다. 거기서 멈추지 마십시오.

2단계: Downdetector, Reddit r/ClaudeAI, 그리고 X(트위터) 교차 검증

Downdetector 급증 현상을 r/ClaudeAI 스레드의 타임스탬프와 교차 검증하십시오. 2026년 6월 20일, 400건 이상의 Downdetector 보고와 Google에서 'response incomplete claude'가 트렌딩된 것은 상태 표시가 정상으로 바뀌기 훨씬 전부터 장애가 발생했음을 확인해 주었습니다. 대중은 플랫폼보다 더 빠르게 이를 감지합니다.

3단계: 클라이언트와 서버 장애를 분리하기 위한 직접적인 API 핑(Ping) 테스트 실행

bash — 최소한의 Claude API 핑

문제가 귀하의 스택(stack)인지 Anthropic의 서버인지 분리합니다.

curl https://api.anthropic.com/v1/messages \
-H 'x-api-key: '