Claude Code monthly spend limit: cómo arreglar «You’ve hit your monthly spend limit» (probado)

Respuesta corta: el aviso de Claude Code monthly spend limit, You've hit your monthly spend limit · raise it at https://claude.ai/settings/usage?from=cc_cli_limit_message, quiere decir que el uso incluido en tu plan no alcanza para la petición y que los créditos de uso (usage credits) llegaron al tope mensual que configuraste. En Pro o Max, sube el tope en claude.ai en Settings > Usage o ejecuta /usage-credits. Antes, mira el final de la línea: si pone algo como · your session limit resets 3:45pm, lo que se agotó fue una ventana del plan y también puedes esperar a esa hora. Añadir saldo no sirve cuando lo que está lleno es el tope. Los textos y las soluciones salen de la referencia oficial de errores de Claude Code, revisada el 29 de octubre de 2026. No pudimos provocar el límite mensual en una cuenta real, así que nuestra prueba usa una API simulada; los detalles, más abajo.

Qué significa el aviso de Claude Code monthly spend limit

Según la documentación, aparece en dos casos: se agotó una de las ventanas de uso del plan y los créditos de uso que pagarían el resto están en su tope, o la petición es de las que solo se pagan con créditos de uso. Las primeras palabras dicen de quién es el límite, y lo que va después del · dice quién puede subirlo:

You've hit your monthly spend limit · raise it at https://claude.ai/settings/usage?from=cc_cli_limit_message
You've hit your individual spend limit · ask your admin for a higher limit
You've hit your org's monthly spend limit · visit https://claude.ai/admin-settings/usage to raise it
You've hit your team's shared budget · ask your admin to raise it at https://claude.ai/admin-settings/usage
You've hit your channel's monthly spend limit · an org owner or channel manager can raise it in the channel's Claude settings

En organizaciones con facturación por uso, spend limit cambia a usage limit. El artículo del centro de ayuda añade un dato importante: con los créditos de uso activados, sigues trabajando hasta llegar al tope de gasto mensual o, si la recarga automática está desactivada, hasta que se acabe el saldo. Tope y saldo son cosas distintas.

Nuestra prueba: avisos de Claude Code monthly spend limit con una API simulada

Para ver el límite mensual real hace falta una suscripción de claude.ai con los créditos de uso en su tope, y no teníamos ninguna en ese estado. Simular un inicio de sesión Pro guardado tampoco funcionó: Claude Code intentó renovarlo y se detuvo con Failed to authenticate: OAuth session expired and could not be refreshed. Por eso la línea exacta de Pro/Max viene de la documentación, no de nuestra pantalla.

Lo que sí hicimos fue apuntar Claude Code 2.1.312 a una API local con ANTHROPIC_BASE_URL, con un CLAUDE_CODE_OAUTH_TOKEN de prueba, y hacer que respondiera con un 429 y las cabeceras de uso que lee la CLI. Con la ventana de 5 horas rechazada y los créditos marcados en su tope, claude -p hi terminó con:

You've hit your individual spend limit · ask your admin to raise it at https://claude.ai/admin-settings/usage · your 5-hour limit resets Nov 3, 12:20am (Asia/Shanghai)

Un token pasado por variable de entorno no lleva tipo de plan, así que Claude Code eligió el texto individual y mandó a la página del admin; la documentación dice que el texto cambia según el plan y según si gestionas la facturación. La hora de reinicio es la que envió la API simulada, en la zona horaria del equipo de prueba. Con el mismo 429 pero indicando que los créditos se quedaron sin saldo en lugar de llegar a su tope, el aviso fue You've hit your 5-hour limit · resets Nov 3, 12:20am (Asia/Shanghai). Dos parecidos de pruebas anteriores: un 429 de tipo gateway dio API Error: Request rejected (429) · spend limit reached (daily; resets 2026-10-29 00:00 UTC), y una key de Console sin créditos dio Credit balance is too low.

Cómo solucionar el Claude Code monthly spend limit

