Your credit balance is too low to access the Anthropic API: solución

«Your credit balance is too low to access the Anthropic API» significa que no tienes suficientes créditos de prepago para pagar el uso de la API de Claude. En Claude Code aparece como «Credit balance is too low». Si creías estar usando un plan como Pro o Max y aun así lo ves, la causa habitual es que la clave de API de la variable de entorno ANTHROPIC_API_KEY tiene prioridad sobre el inicio de sesión de tu plan, así que has pasado a la facturación de la API.

400 invalid_request_error
Your credit balance is too low to access the Anthropic API. Please go to Plans & Billing to upgrade or purchase credits.

Un ejemplo de la respuesta de la API. Aparece así en registros que los usuarios han pegado en el GitHub de Claude Code (un informe de abril de 2025, un informe de agosto de 2026). La lista de errores de la API de Anthropic no incluye esta frase exacta.

A partir de la documentación oficial de Claude Code y del Centro de ayuda de Anthropic (consultados el 26 de octubre de 2026), este artículo explica qué significa el error, cómo distinguir las causas, las dos soluciones y en qué se diferencia de los créditos mensuales de API incluidos en Max y Team y de los «créditos de uso» de tu plan. Las causas se marcan con colores como A Saldo y B Clave de API.

1. Qué significa el error y cómo aparece

La API de Claude es de prepago, salvo para las organizaciones con un contrato comercial que reciben factura a fin de mes. Según el artículo de ayuda de Anthropic, el uso de la API, del Playground y de Claude Code a través de una organización de la Claude Console se descuenta de los créditos que compras por adelantado y, cuando se acaban, no puedes llamar a la API hasta que añadas más. Este error te indica que has llegado a ese estado de saldo insuficiente.

«Plans & Billing», al final del mensaje, se refiere a la pantalla de facturación de la Console. En la Console actual puedes consultar el saldo y comprar créditos en la página Billing (platform.claude.com/settings/billing).

Fuentes: Anthropic, «How do I pay for my Claude API usage?»; Claude Code, «Error reference: Credit balance is too low». El mensaje antiguo procede de un informe en GitHub. Consultado el 26 de octubre de 2026.

La referencia oficial de errores de Claude Code da dos causas: los créditos de prepago de tu organización de la Console se han agotado, o querías usar una suscripción pero las solicitudes se envían con una clave de API de la Console. Son las causas A y B de arriba.

2. Tres preguntas para encontrar la causa

Respóndelas en orden y sabrás qué solución seguir.

1. P1 ¿Quieres usar Claude Code con un plan Pro, Max, Team o Enterprise?

   Sí Pasa a la P2. Si estás usando tu plan, este error no debería aparecer

   No (uso una clave de API o mi propia aplicación) Pasa a la P3

2. P2 ¿Muestra /status una clave de API?

   SíCausa B Una ANTHROPIC_API_KEY que aprobaste tiene prioridad sobre tu plan → Sección 4

   No Mira la línea del método de inicio de sesión. Si has iniciado sesión con una cuenta de la Console, pagas con el saldo de la Console → ejecuta /login para volver a entrar con la cuenta de tu plan (paso 5 de la sección 4)

3. P3 En Billing de la Console, ¿tiene saldo la organización de la clave?

   Ninguno o pocoCausa A Compra créditos → Sección 3

   Sí Comprueba si la clave pertenece a otra organización, si acabas de comprar los créditos y si solo tienes los créditos mensuales de Max o Team y los estás usando para algo que no cubren → Preguntas frecuentes

Base de la P2: la referencia de errores de Claude Code indica a los usuarios de un plan que vean este error que revisen la línea de la clave de API en /status. Para cambiar cuando tu método de inicio de sesión es la Console, consulta Anthropic, «Use Claude Code with your Pro or Max plan» (si has iniciado sesión con una cuenta de la Console de pago por uso, cambia a tu plan con /login).

Lo que pagas por un plan como Claude Pro no sirve para pagar la API. La ayuda de Anthropic dice que los planes y la Console son productos distintos y que la API se factura por separado (Why is Claude API usage billed separately from my paid Claude plan?). Aunque tengas un plan, necesitas saldo en la Console mientras uses una clave de API.

3. Causa A Añade créditos

Esta es la solución para quien usa una clave de API. Solo los miembros con el rol Admin o Billing en la organización de la Console pueden comprar créditos. Si es la organización de tu empresa, pídeselo a un administrador.

