Alternativas a Gemini CLI: elige según el flujo de trabajo y el control de la API

Gemini CLI no está retirado, pero su puerta gratuita sí; por eso «alternativas» se divide en dos decisiones distintas. El repositorio sigue activo: google-gemini/gemini-cli no está archivado, tiene licencia Apache-2.0 y recibió su último push el 21 de septiembre de 2026; la versión estable de npm @google/gemini-cli es 0.60.0, publicada el 15 de septiembre de 2026, las compilaciones nocturnas siguen generándose a diario y no hay marca de obsolescencia (API de GitHub y npm, comprobadas el 21 de septiembre de 2026). Lo que terminó fue el acceso. Si te vas porque el inicio de sesión dejó de funcionar, necesitas un nuevo acceso. Si te vas porque quieres tu propio endpoint detrás del agente, necesitas un nuevo cliente; y esa segunda decisión la determina una barrera de protocolo, no una preferencia.

Una aclaración antes de cualquier cifra. Un exchange de criptomonedas llamado también Gemini publica su propia documentación de «Gemini API» y su propio esquema de tarifas; MacPaw vende un buscador de archivos duplicados para macOS llamado Gemini 2, y el protocolo gemini:// tiene sus propios navegadores de terminal. Ninguno de sus precios pertenece a esta página. Los nombres propios de Google también se dividen en seis: Gemini CLI, Antigravity CLI, Gemini Code Assist, las suscripciones de la aplicación Gemini, la API de Gemini y Gemini Enterprise Agent Platform; por eso cada cifra que aparece a continuación indica de cuál procede.

Por qué la gente está abandonando Gemini CLI ahora

Google anunció el 19 de mayo de 2026 que estaba trasladando Gemini CLI a Antigravity CLI, indicando que «El 18 de junio de 2026, Gemini CLI y las extensiones IDE de Gemini Code Assist dejarán de atender solicitudes de Google AI Pro y Ultra, así como de quienes lo utilicen gratuitamente». La página de obsolescencia para consumidores de Google, actualizada por última vez el 2 de septiembre de 2026, añade que «ya no puedes utilizar la opción Login with Google para acceder a las extensiones IDE o a Gemini CLI», que las suscripciones Standard y Enterprise «no cambian» y que los usuarios afectados pueden migrar a la familia Antigravity.

Espera que una fuente obsoleta contradiga todo esto. El README de main todavía anuncia «60 solicitudes/min y 1.000 solicitudes/día con una cuenta personal de Google», repite otras dos veces el nivel gratuito y no menciona Antigravity ni el 18 de junio en ningún punto (obtenido el 21 de septiembre de 2026). Las páginas de obsolescencia fechadas de Google son la información posterior; el README es la trampa.

La segunda trampa es un precio de suscripción utilizado como referencia. Google AI ofrece un nivel gratuito a 0 $, Plus a 4,99 $ al mes y Pro a 19,99 $ al mes, y el anuncio del 19 de mayo de 2026 de Google indica Ultra a 100 $ y 200 $ al mes; pero son suscripciones de la aplicación Gemini, y Pro es precisamente el nivel para el que la publicación sobre la transición señala que se dejaron de atender solicitudes, junto con Ultra y Code Assist gratuito para particulares. Ningún nivel de esa página de suscripciones está documentado como una compra de cuota de Gemini CLI. No se verificó si las cifras de Ultra siguen vigentes en una página de precios actual; la página de suscripciones no incluye Ultra.

Seguir usando Gemini: cuánto cuesta Gemini CLI una vez cerrada la puerta gratuita

Quedan dos rutas con medición. La ruta de licencia es una compra por puesto, y las cuotas de Gemini Code Assist (pie de página fechado el 18 de septiembre de 2026) la limitan por número de solicitudes, indicando que los límites diarios están «agregados entre todas las interacciones con cualquier versión o familia de modelos (por ejemplo, Pro, Flash) utilizada con Gemini CLI o el modo de agente»; por tanto, un prompt puede gastar varias solicitudes y cambiar a un modelo más barato no proporciona margen adicional.

Precios consultados en la página de precios de Gemini de Google el 21 de septiembre de 2026; la página también muestra equivalentes por hora e indica que las suscripciones se facturan mensualmente. La ruta de la clave se cobra por tokens. Los precios de la API de Gemini, actualizados por última vez el 16 de septiembre de 2026, incluyen estos dos modelos entre otros; las cifras de Flash son un precio introductorio fechado que aumenta posteriormente, el tipo de cifra que queda obsoleta en una publicación de blog.

Esa misma página enumera una Batch API con una reducción de costes del 50 % y muestra columnas de lotes para estos modelos a la mitad de las tarifas estándar. Observa la tarificación por niveles de contexto en Pro: un bucle agéntico vuelve a enviar su contexto en cada paso, por lo que citar solo la tarifa aplicable a un contexto de menos de 200.000 tokens subestima el coste. Aquí no se extrajeron las partidas de almacenamiento en caché, grounding ni uso de herramientas; considera, por tanto, estas cifras como tarifas base por tokens, no como un total. La cuota de Gemini CLI cubre con más detalle el aspecto del recuento de solicitudes.

