Claude API “credit balance is too low” / 402 insufficient_quota: solución

Este error no tiene nada que ver con tu código: el saldo prepago asociado a la clave está vacío (o se activó tu límite mensual de gasto). Así se diferencian los modelos de facturación de Anthropic Console y de los gateways, y estas son las alertas que evitan que vuelva a ocurrir a las 2 de la madrugada.

El error

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}}

Causas y soluciones de un vistazo

Causa	Solución
Saldo prepago realmente en cero	Recarga. En Anthropic: Console → Plans & billing. En Kunavo: /app/billing (el saldo nunca caduca).
Recarga automática desactivada (o la tarjeta caducó)	Activa la recarga automática o actualiza la tarjeta para que los picos de uso no agoten el saldo sin que nadie lo note.
Se alcanzó el límite mensual de gasto	Aumenta o elimina el límite por clave o espacio de trabajo si el gasto era legítimo.
Clave del espacio de trabajo equivocado	Las claves utilizan el saldo del espacio de trabajo que las creó: una organización con fondos no financia la clave de otro espacio de trabajo.

Confirma que sea un problema de saldo, no de autenticación

401 = problema con la clave; 400 “credit balance too low” / 402 insufficient_quota = problema de dinero. No rotes las claves por un error de facturación: la nueva clave leerá el mismo monedero vacío.

Recarga y verifica después con una llamada barata

Los saldos se aplican inmediatamente tanto en Anthropic como en Kunavo; no hace falta volver a desplegar. Verifica con una solicitud mínima antes de reactivar tus workers:

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

¿Lo ves en Claude Code?

Claude Code muestra este mensaje cuando se ejecuta con una clave de API de Anthropic cuyo saldo en Console está vacío; una cuenta Pro o Max alcanza los límites de uso y no muestra este mensaje. Recarga Console o sigue trabajando con un endpoint de pago por uso: Claude Code lee ANTHROPIC_BASE_URL de forma nativa, por lo que el cambio requiere unas pocas variables de entorno. Conserva las cuatro líneas de modelos: el modelo predeterminado de Claude Code y sus alias opus y sonnet siguen los modelos más recientes de Anthropic, y el alias sonnet solicita Sonnet 5.5, que Kunavo no ofrece.

~/.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

Haz que la próxima vez sea aburrida

Configura una alerta de saldo bajo (por correo electrónico) y, si tu proveedor lo admite, la recarga automática con un límite mensual razonable. Cerrar la facturación al llegar a cero es lo correcto; solo necesitas recibir el aviso antes del muro, no después.

Si llamas a través de Kunavo

Kunavo falla de forma segura con saldo cero y devuelve explícitamente 402 insufficient_quota, nunca un 500 impreciso. Las solicitudes fallidas no se facturan, y las cuentas activas reciben un correo de saldo bajo con una previsión de duración basada en su propio ritmo de consumo antes de agotarlo. El saldo es una cartera prepaga desde $10 que nunca caduca; se recarga en /app/billing con tarjetas, Apple Pay, Google Pay o Link fuera de India, o con un método local que Stripe muestre en tu moneda, como Pix, WeChat Pay, UPI o KakaoPay. El alcance de una recarga depende por completo del modelo al que la dirijas, y las tarifas por modelo aparecen en la lista de precios de la API de Anthropic Claude.

Preguntas frecuentes

He recargado; ¿por qué sigo recibiendo el error?

Comprueba que hayas financiado la misma cuenta o espacio de trabajo que creó la clave y que un límite mensual de gasto no sea el verdadero bloqueo. La aplicación del saldo es inmediata tanto en Anthropic como en Kunavo.

¿La API de Claude tiene un nivel gratuito?

No: Anthropic factura cada llamada a la API desde el primer token (los planes de consumo de Claude.ai son independientes del crédito de la API). Los gateways también funcionan con pago por uso; Kunavo comienza con una recarga de $10 y tarifas inferiores a las de lista.

“Credit balance is too low” en Claude Code, pero pago Pro. ¿Por qué?

Porque Claude Code utiliza una clave de API, no tu suscripción. Mientras ANTHROPIC_API_KEY o ANTHROPIC_AUTH_TOKEN estén definidos, Claude Code factura la clave y deja en pausa el inicio de sesión Pro o Max; esa clave utiliza un saldo prepago de Console separado. Ejecuta /status para ver qué credencial está activa; elimina la variable para volver al plan o recarga el saldo de la clave.

OpenClaw dice “API provider returned a billing error”. ¿Es lo mismo?

Sí. Es la forma de OpenClaw de indicar un rechazo de facturación por parte del proveedor del modelo: la clave de API se quedó sin créditos o tiene un saldo insuficiente. Recarga ese proveedor o cambia OpenClaw a otro; las guías relacionadas que aparecen abajo comparan las opciones.

Guías relacionadas

Encontrarás más detalles sobre el significado de los errores en referencia de errores; obtener una clave lleva un minuto mediante registro y la guía de autenticación.