> ## Documentation Index
> Fetch the complete documentation index at: https://docs.evolink.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Gemini CLI

> Conectar Gemini CLI a EvoLink.AI

## Descripción general

<img src="https://mintcdn.com/muyutechnology/ogYegfyiYikRHauR/images/integration-guide/image-2.png?fit=max&auto=format&n=ogYegfyiYikRHauR&q=85&s=164ba3d3b5cdc5deaff461189e96ba50" alt="Gemini CLI Interface" width="1711" height="578" data-path="images/integration-guide/image-2.png" />

Gemini CLI es la herramienta oficial de línea de comandos de Google para interactuar con los modelos Gemini en la terminal.
Al integrar Gemini CLI con **EvoLink API**, puedes superar los límites de los modelos oficiales y acceder al conjunto más amplio de modelos de EvoLink, incluyendo las series **Gemini, GPT y Claude**, a través de un único punto de entrada.

## Requisitos previos

Antes de configurar, asegúrate de tener:

### 1. Instalar Node.js y npm

**¿Por qué es necesario?** Node.js es el entorno de ejecución para herramientas CLI (al igual que necesitas instalar WeChat en tu teléfono para chatear, necesitas instalar Node.js en tu computadora para ejecutar herramientas CLI).

**Si ya está instalado:** Ejecuta `node -v` y `npm -v` para verificar la versión. Si es v20+, omite este paso.

**Primera instalación:**

