Cómo Autenticar la CLI de Gemini en Servidores Remotos (Adiós al Error 400)

Si intentas usar la CLI de Gemini (@google/gemini-cli) en un servidor remoto (como Debian 12, Ubuntu, o cualquier VPS) mediante SSH, pronto descubrirás que el proceso de autenticación de Google falla porque no puede abrir un navegador ni redirigir a localhost.

En nuestro caso, el problema fue doble: la variable GEMINI_API_KEY era ignorada y la URL de autenticación de Google estaba incompleta (Error 400: invalid_request).

A continuación, te mostramos el único camino garantizado para que Gemini CLI funcione en un entorno headless (sin interfaz gráfica).

🛠️ Prerrequisito: Obtener y Exportar la API Key

Antes de cualquier cosa, asegúrate de tener tu clave API lista. Este método es el más confiable para entornos de servidor.

1. Obtén tu Clave API desde Google AI Studio.

2. Exporta la clave como una variable de entorno en tu terminal SSH (aunque la CLI la ignore temporalmente, es un buen hábito):

   export GEMINI_API_KEY="TU_CLAVE_GENERADA_AQUI"

---

Paso 1: Forzar el Uso de la API Key en la Configuración

La CLI de Gemini prioriza el flujo de autenticación de cuenta personal (oauth-personal). Para forzar que use la clave API, debemos editar el archivo de configuración.

1. Crea el directorio de configuración si no existe:

   mkdir -p ~/.gemini

2. Crea o edita el archivo settings.json en el directorio de tu usuario:

   nano ~/.gemini/settings.json

3. Asegúrate de que el archivo contenga ÚNICAMENTE tu clave API y no configuraciones de oauth-personal que podrían causar conflicto:

   {

     "apiKey": "AIzaSyB1xX9eXkAK3WlV1aOE3KXdtdt5D0unuNs"
   }
   

   (Reemplaza el valor con tu clave real. Este paso corrige la tendencia de la CLI a ignorar la variable de entorno y a intentar el flujo OAuth roto).

---

Paso 2: Ejecutar y Acceder al Menú de Autenticación

Al iniciar la CLI, esta ya no debería fallar con el error 400 ni con la petición de un código que no funciona. En su lugar, la CLI detectará que tiene una clave API disponible y nos presentará el menú de opciones.

1. Ejecuta el comando principal:

   gemini

2. La CLI te mostrará el siguiente menú interactivo, reconociendo tu instalación:

   │ 1. Login with Google
   │ ● 2. Use Gemini API Key
   │ 3. Vertex AI
   

---

Paso 3: Seleccionar la Autenticación por API Key

Este es el paso crítico donde le indicamos explícitamente a la herramienta qué método usar, superando los fallos automáticos.

1. Usa las flechas de dirección para mover el selector (●) a la Opción 2: Use Gemini API Key.

2. Presiona Enter para confirmar tu selección.

La CLI de Gemini autenticará la sesión inmediatamente usando la clave que ya definiste en el archivo ~/.gemini/settings.json.

Si todo es correcto, la CLI iniciará el prompt interactivo de chat, ¡y podrás usar Gemini directamente desde tu terminal Debian remota!

Welcome to Gemini CLI. Type /help for assistance. 

(chat)>