La barrera que decide tu lista de opciones

Gemini CLI sí admite un endpoint personalizado. Su referencia de configuración incluida en el repositorio documenta GOOGLE_GEMINI_BASE_URL como una sobrescritura de «la URL base predeterminada para las solicitudes a la API de Gemini (cuando se utiliza la autenticación gemini-api-key)», exige HTTPS salvo que el destino sea localhost y dispone de un GOOGLE_VERTEX_BASE_URL independiente para la ruta que Google posteriormente renombró como Gemini Enterprise Agent Platform. El sitio de documentación renderizado de Google no muestra ninguna sobrescritura de URL base, por lo que la variable está documentada en el repositorio, pero no en el sitio publicado: es real, aunque fácil de pasar por alto.

El problema está en el formato de transmisión. En el código fuente publicado en main, esa URL se pasa al SDK @google/genai como httpOptions.baseUrl con vertexai establecido en false, por lo que cada solicitud sale usando el protocolo nativo de Gemini de Google, y el enum de autenticación no ofrece ninguna opción compatible con OpenAI ni con Anthropic. De forma predeterminada, la clave viaja en un encabezado x-goog-api-key; el mismo archivo lee GEMINI_API_KEY_AUTH_MECHANISM, y establecerlo en bearer mueve la clave a un encabezado Authorization en las rutas gemini-api-key y vertex-ai, lo que cambia el encabezado, no el formato de transmisión, así que tampoco sirve como salida. Ese código fuente también contiene un tipo de autenticación GATEWAY no documentado, seleccionado desde el entorno cuando se establece GOOGLE_GEMINI_BASE_URL, por delante de GEMINI_API_KEY y solo por detrás de los interruptores explícitos de inicio de sesión de Google y Vertex; su clave recurre a una cadena vacía. La palabra «gateway» no aparece en ninguna parte de la documentación de configuración, se interpretó a partir del código y no como un contrato de API, y sigue hablando el protocolo nativo, por lo que no soluciona nada.

Kunavo ofrece /v1/chat/completions, /v1/messages y /v1/responses. Vuelto a probar el 21 de septiembre de 2026: api.kunavo.com/v1/models responde 401, mientras que /v1beta/models y /v1beta/models/<model>:generateContent responden 404. Kunavo no es un destino válido para GOOGLE_GEMINI_BASE_URL, y fingir lo contrario te haría perder una tarde. Cambia el cliente, no el endpoint.

Kunavo tampoco ofrece ningún modelo de embeddings, conversión de texto a voz ni conversión de voz a texto, por lo que un flujo de trabajo que necesite cualquiera de ellos conserva su proveedor actual para ese paso.

Antigravity CLI hereda la misma limitación. Su documentación de instalación y autenticación indica que puedes ejecutarlo «con tu propia clave de API de Gemini en lugar de una cuenta de Google con sesión iniciada» y establecer GOOGLE_GEMINI_BASE_URL para acceder a «otro endpoint compatible con Gemini»: compatible con Gemini, no compatible con OpenAI. Por separado, su página de planes declara que actualmente no admite «usar tu propia clave o tu propio endpoint para obtener límites de frecuencia adicionales». Son afirmaciones compatibles y el matiz es determinante: puedes usar tu propia clave, pero hacerlo no te proporciona cuota de suscripción. Su nivel Individual aparece con un precio de 0 $ al mes (comprobado el 21 de septiembre de 2026), y no se publica ningún límite numérico de frecuencia para ningún nivel. Interpreta estrictamente las inclusiones de ese nivel: la lista que aparece debajo menciona acceso a modelos, finalizaciones de pestañas ilimitadas, solicitudes de comandos ilimitadas y «Límites de frecuencia semanales básicos», pero no menciona la CLI; el único plan que menciona la CLI en esa página es el plan para organizaciones mediante Google Cloud. Esa página tampoco responde si el nivel gratuito permite acceder a agy.

Qué alternativa encaja con cada motivo para marcharte

Estado obtenido de la API REST de GitHub y del registro npm el 21 de septiembre de 2026. Una advertencia sobre OpenCode: otro repositorio, opencode-ai/opencode, está archivado desde septiembre de 2025 y continuó como Crush, por lo que la configuración o los precios encontrados allí describen la línea de desarrollo de Crush, no la de OpenCode. Compara ambos en Crush frente a OpenCode y consulta Precios de Qwen Code para saber cuánto cuestan sus rutas.

Qué se migra y qué dejas atrás

Qwen Code es el salto más corto, así que es el que merece un cálculo preciso. Ambas partes se consultaron en su propia documentación el 21 de septiembre de 2026: la referencia de configuración y la referencia de extensiones de Gemini CLI, y las páginas de configuración y autenticación de Qwen Code. La afirmación sobre la línea de desarrollo procede del propio README de Qwen Code, que indica que el proyecto se basó originalmente en Gemini CLI v0.8.2 y dejó de sincronizarse con el proyecto original en Qwen Code v0.1.

