Cuota de Gemini CLI: de dónde proviene ahora y qué hacer al alcanzar el límite

La cuota actual de Gemini CLI proviene de una relación de pago: una licencia Gemini Code Assist, que Google limita a 1,500 solicitudes por usuario al día en Standard y a 2,000 en Enterprise, o una clave con facturación por consumo —una clave de API de Gemini o una clave de Gemini Enterprise Agent Platform— para la que la página de límites de velocidad de Google no publica ningún recuento diario de solicitudes, sino únicamente límites por modelo que se consultan dentro de AI Studio. La fuente que todavía citan la mayoría de las respuestas —iniciar sesión con una cuenta personal de Google en el nivel gratuito, Google AI Pro o Google AI Ultra— dejó de servir a Gemini CLI el 18 de junio de 2026.

Esa fecha explica por qué esta pregunta es más difícil de lo que parece. El README del repositorio oficial de Google, obtenido de la rama main el 21 de septiembre de 2026, todavía anuncia «Free tier: 60 requests/min and 1,000 requests/day with personal Google account». No es un error que alguien haya corregido, y es la cifra que están copiando la mayoría de los artículos de terceros.

De dónde proviene hoy tu cuota de Gemini CLI

Dos fuentes oficiales establecen el corte. El anuncio de Google del 19 de mayo de 2026: «On June 18, 2026, Gemini CLI and Gemini Code Assist IDE extensions will stop serving requests for Google AI Pro and Ultra, as well as those using it free of charge using Gemini Code Assist for individuals.» Y la página de obsolescencias, cuyo pie indica como última actualización el 2026-09-02: «This also applies to usage of Gemini CLI. As part of the deprecation, you can no longer use the Login with Google option to access the IDE extensions or Gemini CLI.» Sus preguntas frecuentes responden directamente a la cuestión de Standard/Enterprise: esas suscripciones no se ven afectadas.

Las cifras actuales proceden de la página de cuotas de Code Assist de Google (última actualización: 2026-09-18), y su mecanismo importa más que los números. Las cuotas del modo agente y de Gemini CLI están combinadas; una indicación puede producir varias solicitudes al modelo; los límites diarios se «agregan entre todas las interacciones con cualquier versión o familia de modelos»; y, una vez alcanzado el máximo, «no se pueden realizar más solicitudes mediante estas interfaces a ningún modelo hasta que se restablezca la cuota». Por tanto, cambiar a un modelo más pequeño no te proporciona margen adicional en esta ruta, y una cifra de 1,500 no equivale a 1,500 indicaciones. Google no dice cuándo ocurre ese restablecimiento; la regla de medianoche del Pacífico que quizá hayas leído está documentada para la API de Gemini, no para la ruta de licencia, y trasladarla aquí sería una suposición.

Hay otra trampa en esa misma página: sus filas de «2 requests per second», 6,000 al día y 960 al día corresponden a las cuotas de Gemini para Google Cloud destinadas a la finalización de código y al chat del panel Cloud Assist. No son el presupuesto del modo agente de la CLI, y trasladar una cifra de un sistema al otro es incorrecto aunque ambas cifras sean reales.

Cuatro páginas oficiales de Google que te darán la cifra equivocada

geminicli.com no es un sitio ocupado por un tercero; es la página de inicio declarada por el propio repositorio, precisamente por eso resulta peligroso. Descártalo por estar desactualizado, no por ser no oficial. Su banner contradice actualmente el contenido de su propio cuerpo: «Unpaid tier and Google One users: Gemini CLI was replaced by Antigravity CLI on June 18th, 2026.» Cuando el banner y la tabla discrepan, el banner y la página de obsolescencias fechada son la información posterior.

Hay una pregunta que ninguna página oficial responde. En la ruta de clave de API, el blog del 19 de mayo de Google dice que la CLI sigue siendo accesible mediante claves de API de pago. La publicación de cierre del 18 de junio de los mantenedores solo añade que «Enterprise users with Gemini Code Assist licenses and API key authentication remain completely unaffected»; el sujeto de esa frase son los usuarios Enterprise, por lo que no afirma que una clave sin pago siga funcionando. Nada fechado después del 18 de junio aborda las claves sin pago, y la cifra de 250 solicitudes diarias para claves sin pago solo sobrevive en el documento de cuotas congelado. Considera una clave sin pago como no verificada, no como un presupuesto.

¿Qué ruta estoy usando y cómo es el límite?

Antes de cambiar nada, confirma la relación de facturación. Gemini CLI documenta /auth como «a dialog that lets you change the authentication method» y /stats model como una función que muestra «model-specific usage statistics, including token counts and quota information»; la documentación de cuotas añade que también aparece un resumen de uso al salir, al final de una sesión. Ambos comportamientos están documentados según la información consultada el 21 de septiembre de 2026, no probados aquí.