* Descarga e instala desde el [sitio web oficial de Node.js](https://nodejs.org/) (se recomienda la versión LTS)
* Si no estás familiarizado con el proceso de instalación, consulta la [Guía de instalación de Node.js en Runoob](https://www.runoob.com/nodejs/nodejs-install-setup.html)
* Recomendado: **Node.js v20 o superior**
* Verificar la instalación:

```bash theme={null}
node -v
npm -v
```

<img src="https://mintcdn.com/muyutechnology/aVl9y2uT7NNwpwBy/images/integration-guide/claude-node-npm-verify.png?fit=max&auto=format&n=aVl9y2uT7NNwpwBy&q=85&s=13be4f60f117fca3024b2b2c1d0fd208" alt="Node.js and npm version verification" width="1730" height="923" data-path="images/integration-guide/claude-node-npm-verify.png" />

### 2. Obtener la clave API de EvoLink

* Inicia sesión en el [Panel de EvoLink](https://evolink.ai/dashboard)
* Busca API Keys en el panel, haz clic en el botón 'Crear nueva clave' y luego copia la clave generada
* La clave API generalmente comienza con `sk-`

## Paso 1: Instalar Gemini CLI

<Note>
  **Consejo:** Si no sabes cómo abrir una terminal de línea de comandos, consulta [Preguntas frecuentes - Cómo abrir la terminal de línea de comandos](#13-cómo-abrir-la-terminal-de-línea-de-comandos)
</Note>

### 1. Comando de instalación

```bash theme={null}
npm install -g @google/gemini-cli
```

**Resultado esperado:** Información de descarga desplazándose, terminando con `added XX packages` (tarda 1-3 minutos).

**Si ocurre un error:** `permission denied` significa que en Windows necesitas ejecutar PowerShell "como administrador", en macOS/Linux agrega `sudo` antes del comando.

### 2. Verificar la instalación

```bash theme={null}
gemini --version
```

**Indicador de éxito:** Muestra el número de versión (por ejemplo, `1.x.x`).

<img src="https://mintcdn.com/muyutechnology/ImpSKD1BzFmyJCJ-/images/integration-guide/gemini-version.png?fit=max&auto=format&n=ImpSKD1BzFmyJCJ-&q=85&s=3fd01705c8f519f6d81ba1fb78d25cb2" alt="Gemini CLI Version" width="1730" height="923" data-path="images/integration-guide/gemini-version.png" />

## Paso 2: Configurar EvoLink API

**⚠️ Importante:** La configuración de Gemini CLI es **ligeramente más compleja** que otras herramientas, ya que requiere modificar archivos de instalación. Si eres nuevo en programación, considera usar **Claude CLI** o **Codex CLI** primero (configuración más sencilla).

### 1. Encontrar el directorio de instalación

```bash theme={null}
npm root -g
```

**Verás una ruta como:**

* Windows: `C:\Users\YourUsername\AppData\Roaming\npm\node_modules`
* macOS: `/usr/local/lib/node_modules`
* Linux: `/usr/lib/node_modules`

<img src="https://mintcdn.com/muyutechnology/aVl9y2uT7NNwpwBy/images/integration-guide/gemini-find-install-dir.png?fit=max&auto=format&n=aVl9y2uT7NNwpwBy&q=85&s=b532f9ef42e03905f6b23a216debb194" alt="Find Gemini CLI installation directory" width="1730" height="923" data-path="images/integration-guide/gemini-find-install-dir.png" />

### 2. Modificar el endpoint de la API

Modifica 2 archivos:

<img src="https://mintcdn.com/muyutechnology/ImpSKD1BzFmyJCJ-/images/integration-guide/gemini-modify-api.png?fit=max&auto=format&n=ImpSKD1BzFmyJCJ-&q=85&s=02aaff8284dabd21e029e42b85310dd5" alt="File location" width="1028" height="236" data-path="images/integration-guide/gemini-modify-api.png" />

**Archivo 1:** `{install_dir}\@google\gemini-cli\node_modules\@google\genai\dist\node\index.mjs`

Busca la línea **\~11222**:

```javascript theme={null}
// Antes
initHttpOptions.baseUrl = `https://generativelanguage.googleapis.com/`;

// Después
initHttpOptions.baseUrl = `https://direct.evolink.ai/`;
```

<img src="https://mintcdn.com/muyutechnology/aVl9y2uT7NNwpwBy/images/integration-guide/gemini-mjs-modify.png?fit=max&auto=format&n=aVl9y2uT7NNwpwBy&q=85&s=5ba761a74f73a50df86f72a2303c2087" alt="Modify mjs file" width="1302" height="896" data-path="images/integration-guide/gemini-mjs-modify.png" />

**Archivo 2:** `{install_dir}\@google\gemini-cli\node_modules\@google\genai\dist\node\index.cjs`

Busca la línea **\~11244**, realiza el mismo cambio.

<img src="https://mintcdn.com/muyutechnology/aVl9y2uT7NNwpwBy/images/integration-guide/gemini-cjs-modify.png?fit=max&auto=format&n=aVl9y2uT7NNwpwBy&q=85&s=84ee7886704faaebddad7b44a565e285" alt="Modify cjs file" width="1301" height="865" data-path="images/integration-guide/gemini-cjs-modify.png" />

### 3. Configurar la clave API

<Tabs>
  <Tab title="Windows PowerShell">
    **Temporal (solo sesión actual)**

    ```powershell theme={null}
    $env:GEMINI_API_KEY = "your-evolink-api-key"
    ```

    **Permanente**

    ```powershell theme={null}
    [Environment]::SetEnvironmentVariable("GEMINI_API_KEY", "your-evolink-api-key", "User")
    ```

    Reinicia la terminal para que los cambios surtan efecto.

    **Verificar la configuración**

    ```powershell theme={null}
    echo $env:GEMINI_API_KEY
    ```

    Si muestra tu clave API, la configuración fue exitosa.

    <img src="https://mintcdn.com/muyutechnology/aVl9y2uT7NNwpwBy/images/integration-guide/gemini-check-env.png?fit=max&auto=format&n=aVl9y2uT7NNwpwBy&q=85&s=588d9271f5c882ec0fbdd463f12877e1" alt="Check environment variable" width="1730" height="923" data-path="images/integration-guide/gemini-check-env.png" />
  </Tab>

  <Tab title="macOS / Linux">
    **Temporal (solo sesión actual)**

    ```bash theme={null}
    export GEMINI_API_KEY="your-evolink-api-key"
    ```

    **Permanente**
    Edita `~/.bashrc` o `~/.zshrc`, agrega:

    ```bash theme={null}
    export GEMINI_API_KEY="your-evolink-api-key"
    ```

    Luego ejecuta `source ~/.bashrc` o `source ~/.zshrc` para aplicar, o reinicia la terminal.

    **Verificar la configuración**

    ```bash theme={null}
    echo $GEMINI_API_KEY
    ```

    Si muestra tu clave API, la configuración fue exitosa.
  </Tab>
</Tabs>

## Paso 3: Comenzar a usar Gemini CLI

### 1. Entrar al directorio de trabajo

```shell theme={null}
cd your-working-directory
```

**Nota:** Reemplaza `your-working-directory` con la ruta real

### 2. Modo de consulta única

```shell theme={null}
gemini "Who are you"
```

### 3. Modo interactivo

```shell theme={null}
gemini
```

<img src="https://mintcdn.com/muyutechnology/aVl9y2uT7NNwpwBy/images/integration-guide/gemini-interface.png?fit=max&auto=format&n=aVl9y2uT7NNwpwBy&q=85&s=390483a8f111f322165b81ff8bbe0626" alt="Gemini CLI Interface" width="1730" height="923" data-path="images/integration-guide/gemini-interface.png" />

**Indicadores de éxito:**

* Se muestra texto de respuesta de la IA (varias líneas)
* **Sin** errores como `401`, `403`, `API Key invalid`

**Si ves errores:**

* `401 Unauthorized`: La clave API no está configurada o es inválida → Verifica la variable de entorno
* `403 Forbidden`: Permisos insuficientes de la clave API → Verifica la modificación del endpoint de la API
* `Network error`: Problema de red → Verifica la conexión

## Preguntas frecuentes

### 1. ¿Qué es Gemini CLI y para qué sirve?

Gemini CLI es la herramienta oficial de línea de comandos de Google para interactuar con los modelos Gemini en la terminal. Con la configuración de EvoLink, también puedes acceder a GPT, Claude y otros modelos.

### 2. ¿Cómo verifico la instalación y configuración en el primer uso?

Ejecuta estos comandos en secuencia:

* `node -v` y `npm -v`: Confirma que Node.js y npm están instalados
* `gemini --version`: Confirma que Gemini CLI está instalado
* `gemini "Who are you"`: Confirma que la configuración de la API es correcta

### 3. ¿Cuál es la diferencia entre el modo interactivo y el modo de comando único?

* **Modo interactivo**: Ejecuta `gemini` para entrar en una conversación continua para interacciones de múltiples turnos
* **Modo de comando único**: Ejecuta `gemini "pregunta"` para obtener una única respuesta y salir

### 4. ¿Gemini CLI leerá o subirá automáticamente mis archivos y código locales?

No. Gemini CLI solo lee el contenido de archivos cuando tú lo referencias o autorizas explícitamente. Se recomienda usarlo en una carpeta de proyecto dedicada.

### 5. ¿Cómo uso Gemini CLI para analizar el contenido de archivos locales?

En modo interactivo, puedes referenciar archivos de las siguientes maneras:

* Escribiendo la ruta del archivo para que Gemini lo lea
* Arrastrando archivos a la ventana de la terminal

### 6. ¿Gemini CLI admite entrada y salida en chino?

Sí, es totalmente compatible.

### 7. ¿No hay salida después de la ejecución, cuál podría ser la causa?

Las causas comunes incluyen:

* Problemas de conexión de red
* Clave API inválida o saldo insuficiente
* Configuración incorrecta del endpoint de la API
* Firewall o proxy bloqueando las solicitudes

### 8. ¿Por qué mis cambios en el endpoint de la API o la variable de entorno no surten efecto?

* Reinicia tu terminal o ventana de línea de comandos
* Confirma que la variable de entorno `GEMINI_API_KEY` está configurada correctamente
* Confirma que los archivos del endpoint de la API están modificados correctamente (necesitas modificar los archivos .mjs y .cjs en node\_modules)

### 9. ¿Qué causa los errores 401/403?

* **Error 401**: `GEMINI_API_KEY` no está configurada o es inválida
* **Error 403**: Permisos insuficientes o clave expirada
* Verifica que el endpoint de la API sea `https://direct.evolink.ai/`

### 10. ¿Para qué escenarios es adecuado Gemini CLI?

**Adecuado para:**

* Escritura, depuración y refactorización de código
* Preguntas y respuestas rápidas en entornos de línea de comandos
* Análisis de contenido de archivos
* Integración de scripts de automatización

**No adecuado para:**

* Interacciones complejas con interfaz gráfica
* Edición colaborativa en tiempo real
* Procesamiento masivo de archivos a gran escala

### 11. ¿Cómo cambio de modelo?

Escribe `/model` en el modo interactivo.

<img src="https://mintcdn.com/muyutechnology/ogYegfyiYikRHauR/images/integration-guide/image-3.png?fit=max&auto=format&n=ogYegfyiYikRHauR&q=85&s=9fd12b04bfc76875a9652b480a44b786" alt="Gemini CLI Switch Model" width="1280" height="570" data-path="images/integration-guide/image-3.png" />

Modelos disponibles:

* `gemini-2.5-pro`
* `gemini-2.5-flash`
* `gemini-3-pro-preview`
* `gemini-3-flash-preview`

### 12. ¿Cómo subo imágenes?

* Opción 1: Referencia la ruta de la imagen
* Opción 2: Arrastra y suelta una imagen en la terminal

Todos los métodos requieren acción del usuario: Gemini CLI no leerá ni subirá automáticamente imágenes locales.

### 13. ¿Cómo abrir la terminal de línea de comandos?

<Tabs>
  <Tab title="Windows">
    * Método 1: Presiona `Win + R`, escribe `cmd` o `powershell`, luego presiona Enter
    * Método 2: Busca "Símbolo del sistema" o "PowerShell" en el menú Inicio
    * Método 3: Mantén presionado Shift y haz clic derecho en una carpeta, selecciona "Abrir ventana de PowerShell aquí"
  </Tab>

  <Tab title="macOS">
    * Método 1: Presiona `Command + Space` para abrir Spotlight, escribe `Terminal`, luego presiona Enter
    * Método 2: Ve a "Aplicaciones" → "Utilidades" → "Terminal"
  </Tab>

  <Tab title="Linux">
    * Método 1: Presiona el atajo `Ctrl + Alt + T`
    * Método 2: Busca "Terminal" en el menú de aplicaciones
  </Tab>
</Tabs>

## Notas

<Warning>
  Ejecuta Gemini CLI en una carpeta de proyecto dedicada. Evita ejecutarlo en directorios sensibles (como carpetas del sistema o directorios que contengan credenciales). Gemini CLI opera a partir del directorio de trabajo actual.
</Warning>