Claude API “credit balance is too low” / 402 insufficient_quota — a solução

Confirme que é saldo, não autenticação

401 = problema na chave; 400 "credit balance too low" / 402 insufficient_quota = problema de dinheiro. Não faça rotação de chaves por um erro de faturamento — a nova chave lê a mesma carteira vazia.

Adicione saldo e verifique com uma chamada barata

Os saldos são aplicados imediatamente tanto na Anthropic quanto na Kunavo — não é necessário fazer novo deploy. Verifique com uma solicitação mínima antes de reativar seus workers:

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?"}]}'

Isso aparece no Claude Code?

O Claude Code exibe esta mensagem quando é executado com uma chave de API da Anthropic cujo saldo no Console está vazio — um login Pro ou Max encontra limites de uso e não exibe esta mensagem. Recarregue o Console ou continue trabalhando em um endpoint pré-pago: o Claude Code lê ANTHROPIC_BASE_URL nativamente, então a mudança exige apenas algumas variáveis de ambiente. Mantenha as quatro linhas de modelo — o modelo padrão do Claude Code e seus aliases opus e sonnet acompanham os modelos mais recentes da Anthropic, e o alias sonnet solicita o Sonnet 5.5, que o Kunavo não oferece.

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

Faça com que a próxima ocorrência seja entediante

Configure um alerta de saldo baixo (e-mail) e, se o provedor oferecer suporte, a recarga automática com um limite mensal sensato. O bloqueio do faturamento quando o saldo acaba é correto — você só quer o aviso antes da barreira, não depois dela.

Na Kunavo: leia o 402 ou deixe a recarga acontecer sozinha

Um 402 da carteira Kunavo diz isso de forma legível por máquina: error.code é insufficient_balance, error.balance_usd e error.needed_usd mostram a diferença, e error.topup_url e error.auto_recharge_url abrem a página de cobrança com a solução já selecionada — nenhum dos dois links cobra nada. Com a recarga automática opcional ligada, a carteira se recarrega sozinha no valor que você escolher, a partir de $10 e dentro de um limite mensal que você define, sempre que cair abaixo do seu limite mínimo; assim, uma requisição que seria recusada é atendida — desde que a cobrança seja aprovada e o limite mensal ainda tenha margem. Enquanto essa recarga ainda está em andamento, o 402 traz Retry-After: tente de novo depois desse prazo e pare de tentar de novo um 402 que não o traga.

Adicionei saldo — por que ainda recebo o erro?

Verifique se você financiou a mesma conta/workspace que criou a chave e se um limite mensal de gastos não é o verdadeiro bloqueio. A aplicação do saldo é imediata tanto na Anthropic quanto na Kunavo.

A API da Claude tem uma camada gratuita?

Não — a Anthropic cobra cada chamada da API desde o primeiro token (os planos para consumidores do Claude.ai são separados dos créditos da API). Gateways também funcionam no modelo pré-pago; a Kunavo começa com uma recarga de $10 e tarifas abaixo da tabela.

“Credit balance is too low” no Claude Code — mas eu pago pelo Pro. Por quê?

Porque o Claude Code está usando uma chave de API, não sua assinatura. Enquanto ANTHROPIC_API_KEY ou ANTHROPIC_AUTH_TOKEN estiver definido, o Claude Code cobra a chave e deixa o login Pro ou Max em espera; essa chave usa um saldo pré-pago separado do Console. Execute /status para ver qual credencial está ativa; remova a variável para voltar ao plano ou adicione saldo à chave.

O OpenClaw diz “API provider returned a billing error” — é a mesma coisa?

Sim. Essa é a forma como o OpenClaw descreve uma recusa de faturamento do provedor do modelo: a chave da API ficou sem créditos ou tem saldo insuficiente. Adicione saldo a esse provedor ou troque o OpenClaw para outro — os guias relacionados abaixo comparam as opções.