Dos fallos diferentes producen interrupciones de aspecto similar y tienen soluciones distintas. Un agotamiento de cuota está documentado como una situación que ofrece una opción concreta: «When you encounter that limit, you'll be given the option to switch to Gemini 2.5 Pro, upgrade for higher limits, or stop. You'll also be told when your usage limit resets», con una indicación adicional para cambiar a Gemini 2.5 Flash cuando se alcanza el límite de 2.5 Pro. Un error de capacidad es, en cambio, una sobrecarga del modelo: la documentación indica que la CLI pregunta si quieres seguir intentando usar Gemini 3 Pro o cambiar a Gemini 2.5 Pro, y que «Keep trying» utiliza retroceso exponencial. Esperar resuelve el segundo; solo un restablecimiento, una licencia o una ruta de facturación diferente resuelve el primero.

También existe un fallback que ocurre sin preguntar. La documentación indica que, cuando la CLI detecta una limitación de velocidad en el modelo «pro» predeterminado, «automatically switches to the 'flash' model for the current session», y que las llamadas internas de utilidad que usan gemini-2.5-flash-lite hacen un «silently fall back» a otros modelos cuando se agota la cuota, sin cambiar el modelo configurado. Con una clave de facturación por consumo, esto importa tanto para la factura como para el resultado: el modelo que respondió no siempre es el modelo que seleccionaste.

Las cuatro opciones al alcanzar el límite y el coste de cada una

El propio encabezado de la tabla de precios de Google Cloud dice «Gemini license type / License fees (monthly commitment) / License fees (12-month commitment)» y no imprime las palabras «per user» junto a la cifra; la cuota es explícitamente por usuario al día, así que interpreta la tarifa como por licencia hasta que confirmes las condiciones de los puestos en tu propio pedido.

Opción uno: esperar. Es gratuita y correcta cuando la interrupción es un error de capacidad, no un agotamiento de cuota. Opción dos: comprar una licencia. Es la única opción que aumenta la asignación diaria de solicitudes en la ruta de inicio de sesión, y es la que Google documenta para Gemini CLI. Opción tres: pasar a una clave con facturación por consumo. Esto elimina el límite diario de solicitudes y lo sustituye por facturación por token más un límite de gasto: la página de límites de velocidad de Google publica límites basados en el gasto de $10, $50 y $200 por cada diez minutos consecutivos para los niveles 1 a 3, devuelve 429 RESOURCE_EXHAUSTED cuando se superan y señala que los límites «are not guaranteed» y que las cifras por modelo solo están visibles en AI Studio. La página de facturación (última actualización: 2026-09-20) también registra un cambio de Postpay a Prepay para el uso de la API de Gemini, con una compra mínima de crédito de $5. La variante de Agent Platform de esta misma opción tiene su propio periodo gratuito: el modo Express (última actualización: 2026-09-18) permite a los nuevos usuarios de Google Cloud probarlo durante un máximo de 90 días sin proporcionar información de facturación, y afirma que el nivel gratuito de 90 días se elimina para los usuarios actuales de Cloud o una vez activada la facturación.

Opción cuatro: cambiar de cliente. La recomendación de la propia Google es Antigravity CLI, y conviene conocer el coste en flexibilidad antes de adoptarla: la documentación de planes de Antigravity indica que «currently no support for: Bring-your-own-key or bring-your-own-endpoint for additional rate limits»; a los usuarios que no tienen AI Pro o Ultra solo se les promete «Meaningful quota, refreshed weekly» y un «Weekly rate limit», sin publicar ninguna cifra en esa página; y la cuota de pago se «refreshed every five hours»; en Pro, «until weekly limit reached»; con límites que Google dice que están «correlated with the amount of work done by the agent», y no con el recuento de indicaciones. No se instaló ningún binario de Antigravity CLI para esta página, y no se afirma ninguna comparación de velocidad o compatibilidad.

Lo que no aumenta una cuota de Gemini CLI: una suscripción Google AI Plus a $4.99/mes o una suscripción Google AI Pro a $19.99/mes (gemini.google/subscriptions, comprobado el 21 de septiembre de 2026). Desde el 18 de junio de 2026, esas suscripciones compran límites para la aplicación Gemini y Antigravity. Los niveles AI Ultra de $100 y $200 proceden del anuncio de Google del 19 de mayo de 2026, no de la página de suscripciones, y tienen la misma salvedad.

Qué puede y qué no puede hacer un endpoint personalizado