• Lee el final del aviso. Si hay un · your ... limit resets ..., el acceso vuelve a esa hora sin que nadie suba nada. Ejecuta /usage para ver cada ventana y cuándo se reinicia.
• Pro o Max: sube el tope en claude.ai, en Settings > Usage, apartado Usage credits («Adjust limit»), o ejecuta /usage-credits desde Claude Code.
• ¿Contrataste el plan desde la app de iOS o Android? Según el centro de ayuda, los créditos de uso solo se activan en Claude en la web, tras añadir allí un método de pago.
• Team o Enterprise: si gestionas la facturación, súbelo en Organization settings > Usage. Si no, ejecuta /usage-credits, que envía la solicitud a tu admin.
• Límite de canal: lo sube el propietario de la organización o quien gestione el canal, en claude.ai. Otros canales de tu organización pueden tener presupuesto.
• Tareas desatendidas: según la documentación, Claude Code falla al momento con un 429 de tope de gasto, incluso con CLAUDE_CODE_RETRY_WATCHDOG=1, así que los reintentos no lo esperan.

Comprueba que de verdad es el Claude Code monthly spend limit

Varios avisos dicen «limit» y cada uno se arregla distinto:

• Solo You've hit your session limit o weekly limit: se agotó la ventana del plan. Cómo funcionan las ventanas, en nuestra guía de la cuota de Claude Pro y Max.
• spend limit reached en minúsculas: un tope que puso quien opera un gateway de Claude apps. Solo esa persona puede subirlo; consulta la sección del gateway en la documentación.
• Credit balance is too low: una API key de Console sin créditos prepagados, o un ANTHROPIC_API_KEY sobrante que se usa en lugar de tu suscripción. Compruébalo con /status.
• Solo Request rejected (429): es limitación de tasa; lo explicamos en el error 429 de Claude Code.

Ojo también con los créditos de API mensuales que trae Max: son otra bolsa y, según el centro de ayuda, no pagan los créditos de uso en Claude Code; más en créditos de API de Claude Max.

Lo que reportaron los usuarios en GitHub

• Issue #75730 (abierto, v2.1.204): un subagente se detuvo con el aviso de límite mensual cuando, según quien lo reportó, solo se había agotado la ventana de 5 horas; el trabajo volvió al reiniciarse. Con la documentación actual, esa combinación es la esperada si los créditos también están en su tope, y el sufijo de reinicio es la pista.
• Issue #101270 (abierto, v2.1.296): compró 100 dólares de créditos de uso dos veces y pudo seguir; la tercera vez, con saldo en la cuenta, Claude Code seguía diciendo que había llegado al límite mensual. Encaja con lo que separa el centro de ayuda entre saldo y tope: revisa el tope antes de añadir más dinero.
• Issue #101923 (abierto): un usuario de Ultra (antes Max 20x) cuenta 18 rechazos el 7 de octubre, y ahora Settings > Usage le muestra «No spend limit» (dice que configuró un tope en algún momento y está comprobando cuándo). Ese día la página de estado publicó «Issue with spend limits», donde se dice que algunas organizaciones quedaron «incorrectly paused for having reached their spend limit». Si ves el aviso y tu tope parece correcto, mira la página de estado antes de pagar nada.

Más errores en nuestra guía de errores de Claude Code.

Preguntas frecuentes

¿El Claude Code monthly spend limit se reinicia solo?

El centro de ayuda lo describe como un tope de lo que gastas cada mes. Si el aviso también indica cuándo se reinicia una ventana del plan, el acceso vuelve a esa hora aunque nadie suba el tope.

¿Sirve añadir saldo?

No si lo que está lleno es el tope. Primero sube el tope; añadir saldo solo ayuda cuando se acabó el saldo.

¿Puedo quitar el tope?

El centro de ayuda dice que al ajustar el límite puedes elegir «Set to unlimited», si te parece bien no tener techo de gasto.

¿Es una limitación de tasa?

No. La limitación de tasa es un freno a corto plazo. Este aviso es de facturación, así que reintentar no sirve.