1. Abre la página Billing Inicia sesión en la Console y abre Billing. El saldo de créditos de la organización y lo gastado aparecen en la misma página. Si perteneces a más de una organización, asegúrate de haber seleccionado la organización donde se creó la clave que falla. El saldo es por organización y todas las claves de API de una misma organización consumen el mismo saldo.
2. Compra créditos Haz clic en «Buy credits», introduce un importe y confirma. Según el artículo de ayuda, los créditos comprados están disponibles de inmediato.
3. Activa la recarga automática (opcional) En la sección Credit balance, usa «Set up auto-reload» para introducir el saldo que activa la recarga (When credit balance reaches) y el saldo hasta el que se recarga (Bring credit balance back up to), y haz clic en «Turn on». Si tu saldo ya está en esa cantidad o por debajo, el botón pasa a ser «Turn on and purchase» y la compra se hace en el acto.
4. Reintenta lo que falló En Claude Code, envía de nuevo la misma instrucción.

Fuente: Anthropic, «How do I pay for my Claude API usage?» (pasos de compra, disponibilidad inmediata, configuración de la recarga automática, caducidad un año después de la compra, sin reembolsos). Consultado el 26 de octubre de 2026.

Los créditos comprados caducan un año después de la fecha de compra y no se reembolsan. Comprar solo lo que vayas a usar y dejar que la recarga automática te reponga cuando te quedes corto probablemente desperdicie menos. La referencia de errores de Claude Code también recomienda fijar límites de gasto por espacio de trabajo en la Console para que un solo proyecto no agote el saldo de la organización.

4. Causa B Elimina la clave de API y usa tu plan

Esta es la solución para quien quiere usar un plan Pro, Max, Team o Enterprise. Cuando hay varias credenciales, Claude Code elige una en un orden fijo, y la variable de entorno ANTHROPIC_API_KEY y apiKeyHelper en un archivo de configuración van por delante del inicio de sesión del plan que hiciste con /login. Cuando se usa la clave, como explica la ayuda de Anthropic, se te factura por uso a la organización de esa clave y, si esa organización no tiene saldo, te frena este error.

1. Comprueba con /status Ejecuta /status dentro de Claude Code y mira la línea de la clave de API. Cuando hay a la vez un inicio de sesión y una clave de API, se marca la que no está en uso.
2. Quítala de la shell actual Elimina la variable de la terminal que tienes abierta (comandos más abajo).
3. Elimina el origen de la clave Busca y borra la línea export ANTHROPIC_API_KEY=... de tu archivo de configuración de la shell, la variable de entorno de usuario de Windows y cualquier entrada en tu perfil de PowerShell ($PROFILE). Si no lo haces, la próxima terminal que abras la volverá a cargar. Según la referencia oficial de errores, herramientas como direnv o la terminal de un IDE pueden cargar la clave desde el archivo .env de un proyecto, así que revisa también el .env de la carpeta de tu proyecto. Cómo encontrarla en env o apiKeyHelper de los archivos de configuración de Claude Code se explica en nuestro artículo sobre «claude.ai connectors are disabled».
4. Vuelve a abrir la terminal e inicia claude La ayuda oficial cita como error frecuente cambiar las variables de entorno sin volver a abrir la terminal.
5. Ejecuta /login si hace falta y luego /status otra vez Si todavía no has iniciado sesión con la cuenta de tu plan, ejecuta /login. Cuando /status confirme que no se usa ninguna clave de API, habrás terminado.

# macOS / Linux: comprobar si está definida
env | grep ANTHROPIC
# Quitarla de la shell actual
unset ANTHROPIC_API_KEY
# Buscar qué archivo de configuración la define
grep -n ANTHROPIC_API_KEY ~/.zshrc ~/.bashrc ~/.bash_profile ~/.profile 2>/dev/null

# Windows (PowerShell): comprobar si está definida
Get-ChildItem Env:ANTHROPIC*
# Quitarla de la shell actual
Remove-Item Env:ANTHROPIC_API_KEY

# Windows (Símbolo del sistema): comprobar si está definida
echo %ANTHROPIC_API_KEY%
# Quitarla de la shell actual
set ANTHROPIC_API_KEY=

En Windows, elimina la configuración persistente de las variables de usuario en «Propiedades del sistema» → «Opciones avanzadas» → «Variables de entorno». Fuentes: Anthropic, «Manage API key environment variables in Claude Code»; Claude Code, «Authentication precedence» y «Error reference» (los comandos de comprobación y el .env están en la entrada «Invalid API key»). Consultado el 26 de octubre de 2026.

Si no quieres borrar la clave, puedes retirar tu aprobación. Cuando Claude Code se inicia en modo interactivo, la primera vez que encuentra ANTHROPIC_API_KEY pregunta una vez si quieres usarla y recuerda tu respuesta. Para cambiarla después, alterna «Use custom API key» en /config (esta opción solo aparece mientras la variable está definida). Sin embargo, con claude -p (no interactivo), la clave se usa siempre que esté presente. Si otros scripts necesitan la clave, pásala solo al ejecutar esos comandos.

Si aparece en la extensión de VS Code

