문제 해결 · Claude Code

Claude Code API Error 402 billing_error — 잔액 부족

선불 잔액이 요청을 감당하지 못하면 Claude Code는 API Error: 402 billing_error를 출력합니다. 충전하세요. 402를 레이트 리밋처럼 재시도하지 마세요.

표시되는 내용

API Error: 402 {"type":"error","error":{"type":"billing_error","message":"insufficient balance or key spending limit reached for this request"}}

발생 원인

  • 키의 선불 잔액이 방금 보낸 요청을 감당하지 못합니다.
  • 키에 지출 한도가 있고 그 한도에 도달했습니다. 계정 잔액이 남아 있어도 마찬가지입니다.
  • 아직 입금되지 않은 충전은 쓸 수 없습니다.

해결 방법

  • 달러 단위 정수 금액으로 충전한 뒤 입금 후 다시 시도하세요. 기다린다고 402는 해결되지 않습니다.
  • 이 키에 지출 한도가 있으면 올리거나 제거하세요.
  • 같은 키로 실시간 잔액을 확인하세요. HTTP 402와 error.type billing_error로 분기하세요.

이 키의 잔액 확인

curl https://router.apitoken.sale/balance \
  -H "x-api-key: $ANTHROPIC_API_KEY"

관련 검색어

  • claude code 402
  • claude code insufficient balance

자주 묻는 질문

402는 429와 같나요?+
아니요. 429는 분당 처리량이며 재시도할 수 있습니다. 402는 빈 선불 잔액입니다. 429는 Retry-After를 지키고, 402는 충전하세요.
Claude Code가 402에서 스스로 회복하나요?+
아니요. 재시도는 잔액을 채워 주지 않습니다. 충전한 다음 요청을 다시 보내세요.
대시보드에 잔액이 보이는데 요청이 실패한 이유는?+
계정 잔액은 남아 있어도 이 키가 이미 지출 한도에 걸렸을 수 있습니다. 키 한도를 올리거나 충전하세요.

Claude Code 오류 전체 · Claude API 오류 코드 · 설정 가이드

잘못된 설정에 시간 낭비하지 마세요

apiToken.sale은 표준 Anthropic API를 제공합니다 — 같은 모델, 같은 SDK, 하나의 선불 잔액. 도구의 base URL만 지정하면 이 페이지의 설정이 적힌 그대로 작동합니다.

키 받기API 문서