Gemini CLI sí documenta una anulación de la URL base, y es más limitada de lo que parece. GOOGLE_GEMINI_BASE_URL sustituye la URL base de las solicitudes de la API de Gemini «when using gemini-api-key authentication», debe usar HTTPS salvo que apunte a localhost y tiene una variable hermana independiente, GOOGLE_VERTEX_BASE_URL, para la ruta de Vertex; desde entonces Google ha cambiado el nombre de esa plataforma a Gemini Enterprise Agent Platform, mientras que la CLI conservó los nombres antiguos de las variables. En el código fuente publicado de v0.60.0, establecer únicamente esa variable selecciona un tipo de autenticación que no aparece en ninguna documentación publicada (GATEWAY = 'gateway'), cuya clave vuelve a ser una cadena vacía. Interprétalo como código, no como una función compatible; puede cambiar sin una entrada en el registro de cambios.

De aquí se desprenden tres límites, y determinan si esto responde realmente a una cuestión de cuota. La URL base se pasa como httpOptions.baseUrl al SDK de GoogleGenAI, por lo que cada solicitud sigue utilizando el protocolo nativo de Google, autenticada de forma predeterminada con un encabezado x-goog-api-key; el enum de autenticación no contiene ningún proveedor compatible con OpenAI o Anthropic. La API de Kunavo solo es compatible con OpenAI y Anthropic Messages; su inventario de rutas en este commit incluye /v1/chat/completions, /v1/responses y /v1/messages, y no incluye ninguna ruta Gemini nativa generateContent; por tanto, no es un destino directo para esa variable, y ninguna página aquí debería decirte lo contrario. Es una inferencia basada en la forma del protocolo y el inventario de rutas, no una prueba en tiempo de ejecución. Además, la anulación solo existe en la ruta de clave de API, por lo que apuntar a cualquier gateway nunca aumenta, amplía ni restablece una asignación diaria del lado de Google; te cambia a otra relación de facturación, cuya cuota será entonces la que tenga esa cuenta.

Por tanto, la versión honesta de la opción de Kunavo es: cambia el cliente, no el endpoint. Gemini CLI frente a Claude Code compara ambos agentes, y la documentación de la clave de API de Gemini explica cómo se accede a los modelos de Gemini mediante una ruta compatible con OpenAI. Kunavo no ha probado en tiempo de ejecución ninguno de estos clientes contra su endpoint; una guía de configuración publicada es una referencia de configuración, no una prueba de compatibilidad.

Una estimación práctica si cambias de cliente

Estos son cálculos ilustrativos de tokens, no costes de tareas medidos ni un límite de facturación. Supón una sesión de agente que envía 300,000 tokens de entrada no almacenados en caché y recibe 20,000 tokens de salida. Las tarifas son precios actuales del catálogo de Kunavo por millón de tokens; compáralas con los precios de lista de Google de la tabla anterior.

No intentes convertir entre ambos mundos. Una licencia de Code Assist mide solicitudes por usuario al día, una clave por tokens mide tokens, y la propia Google afirma que una indicación puede producir varias solicitudes al modelo; por tanto, no existe una tasa de conversión entre $22.80 al mes y una cifra por sesión. La única comparación honesta es ejecutar la misma tarea acotada en ambos y consultar el registro propio de cada cuenta. El importe del catálogo de Kunavo es un mínimo de facturación, no un límite: cuando el proveedor ascendente informa de su cargo, la factura es el mayor valor entre el coste del catálogo y el coste del proveedor ascendente multiplicado por el margen aplicable. Los cargos de caché y las herramientas externas quedan fuera de este ejemplo, y la recarga mínima es $10 de crédito prepago; es un mínimo de financiación, no una tarifa por tarea ni una suscripción. Consulta los detalles de facturación.

Qué ruta gana en cada caso

Si vas a trasladar el trabajo a otro agente en lugar de a otro plan de Google, empieza por la integración con OpenCode o la configuración de Cline, compara las tarifas en el catálogo de modelos y crea una cuenta de Kunavo cuando estés listo para financiar una clave. Para conocer el panorama más amplio de precios de Gemini, consulta los precios de la API de Gemini; y para la misma cuestión sobre el nivel gratuito que desapareció en otro agente, consulta los límites de uso de Codex.

Preguntas frecuentes

Comprobado el 21 de septiembre de 2026: el aviso de obsolescencia de Google, la página de cuotas de Code Assist, la tabla de precios de Google Cloud, las páginas de precios, facturación y límites de velocidad de Gemini API, el corpus de documentación de geminicli.com y su página de cuotas, la página de planes de Antigravity, el README del repositorio, la API del repositorio de GitHub y el registro de npm (estable 0.60.0, publicado el 15 de septiembre de 2026). No se comprobó lo siguiente: no había instalado ningún binario de Gemini CLI ni de Antigravity CLI, no se había iniciado sesión en ninguna cuenta de Google y no se había dirigido ningún proxy al CLI; el límite de protocolo se lee del código fuente publicado de v0.60.0 y del propio inventario de rutas de Kunavo. Las tarifas de tokens de Kunavo proceden del catálogo activo y todas las cifras en dólares aquí son aritmética ilustrativa de tokens.