Español
Todos los artículos
Claude CodeClaudeErrores y soluciones

Credit balance is too low en Claude Code: qué significa y 3 pasos fáciles para arreglarlo

Credit balance is too low en Claude Code con Pro o Max suele venir de ANTHROPIC_API_KEY. Revisa /status, quita la variable y usa /login. Solución verificada.

4 min de lectura
También disponible en中文English

El mensaje Credit balance is too low en Claude Code significa que la solicitud salió con una cuenta de Claude Console que se quedó sin créditos de prepago. Si pagas Pro o Max, la suscripción no genera este error. Casi siempre la causa es una variable ANTHROPIC_API_KEY que sigue en tu entorno: Claude Code usa esa clave y cobra a la cuenta de API, que está vacía. Se arregla en tres pasos: ejecuta /status para ver qué credencial está activa, haz unset ANTHROPIC_API_KEY y bórrala del perfil de tu shell, y vuelve a abrir Claude Code para iniciar sesión con /login. Comprobamos el texto exacto y cada paso en la referencia oficial de errores de Claude Code el 4 de noviembre de 2026.

credit balance is too low claude code: la clave de API se usa antes que la suscripción

Credit balance is too low en Claude Code: qué significa

El mensaje es una sola línea:

Credit balance is too low

La documentación oficial da dos causas:

  • tu organización de Claude Console se quedó sin créditos de prepago;
  • Claude Code envía tus solicitudes con una clave de API de Console cuando querías usar tu suscripción.

A los usuarios de Pro y Max les pasa casi siempre lo segundo. Mucha gente añadió en su día export ANTHROPIC_API_KEY=... a ~/.zshrc o ~/.bashrc para probar la API, luego contrató la suscripción y se olvidó de la variable. Esa cuenta de API ya no tiene saldo.

Por qué Claude Code usa la clave de API si tengo Pro o Max

Claude Code elige la credencial en un orden fijo. Según la documentación de autenticación, ANTHROPIC_AUTH_TOKEN, ANTHROPIC_API_KEY y apiKeyHelper van por delante del inicio de sesión de la suscripción, que queda en último lugar.

  • En modo interactivo, Claude Code pregunta una vez si quieres usar ANTHROPIC_API_KEY. Si dijiste que sí, la sigue usando.
  • En modo no interactivo (claude -p), la clave se usa siempre que exista, sin preguntar.
  • La extensión de VS Code lee la misma variable, así que la solución es la misma.

Cómo solucionar credit balance is too low en Claude Code

Paso 1: revisa la credencial con /status

Escribe /status dentro de Claude Code y mira la fila API key. Si hay inicio de sesión y clave de API a la vez, /status marca la que no se está usando. Si la activa es la clave, ya tienes la causa.

Paso 2: quita ANTHROPIC_API_KEY

En macOS, Linux o WSL, en la terminal actual:

unset ANTHROPIC_API_KEY

En Windows PowerShell:

Remove-Item Env:ANTHROPIC_API_KEY

Esto solo afecta a la ventana actual. Para que sea permanente, borra la línea export ANTHROPIC_API_KEY=... de ~/.zshrc, ~/.bashrc o ~/.profile. En Windows revisa también $PROFILE y las variables de entorno de usuario. Este comando te dice qué archivo la define:

grep -n "ANTHROPIC_API_KEY" ~/.zshrc ~/.bashrc ~/.profile 2>/dev/null

Paso 3: reinicia Claude Code y ejecuta /login

Cierra y vuelve a abrir claude. Si nunca iniciaste sesión con tu suscripción, ejecuta /login y elige tu cuenta de Claude. Comprueba otra vez con /status.

Si necesitas la variable para otras herramientas, desactiva «Use custom API key» en /config. Esa opción solo aparece mientras ANTHROPIC_API_KEY está definida, y claude -p la ignora.

Si usas la API de verdad: recarga saldo

Si querías pagar por uso con una clave de API, el saldo está realmente a cero:

  • recarga en platform.claude.com/settings/billing y activa la recarga automática (auto-reload);
  • pon límites de gasto por espacio de trabajo en la Console para que un proyecto no agote el saldo de toda la organización.

Los límites de gasto dan otro error, explicado en límite de gasto mensual en Claude Code. Para entender cómo se cuenta el uso de la suscripción, mira la cuota de Claude Pro y Max.

Lista rápida

  1. /status muestra una clave de API activa: quita la variable y vuelve a iniciar sesión.
  2. /status muestra la suscripción y el error sigue: busca un apiKeyHelper o ANTHROPIC_AUTH_TOKEN. Es una deducción nuestra: ambos van por delante de la suscripción, aunque la página de errores solo nombra ANTHROPIC_API_KEY.
  3. Solo falla en claude -p, CI o scripts: revisa las variables de ese entorno.
  4. Usas la API: recarga saldo.

Si la sesión caducó, mira Claude Code API Error 401 OAuth token has expired. Para el resto, consulta la lista de errores de Claude Code.

Preguntas frecuentes

Tengo Max. ¿Tengo que comprar créditos de API?

No. La suscripción y Claude Console se facturan por separado. Sin ANTHROPIC_API_KEY, Claude Code usa tu suscripción.

El error volvió al abrir otra terminal

unset solo vale para la ventana actual. Una terminal nueva vuelve a leer el perfil de la shell, así que borra la línea del archivo.

¿Puedo tener una clave del trabajo y una suscripción personal?

Sí, pero Claude Code usa una cada vez. Quita la variable para usar la suscripción; para volver a la clave, expórtala de nuevo y activa «Use custom API key» en /config.