En la extensión de Claude Code para VS Code se comprueba lo mismo. Escribe /status en el panel para ver tu cuenta y otros datos (Claude Code v2.1.280 o posterior). Según la documentación oficial, VS Code abierto desde una terminal con code . hereda las variables de entorno de esa shell. Si la clave está en el archivo de configuración de tu terminal, puede llegar también a la extensión. Después de eliminar la clave, cierra y vuelve a abrir VS Code antes de comprobarlo.

También puedes definir variables de entorno en el ajuste claudeCode.environmentVariables de la extensión. En la configuración, en Extensiones → Claude Code, comprueba que ANTHROPIC_API_KEY no esté definida ahí.

Fuente: Claude Code, «Use Claude Code in VS Code» (herencia de las variables de entorno, el ajuste environmentVariables, /status). Consultado el 26 de octubre de 2026.

5. Con qué se paga tu uso

Hay tres cosas que se llaman «créditos», y confundirlas lleva a malinterpretar este error: los créditos de API comprados en la Console, los créditos mensuales de API incluidos en Max y Team y los créditos de uso, que pagan el uso que supera los límites de tu plan Pro o Max. Esto es con qué se puede pagar cada tipo de uso.

Fuentes: Anthropic, «Monthly API credits for Max and Team plans» (Claude Code interactivo y los créditos de uso no están cubiertos; claude -p y el Agent SDK ejecutados por ti con una clave de API sí lo están); «Manage usage credits for paid Claude plans» (los créditos de uso se aplican tanto a Claude como a Claude Code una vez superados los límites del plan, y son independientes de los créditos mensuales de API); «Manage API key environment variables in Claude Code» (si hay una clave de API, se te factura por uso a la organización de esa clave); «How do I pay for my Claude API usage?». Consultado el 26 de octubre de 2026.

Lo que importa para este error son las dos columnas de la derecha (el saldo de tu organización de la Console). De la tabla se desprenden tres cosas.

• Si lo ves cuando crees estar en tu plan, estás en una de las filas de clave de API. Añadir saldo a tu plan o a los créditos de uso (las dos columnas de la izquierda) no lo arreglará, por mucho que añadas (causa B).
• Los créditos mensuales de API de Max y Team no sirven para Claude Code interactivo. Aunque los créditos de tu plan sigan apareciendo en la pantalla de saldo de la Console, no pueden pagar Claude Code interactivo con una clave de API. Cómo reclamarlos y en qué orden se consumen se explica en nuestro artículo sobre los créditos de API de Max y Team.
• Los créditos de uso son un saldo aparte en la configuración de claude.ai (Configuración → Uso). Como son independientes del saldo de la Console, recargarlos no ayuda con el uso mediante clave de API.

6. Errores parecidos pero distintos

Hay otros errores relacionados con saldos o límites. Distínguelos por cómo empieza el mensaje.

Fuentes: Claude API, «Rate limits» (los dos errores de límite de gasto); Claude Code, «Error reference». Consultado el 26 de octubre de 2026.

Para ver otros errores de Claude Code, consulta Errores comunes de Claude Code y cómo solucionarlos.

Resumen

Preguntas frecuentes

P. ¿Tiene la API de Claude un nivel gratuito?

R. La ayuda oficial no menciona ningún nivel gratuito. Después de crear una organización de la Console, la indicación es «añadir créditos al saldo de tu organización para usar la API y el Playground» (I created a Claude Console organization - how do I start using the Claude API?). La excepción son los créditos mensuales de API incluidos en los planes Max y Team; los planes Free, Pro y Enterprise no son aptos.

P. Tengo Claude Pro. ¿Por qué me sale este error?

R. Porque Claude Code está funcionando con una clave de API. La cuota de tu plan no puede pagar la API, así que, si la organización de la clave de API no tiene saldo, recibes este error. Comprueba con /status si se está usando una clave de API y elimínala siguiendo los pasos de la sección 4.

P. He comprado créditos, pero sigue saliendo el error.

R. Según el artículo de ayuda, los créditos comprados están disponibles de inmediato. Primero, comprueba que la organización donde creaste la clave es la misma en la que compraste los créditos. La página de estado de Anthropic registra una incidencia el 1 de septiembre de 2026 (UTC) en la que los créditos comprados tardaron en aplicarse a usuarios cuyo saldo había llegado a cero, y algunas solicitudes a la API devolvieron por error «credit balance is too low» (Delays in credit purchases). El 1 de octubre del mismo año hubo otra incidencia en la que las compras tardaron en aplicarse (Delayed credits on the Claude Platform). Si la organización coincide y el saldo aparece, consulta en status.claude.com si hay una incidencia en curso.

P. Aún me quedan créditos mensuales de API de Max, pero me sale este error en Claude Code.

R. Los créditos mensuales de API no sirven para Claude Code interactivo en la terminal, el IDE, la aplicación de escritorio o la web (la tabla de la sección 5). Para usar tu plan, elimina la clave de API y usa tu inicio de sesión; para usar una clave de API, compra créditos en la Console.