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

Verifica che si tratti del saldo, non dell'autenticazione

401 = problema della chiave; 400 "credit balance too low" / 402 insufficient_quota = problema di fondi. Non ruotare le chiavi per un errore di fatturazione: la nuova chiave legge lo stesso portafoglio vuoto.

Ricarica, poi verifica con una chiamata economica

I saldi si applicano immediatamente sia su Anthropic sia su Kunavo: non serve fare un nuovo deploy. Verifica con una richiesta minima prima di riattivare i tuoi worker:

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

Lo vedi in Claude Code?

Claude Code stampa questo messaggio quando viene eseguito con una chiave API Anthropic il cui saldo Console è esaurito; un accesso Pro o Max raggiunge invece i limiti di utilizzo e non mostra mai questo messaggio. Ricarica la Console oppure continua a lavorare su un endpoint a consumo: Claude Code legge nativamente ANTHROPIC_BASE_URL, quindi per passare bastano alcune variabili d'ambiente. Mantieni le quattro righe dei modelli: il modello predefinito di Claude Code e i suoi alias opus e sonnet seguono i modelli più recenti di Anthropic, mentre l'alias sonnet richiede Sonnet 5.5, che Kunavo non offre.

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

Fai in modo che la prossima sia noiosa

Imposta un avviso di saldo basso (email) e, se il provider lo supporta, la ricarica automatica con un limite mensile ragionevole. Il blocco della fatturazione in caso di esaurimento è corretto: vuoi solo ricevere l’avviso prima del muro, non sbatterci contro.

Su Kunavo: leggi il 402 o lascia che si ricarichi da solo

Un 402 del portafoglio Kunavo lo dice in forma leggibile da una macchina: error.code è insufficient_balance, error.balance_usd e error.needed_usd indicano la differenza, ed error.topup_url ed error.auto_recharge_url aprono la pagina di fatturazione con la soluzione già selezionata — nessuno dei due link addebita nulla. Con la ricarica automatica facoltativa attiva, il portafoglio si ricarica da solo dell’importo che scegli, a partire da $10 ed entro un tetto mensile che imposti tu, ogni volta che scende sotto la tua soglia: una richiesta che sarebbe stata rifiutata viene così servita, purché l’addebito vada a buon fine e il tetto mensile abbia ancora margine. Finché una ricarica del genere è ancora in corso, il 402 riporta Retry-After: riprova dopo quel tempo e smetti di riprovare un 402 che non lo riporta.

Ho ricaricato: perché continuo a ricevere l’errore?

Verifica di aver finanziato lo stesso account/workspace che ha generato la chiave e che il vero blocco non sia un limite mensile di spesa. L’applicazione del saldo è immediata sia su Anthropic sia su Kunavo.

L’API di Claude ha un piano gratuito?

No: Anthropic addebita ogni chiamata API dal primo token (i piani consumer Claude.ai sono separati dal credito API). Anche i gateway sono pay-as-you-go; Kunavo parte da una ricarica di $10 con tariffe inferiori a quelle di listino.

“Credit balance is too low” in Claude Code, ma pago Pro. Perché?

Perché Claude Code sta usando una chiave API, non il tuo abbonamento. Finché è impostato ANTHROPIC_API_KEY o ANTHROPIC_AUTH_TOKEN, Claude Code addebita la chiave e mette in pausa l’accesso Pro o Max; quella chiave attinge a un saldo Console prepagato separato. Esegui /status per vedere quale credenziale è attiva; rimuovi la variabile per tornare al piano oppure ricarica il saldo della chiave.

OpenClaw dice “API provider returned a billing error”: è la stessa cosa?

Sì. È il modo in cui OpenClaw descrive un rifiuto di fatturazione da parte del provider del modello: la chiave API ha esaurito i crediti o ha un saldo insufficiente. Ricarica quel provider oppure passa OpenClaw a un altro; le guide correlate qui sotto confrontano le opzioni.