La ruta de Antigravity tiene su propia historia de migración, más limitada de lo que parece a primera vista: su descripción general de la CLI indica que la incorporación «admite una importación única para migrar automáticamente tus extensiones, habilidades y configuraciones existentes de Gemini CLI». Menciona esas tres cosas y guarda silencio sobre el historial de chats, los puntos de control y el historial del shell; eso no constituye ni una promesa ni una negación sobre ellos.

En la ruta de Qwen Code, todo el cambio consiste en un único bloque de configuración combinado. Establece la clave en tu entorno, indica la URL base en la raíz /v1 de la API en lugar de la ruta completa de chat-completions y conserva GEMINI.md en la lista de contexto para que las instrucciones existentes de tu proyecto sigan cargándose:

{
  "context": { "fileName": ["QWEN.md", "GEMINI.md"] },
  "modelProviders": {
    "openai": [
      {
        "id": "claude-sonnet-4-6",
        "name": "Claude Sonnet 4.6 (Kunavo)",
        "baseUrl": "https://api.kunavo.com/v1",
        "envKey": "KUNAVO_API_KEY"
      }
    ]
  },
  "env": { "KUNAVO_API_KEY": "sk-kn-..." },
  "security": { "auth": { "selectedType": "openai" } },
  "model": { "name": "claude-sonnet-4-6" }
}

Es fácil volver atrás y conviene prepararlo antes de empezar. Nada de esto modifica tu instalación de Gemini CLI: ~/.gemini/ no se toca al configurar Qwen Code, y si aún tienes una licencia Code Assist Standard o Enterprise o una clave de Gemini de pago, gemini sigue funcionando exactamente como antes. Mantén financiada esa ruta hasta que una tarea real se haya ejecutado de principio a fin en el nuevo cliente. De todos modos, copia primero ~/.gemini/settings.json en un lugar seguro: es el archivo que más probablemente editarás manualmente dos veces.

Una estimación desarrollada para el nuevo cliente

Esto es una aritmética ilustrativa de tokens, no el coste medido de una tarea ni un límite máximo de facturación. Supón una sesión agéntica de 10 pasos, cada uno enviando 60,000 tokens de entrada no almacenados en caché —el ciclo reenvía su contexto en cada paso— y recibiendo 1,500 tokens de salida: 600,000 tokens de entrada y 15,000 tokens de salida en total. No se modelan el almacenamiento en caché, la sobrecarga de las llamadas a herramientas ni los reintentos, y las sesiones reales varían más que las diferencias que aparecen a continuación. Las tarifas son los precios vigentes del catálogo de Kunavo por millón de tokens.

Dejar el cliente no significa dejar la familia de modelos: el catálogo de Kunavo incluye modelos Gemini junto con modelos Claude y GPT, por lo que una configuración de Qwen Code u OpenCode aún puede llamar a Gemini 3.8 Flash. Consulta el catálogo actualizado para saber qué aparece publicado el día que leas esto. El importe del catálogo de Kunavo es un mínimo de facturación, no un límite máximo: cuando el proveedor original informa de su cargo, la factura es el mayor entre el coste del catálogo y el coste del proveedor original multiplicado por el margen aplicable. La recarga mínima es de $10 en 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.

Observa qué pregunta responde esa tabla. La tarifa publicada más barata y el coste mínimo para terminar tu tarea son afirmaciones distintas: un modelo que necesita tres intentos con una tarifa baja puede costar más que uno que lo consigue a la primera. Haz una preselección por tarifa, mide después una tarea acotada en tu propio repositorio y comprueba lo que tu cuenta registró realmente.

Configúralo y comprueba la primera tarea

Kunavo publica una referencia de configuración para el salto más cercano. Es una página de configuración publicada, no una prueba de compatibilidad: Qwen Code no se ha probado en tiempo de ejecución aquí contra el endpoint de Kunavo, y tampoco se ha probado ningún otro cliente de esta página. Empieza por la guía de integración de Qwen Code, o consulta las páginas de OpenCode, Crush, Cline y Aider si alguna de ellas encaja mejor con tu motivo para marcharte. Crea una cuenta de Kunavo cuando estés listo para financiar una clave.

¿Todavía estás decidiendo si cambiar de cliente? Gemini CLI frente a Claude Code compara directamente los flujos de trabajo, y la comparación de proveedores de OpenCode aborda la misma cuestión de enrutamiento desde el otro extremo.

Preguntas frecuentes

Estado del repositorio y de npm, páginas de desuso y precios de Google, documentación de instalación y planes de Antigravity y documentación de configuración propia de Qwen Code, todo comprobado el 21 de septiembre de 2026; la prueba del endpoint de Kunavo se volvió a ejecutar ese mismo día. Nada de esta página se probó en tiempo de ejecución: no se instaló ninguna CLI ni se ejecutó ninguna sesión contra ningún endpoint. Las tarifas por token de Kunavo proceden del catálogo actualizado, y el ejemplo en dólares es una aritmética ilustrativa de tokens.