클로드 코드 529 오류, 장애일까 일시 과부하일까

클로드단 방에서 코드 작업 중 CLI가 529 오류를 뱉으며 멈췄다는 얘기가 나왔다. 같은 시각 별 문제 없이 잘 돌아간다는 사람도 있었고, Cloudflare 장애 가능성까지 거론됐다. 이 글은 그날 멈춤이 정말 전사 장애였는지, 왜 누구는 걸리고 누구는 안 걸렸는지, 이런 순간에 무엇을 확인하면 되는지를 따라간다.

529는 사용자 잘못이 아니다

Anthropic API 오류 체계에서 429와 529는 성격이 다르다. 429 rate_limit_error는 계정이나 조직이 자기 몫의 한도를 넘었을 때 뜬다. 529 overloaded_error는 다르다. 특정 계정의 사용량과 무관하게, 서버 전체가 밀려드는 요청을 감당하지 못할 때 나오는 응답이다. 공식 문서는 이를 일시적 과부하로 규정한다. 실패한 529 요청은 과금 대상에서도 제외된다.

Claude Code CLI는 이미 이 상황에 맞춰 만들어져 있다. SDK와 CLI 모두 5xx·529 오류를 자동으로 최대 10회까지, 대기 시간을 늘려가며 재시도한다. 방에서 나온 "529 뜨고 3분쯤 기다리니 재개됐다"는 경험은 이 재시도 로직이 설계대로 작동한 사례에 가깝다. 화면의 "Retrying in 5s · attempt 3/10" 문구가 그 증거다. 재시도 10회를 다 채우고도 안 풀릴 때만 콜론(:) 형태의 최종 오류로 넘어간다.

그날 오후, 전사 장애가 아니라 부분 장애였다

그 시점 Claude 상태 페이지(status.claude.com)에 실제로 이상 신호가 떴다. 8월 12일 오후 1시50분(UTC) 여러 모델에서 오류가 급증했다는 인시던트가 등록됐다. 다섯 시간 가까이 지난 오후 6시7분에야 해소로 표시됐다. 모니터링 대상 여섯 개 서비스 중 claude.ai, API, Claude Code, Claude Cowork 네 개가 "성능 저하"로 표시됐다. Console과 정부용 서비스는 영향권 밖이었다.

이 지점이 방에서 나온 엇갈린 경험을 설명해준다. 누군가는 CLI가 멎었고 누군가는 멀쩡했던 건 관측이 틀려서가 아니라, 장애 범위가 전체가 아니라 일부 서비스와 모델에 걸쳐 있었기 때문일 가능성이 크다. 같은 시각 같은 계정이라도 요청이 어느 모델 엔드포인트에 붙는지에 따라 529 조우율이 달랐다는 보고가 이 시기 반복적으로 나왔다.

Cloudflare 의심은 빗나갔다, 진짜 병목은 다른 데 있다

방에서 가장 먼저 나온 의심은 Cloudflare였다. 그 전후로 Cloudflare에 문제가 아예 없었던 건 아니다. 8월 초 Workers 빌드 실패, 8월 7일 일부 리전 R2 쓰기 지연, 8월 13일 대시보드 503 오류가 Cloudflare 자체 상태 페이지에 개별 인시던트로 남아 있다. 다만 이들은 시점도 규모도 8월 12일 Claude 장애와 겹치지 않는 별개의 소규모 사고였다.

Anthropic이 지목해 온 원인은 다른 데 있다. 회사는 앞선 장애들을 두고 "수요가 전례 없는 속도로 늘면서 인프라가, 특히 피크 시간대에 한계까지 당겨졌다"고 설명해왔다. 엔터프라이즈의 Claude Code 채택과 일반 사용자 급증이 겹치면서 코드 작업처럼 요청이 몰리는 트래픽 패턴이 서빙 용량을 자주 넘어선다는 설명이다. CDN이나 엣지 계층이 아니라, Anthropic 자체 GPU·서빙 용량이 병목이라는 뜻이다.

왜 자꾸 반복되나

529는 이번이 처음이 아니다. 상태 페이지에는 올해 들어서만 Sonnet 4, Opus 4·5 계열에서 "elevated 529 errors" 인시던트가 되풀이해서 올라왔다. 6월에는 12일 사이 열 번 넘는 장애가 겹쳤다는 보도도 있었다. 직전 분기 90일 가동률은 claude.ai 99.36%, API 99.42%, Claude Code 99.34%로 집계됐다. 엔터프라이즈 계약이 보통 요구하는 99.9%에는 못 미치는 수치다. 서비스별로 따지면 분기당 14~23시간의 다운타임에 해당한다.

체감 여론도 나빠지는 쪽이다. 코드 품질 불만과 겹쳐 예전만큼 믿음이 안 간다는 반응이 올해 들어 부쩍 늘었다는 관찰이 나온다. Anthropic도 손 놓고 있지는 않다. 상반기부터 Amazon·Google·Microsoft·AMD와 맺은 컴퓨팅 계약 규모만 수십조 원대다. 미국 데이터센터에 500억 달러를 투입하겠다고도 밝혔다. 다만 신규 용량은 체감되기까지 짧아도 몇 달, 길게는 몇 년이 걸린다.

순간의 멈춤 앞에서 뭘 볼까

529가 뜨면 가장 먼저 할 일은 재시도 카운터를 지켜보는 것이다. CLI가 알아서 최대 10번 재시도하는 동안은 계정도 청구도 영향받지 않는다. 콜론 형태의 최종 오류로 넘어가거나 상태 페이지에 인시던트가 뜬 뒤라면, 그때부터는 기다림 대신 확인으로 넘어갈 시점이다.

정말 마감이 걸린 작업이라면 선택지가 하나 더 있다. Claude Code는 직접 API 말고도 Amazon Bedrock이나 Google Vertex AI 경로로 붙을 수 있다. 두 클라우드는 자체 서빙 인프라를 쓰기 때문에 api.anthropic.com 장애와 별개로 살아있는 경우가 많다. 다만 별도 계정과 설정이 필요해서 개인 개발자 대부분에게는 여전히 비현실적이다.

그날 방에서 오간 대응—상태 페이지 확인, 몇 분 대기, 재시도—은 Anthropic이 설계해 둔 절차와 다르지 않았다. 다만 그 절차를 꺼내야 하는 순간이 올해 들어 눈에 띄게 잦아졌다.