Saltar al contenido principal

​
Descripción general

Gemini CLI Interface 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: 
node -v
npm -v
Node.js and npm version verification
  • Inicia sesión en el Panel de EvoLink
  • 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

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

​
1. Comando de instalación

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

gemini --version
Indicador de éxito: Muestra el número de versión (por ejemplo, 1.x.x). Gemini CLI Version ⚠️ 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

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
Find Gemini CLI installation directory

​
2. Modificar el endpoint de la API

Modifica 2 archivos: File location Archivo 1: {install_dir}\@google\gemini-cli\node_modules\@google\genai\dist\node\index.mjs Busca la línea ~11222: 
// Antes
initHttpOptions.baseUrl = `https://generativelanguage.googleapis.com/`;

// Después
initHttpOptions.baseUrl = `https://code.evolink.ai/`;
Modify mjs file Archivo 2: {install_dir}\@google\gemini-cli\node_modules\@google\genai\dist\node\index.cjs Busca la línea ~11244, realiza el mismo cambio. Modify cjs file

​
3. Configurar la clave API

Temporal (solo sesión actual)
$env:GEMINI_API_KEY = "your-evolink-api-key"
Permanente
[Environment]::SetEnvironmentVariable("GEMINI_API_KEY", "your-evolink-api-key", "User")
Reinicia la terminal para que los cambios surtan efecto.Verificar la configuración
echo $env:GEMINI_API_KEY
Si muestra tu clave API, la configuración fue exitosa.Check environment variable

​
Paso 3: Comenzar a usar Gemini CLI

​
1. Entrar al directorio de trabajo

cd your-working-directory
Nota: Reemplaza your-working-directory con la ruta real

​
2. Modo de consulta única

gemini "Who are you"

​
3. Modo interactivo

gemini
Gemini CLI Interface 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://code.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. Gemini CLI Switch Model 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?

  • 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í”

​
Notas

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.