결제했는데 ‘잔액 부족’…Claude API 장애, 다시 충전하기 전 확인할 것

Claude API용 크레딧을 결제했는데도 ‘잔액 부족’으로 작업이 멈췄다면, 돈을 더 넣기 전에 결제 내역과 공식 장애 상태부터 확인할 필요가 있다. Anthropic은 한국시간10월2일 새벽1시20분, 구매한 크레딧이 계정 잔액에 늦게 반영돼 일부 요청이 실패하는 문제를 조사 중이라고 밝혔다. 2시34분 확인 당시에도 조사 단계였으며, 복구 시각이나 구체적인 원인은 발표하지 않았다.

카드 결제 실패와 잔액 반영 지연은 다르다

이번 공지는 크레딧을 샀지만 잔액에 반영되는 과정이 지연되는 문제를 설명한다. 잔액 부족 메시지만으로 카드 승인이 거절됐다고 단정할 수 없고, 재구매가 해결책이라는 안내도 없다. 공식 사건 페이지가 명시한 대상은 Claude Console과 Claude API다. 일반 Claude 채팅 전체가 중단됐다는 공지로 확대해서 읽을 사안은 아니다.

평소 API와 플레이그라운드는 선불 크레딧을 사용하고, 크레딧이 소진되면 추가 구매 전까지 이용할 수 없다. 일부 조직은 선불 대신 월별 청구 계약을 이용한다. 따라서 평소의 실제 잔액 소진과 이번 반영 지연을 먼저 나눠 봐야 한다. 선불 이용자는 Console의 Settings→Billing에서 잔액과 Invoice history를 대조할 수 있다. 내역 접근에는 Admin 또는 Billing 권한이 필요하다.

크레딧 구매 때마다 영수증이 발급되며 자동 충전도 포함된다. 등록된 결제 이메일에서는 ‘Your receipt from Anthropic’이라는 제목으로 찾아볼 수 있고, Console 내역에서도 영수증을 내려받거나 열 수 있다. 결제 영수증이 있는지와 해당 조직의 잔액에 반영됐는지를 따로 확인하는 것이 출발점이다. 이번 장애 공지는 개별 이용자의 결제 성공 여부나 환불 처리까지 확인해 주는 자료는 아니다.

402·429·529, 숫자에 따라 확인할 곳이 다르다

오류 번호와 응답 메시지도 함께 봐야 한다. 공식 API 문서에서402 billing_error는 결제 정보 문제로, Console의 결제 내역을 확인하도록 안내한다. 401 authentication_error는 API 키 인증 문제다. 429 rate_limit_error는 요청 속도 제한뿐 아니라 이용 등급의 월 지출 상한이나 Claude Code 작업공간 지출 한도에 도달했을 때도 나타날 수 있다. 지출 상한에 걸린429는 retry-after 헤더가 없으며 접근이 다시 허용되기 전까지 실패가 이어질 수 있다.

500 api_error는 Anthropic 내부 오류이고529 overloaded_error는 일시적인 과부하다. 이는 카드 정보만 고쳐서 해결할 오류와 다르다. 다만 이번 장애 공지는 잔액 부족 실패의 특정 HTTP 번호를 공개하지 않았다. 모든402나429를 이번 장애 때문이라고 묶지 말고, 실제 error.type과 message를 확인해야 한다.

재시도와 과금, 여기서 오해하기 쉽다

공식 SDK는 연결 오류·일시적인 요청 제한·서버 오류 같은 실패를 간격을 늘려 기본 두 차례 재시도하며, retry-after가 있으면 이를 따른다. max_retries 설정으로 바꾸거나 끌 수 있다. 이미 SDK가 재시도하는 상황에서 수동 실행을 계속 겹치는 것과, 결제를 다시 하는 것은 별개의 행동이다. 특히 잔액 반영 지연을 반복 충전으로 해결할 수 있다는 근거는 이번 공지에 없다.

과금도 ‘화면에서 실패처럼 보였다’는 것만으로 판단하면 안 된다. 공식 결제 도움말은 실패 요청에는 과금하지 않는다고 설명하지만, 성공할 예정이던 요청 도중 이용자 쪽 연결이 끊기거나 시간 초과가 나면 과금될 수 있다는 예외를 둔다. 문의할 때는 결제 시각과 영수증, 오류 번호·메시지, 응답의 request_id 또는 request-id를 남겨 두는 편이 좋다. 공식 문서도 지원 문의에 요청 ID를 포함하도록 안내한다. 비밀 API 키를 공개 게시물에 올릴 필요는 없다.