Claude API “credit balance is too low” / 402 insufficient_quota

이 오류는 코드와 관계가 없습니다. 키 뒤의 선불 잔액이 비어 있거나 월별 지출 한도에 도달한 것입니다. Anthropic Console과 게이트웨이의 과금 모델이 어떻게 다른지, 그리고 새벽 2시에 재발하지 않도록 하는 알림을 설명합니다.

오류

response (HTTP 400 / 402)

// Anthropic Console (HTTP 400):
{"type":"error","error":{"type":"invalid_request_error",
 "message":"Your credit balance is too low to access the Anthropic API..."}}

// OpenAI-compatible gateways, e.g. Kunavo (HTTP 402):
{"error":{"message":"Wallet balance is too low for this request. Top up at https://kunavo.com/app/billing",
 "type":"insufficient_quota","code":"insufficient_quota","param":null}}

원인과 해결 방법 한눈에 보기

원인	해결 방법
선불 잔액이 실제로 0임	충전하세요. Anthropic: Console → Plans & billing. Kunavo: /app/billing(잔액은 만료되지 않음).
자동 충전이 꺼져 있음(또는 카드가 만료됨)	자동 충전을 활성화하거나 카드를 업데이트하여 사용량 급증으로 잔액이 0이 되는 것을 알아차리지 못하는 일이 없도록 하세요.
월별 지출 한도에 도달함	지출이 정당했다면 키별 또는 워크스페이스별 한도를 높이거나 해제하세요.
다른 워크스페이스의 키	키는 키를 발급한 워크스페이스의 잔액을 사용합니다. 자금이 있는 조직이 다른 워크스페이스의 키에 자금을 제공하지는 않습니다.

인증 문제가 아니라 잔액 문제인지 확인하세요

401 = 키 문제, 400 "credit balance too low" / 402 insufficient_quota = 금액 문제입니다. 과금 오류 때문에 키를 교체하지 마세요. 새 키도 동일하게 비어 있는 지갑을 읽습니다.

충전한 다음 저렴한 호출 한 번으로 확인하세요

Anthropic과 Kunavo 모두 잔액이 즉시 적용되므로 재배포가 필요 없습니다. 워커의 일시 중지를 해제하기 전에 최소 요청으로 확인하세요.

verify.sh

curl -s https://api.kunavo.com/v1/chat/completions \
  -H "Authorization: Bearer $KUNAVO_API_KEY" \
  -H "content-type: application/json" \
  -d '{"model":"claude-haiku-4-5","max_tokens":8,"messages":[{"role":"user","content":"ok?"}]}'

Claude Code에서 보이나요?

Claude Code는 Anthropic API 키로 실행되며 Console 잔액이 비어 있을 때 이 메시지를 표시합니다. Pro 또는 Max 로그인은 대신 사용량 한도에 도달하며 이 메시지를 표시하지 않습니다. Console을 충전하거나 종량제 엔드포인트에서 계속 작업하세요. Claude Code는 ANTHROPIC_BASE_URL을 기본적으로 읽으므로 환경 변수 몇 개만 바꾸면 전환할 수 있습니다. 네 개의 모델 행은 유지하세요. Claude Code의 기본값과 opus 및 sonnet 별칭은 Anthropic의 최신 모델을 따르며, sonnet 별칭은 Kunavo가 제공하지 않는 Sonnet 5.5를 요청합니다.

~/.zshrc

export ANTHROPIC_BASE_URL=https://api.kunavo.com
export ANTHROPIC_AUTH_TOKEN=sk-kn-...
export ANTHROPIC_MODEL=claude-sonnet-5
export ANTHROPIC_DEFAULT_OPUS_MODEL=claude-opus-5-5
export ANTHROPIC_DEFAULT_SONNET_MODEL=claude-sonnet-5
export ANTHROPIC_DEFAULT_HAIKU_MODEL=claude-haiku-4-5

다음번에는 지루하게 만드세요

잔액 부족 알림(이메일)을 설정하고, 제공업체가 지원한다면 합리적인 월별 한도와 함께 자동 충전을 활성화하세요. 과금할 수 없을 때 요청을 차단하는 방식은 올바릅니다. 원하는 것은 차단 자체가 아니라 차단되기 전에 받는 경고입니다.

Kunavo를 통해 호출하는 경우

Kunavo는 잔액이 0이면 명시적인 402 insufficient_quota를 반환하며 안전하게 중단합니다(모호한 500이 아님). 실패한 요청에는 요금이 부과되지 않고, 활성 계정에는 잔액이 바닥나기 전에 자체 소진 속도와 남은 사용 가능 기간이 포함된 잔액 부족 이메일이 전송됩니다. 잔액은 $10부터 시작하는 선불 지갑이며 만료되지 않습니다. /app/billing에서 카드로 충전할 수 있고, 인도 외 지역에서는 Apple Pay, Google Pay 또는 Link를 사용할 수 있으며, Pix, WeChat Pay, UPI 또는 KakaoPay처럼 Stripe가 사용자의 통화에 맞춰 표시하는 현지 결제 수단도 사용할 수 있습니다. 특정 충전 금액으로 얼마나 사용할 수 있는지는 전적으로 어떤 모델을 지정하느냐에 달려 있으며, 모델별 요금은 다음에 있습니다. Anthropic Claude API 가격표.

자주 묻는 질문

충전했는데도 왜 계속 오류가 발생하나요?

키를 발급한 동일한 계정/워크스페이스에 충전했는지, 그리고 월별 지출 한도가 실제 원인이 아닌지 확인하세요. 잔액 자체는 Anthropic과 Kunavo 모두 즉시 적용됩니다.

Claude API에 무료 티어가 있나요?

아니요. Anthropic은 첫 번째 토큰부터 모든 API 호출에 과금합니다(Claude.ai 소비자 요금제는 API 크레딧과 별개입니다). 게이트웨이도 종량제이며, Kunavo는 목록 가격보다 낮은 요금으로 $10 충전부터 시작합니다.

Claude Code에서 “Credit balance is too low”가 표시되는데 Pro를 결제하고 있습니다. 왜 그런가요?

Claude Code가 구독이 아닌 API 키를 사용하기 때문입니다. ANTHROPIC_API_KEY 또는 ANTHROPIC_AUTH_TOKEN이 설정되어 있으면 Claude Code는 해당 키에 과금하고 Pro 또는 Max 로그인을 대기 상태로 두며, 키는 별도의 선불 Console 잔액을 사용합니다. /status를 실행해 현재 활성 자격 증명을 확인하세요. 요금제로 돌아가려면 변수를 해제하거나 키 잔액을 충전하세요.

OpenClaw에 “API provider returned a billing error”가 표시됩니다. 같은 문제인가요?

예. 이는 모델 제공업체의 과금 거부를 나타내는 OpenClaw의 표현입니다. API 키의 크레딧이 소진되었거나 잔액이 부족한 것입니다. 해당 제공업체를 충전하거나 OpenClaw을 다른 제공업체로 전환하세요. 아래 관련 가이드에서 옵션을 비교합니다.