Integrando Gemini CLI con modelos personalizados de CodingPlanX

Configura la CLI de Google Gemini utilizando tu Clave API de CodingPlanX.ai.

Guía de integración de Gemini CLI

CodingPlanX.ai admite Claude Code, OpenAI Codex y Google Gemini CLI. Una vez que compras un plan, estas tres herramientas comparten la misma cuota del plan, lo que te permite elegir de manera flexible la herramienta que mejor se adapte a tu flujo de trabajo.

¿Qué es Gemini CLI?

Gemini CLI es un asistente de programación de IA de línea de comandos presentado por Google. Similar a Claude Code, te ayuda a desarrollar código, depurar y manipular archivos directamente dentro de tu terminal.

Modelos disponibles

Puedes acceder a los siguientes modelos de Gemini a través de CodingPlanX.ai:

Modelo	Descripción
`gemini-3-pro-preview`	Última versión de vista previa (Recomendado)
`gemini-2.5-pro`	Versión estable

Última versión: Gemini CLI v0.33.1 (2026-03-12), que incluye el sistema de Extensiones, temas personalizados y más.

Descripción general de la configuración

Gemini CLI requiere que se establezcan las siguientes variables de entorno:

GOOGLE_GEMINI_BASE_URL - URL del endpoint del servicio
GEMINI_API_KEY - Clave API (Igual que Claude Code)
GEMINI_MODEL - Modelo seleccionado

Configuración para macOS

Paso 1: Instalar el entorno Node.js

Gemini CLI requiere Node.js para ejecutarse.

Método 1: Usando Homebrew (Recomendado)

Si tienes Homebrew instalado, es la forma más fácil de instalar Node.js:

# Actualizar Homebrew
brew update

# Instalar Node.js
brew install node

Método 2: Descargar desde el sitio web oficial

Visita https://nodejs.org/
Descarga la versión LTS para macOS
Abre el archivo .pkg descargado
Sigue las instrucciones del instalador

Notas para macOS

Si encuentras problemas de permisos, es posible que debas usar sudo.
La primera ejecución puede requerir permiso en la Configuración del sistema.
Se recomienda usar Terminal o iTerm2.

Verificar la instalación de Node.js

Una vez instalado, abre tu Terminal e ingresa:

node --version
npm --version

Si se muestran las versiones, ¡la instalación fue exitosa!

Paso 2: Instalar Gemini CLI

Instala Gemini CLI globalmente usando npm:

npm install -g @google/gemini-cli

Verifica la instalación:

gemini --version

Paso 3: Configurar variables de entorno de Gemini CLI

Establece las siguientes variables de entorno para conectarte al servicio proxy:

Configuración temporal (Sesión actual)

Ejecuta estos comandos en tu terminal:

export GOOGLE_GEMINI_BASE_URL="https://api.codingplanx.ai"
export GEMINI_API_KEY="cr_xxxxxxxxxx"
export GEMINI_MODEL="gemini-3-pro-preview"

Reemplaza cr_xxxxxxxxxx con tu Clave API de CodingPlanX.ai. Puedes usar la misma clave API que usas para Claude Code.

Configuración permanente (Perfil de shell)

Agrega las siguientes líneas a tu archivo de configuración de shell (ej., ~/.zshrc):

# Configuración de Gemini CLI
export GOOGLE_GEMINI_BASE_URL="https://api.codingplanx.ai"
export GEMINI_API_KEY="cr_xxxxxxxxxx"
export GEMINI_MODEL="gemini-3-pro-preview"

Luego aplica los cambios:

source ~/.zshrc

Verificar variables de entorno

Prueba las variables en tu terminal:

echo $GOOGLE_GEMINI_BASE_URL
echo $GEMINI_API_KEY
echo $GEMINI_MODEL

Configuración para Linux / WSL2

Paso 1: Instalar el entorno Node.js

Gemini CLI requiere Node.js para ejecutarse.

Método 1: Usando nvm (Recomendado)

nvm facilita la gestión de múltiples versiones de Node.js:

# Instalar nvm
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash

# Recargar la configuración del shell
source ~/.bashrc

# Instalar la última versión LTS
nvm install --lts

Método 2: Usando administradores de paquetes

# Ubuntu/Debian
curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash -
sudo apt-get install -y nodejs

# Fedora
sudo dnf install nodejs

# Arch Linux
sudo pacman -S nodejs npm

Notas para Linux / WSL2

Los usuarios de WSL2 deben instalar Node.js dentro del subsistema de Linux, no en Windows.
El uso de nvm ayuda a evitar problemas de permisos.
Asegúrate de que tu perfil de shell cargue correctamente nvm.

Verificar la instalación de Node.js

Abre tu terminal e ingresa:

node --version
npm --version

Paso 2: Instalar Gemini CLI

Instala Gemini CLI globalmente usando npm:

npm install -g @google/gemini-cli

Verifica la instalación:

gemini --version

Paso 3: Configurar variables de entorno de Gemini CLI

Configuración temporal (Sesión actual)

export GOOGLE_GEMINI_BASE_URL="https://api.codingplanx.ai"
export GEMINI_API_KEY="cr_xxxxxxxxxx"
export GEMINI_MODEL="gemini-3-pro-preview"

Reemplaza cr_xxxxxxxxxx con tu Clave API de CodingPlanX.ai.

Configuración permanente (Perfil de shell)

Agrega lo siguiente a tu perfil de shell (~/.bashrc):

# Configuración de Gemini CLI
export GOOGLE_GEMINI_BASE_URL="https://api.codingplanx.ai"
export GEMINI_API_KEY="cr_xxxxxxxxxx"
export GEMINI_MODEL="gemini-3-pro-preview"

Aplica los cambios:

source ~/.bashrc

Si usas Zsh, agrégalo a ~/.zshrc y ejecuta source ~/.zshrc.

Verificar variables de entorno

echo $GOOGLE_GEMINI_BASE_URL
echo $GEMINI_API_KEY
echo $GEMINI_MODEL

Configuración para Windows

Paso 1: Instalar el entorno Node.js

Método 1: Descargar desde el sitio web oficial (Recomendado)

Visita https://nodejs.org/
Haz clic en la versión "LTS" para descargar.
Ejecuta el archivo .msi descargado.
Sigue el asistente de configuración, manteniendo la configuración predeterminada.

Método 2: Usando un administrador de paquetes

Si tienes Chocolatey o Scoop instalado:

# Usando Chocolatey
choco install nodejs

# O usando Scoop
scoop install nodejs

Notas para Windows

Se recomienda usar PowerShell en lugar de CMD.
Si enfrentas errores de permisos, intenta ejecutar como Administrador.
Algunos programas antivirus pueden generar falsos positivos; inclúyelo en la lista blanca si es necesario.

Verificar la instalación de Node.js

Abre PowerShell o CMD e ingresa:

node --version
npm --version

Paso 2: Instalar Gemini CLI

npm install -g @google/gemini-cli

Verifica la instalación:

gemini --version

Paso 3: Configurar variables de entorno de Gemini CLI

Configuración temporal en PowerShell (Sesión actual)

Ejecuta lo siguiente en PowerShell:

$env:GOOGLE_GEMINI_BASE_URL = "https://api.codingplanx.ai"
$env:GEMINI_API_KEY = "cr_xxxxxxxxxx"
$env:GEMINI_MODEL = "gemini-3-pro-preview"

Reemplaza cr_xxxxxxxxxx con tu Clave API de CodingPlanX.ai.

Configuración permanente en PowerShell (Nivel de usuario)

Ejecuta lo siguiente en PowerShell:

# Establecer variables de entorno a nivel de usuario (Permanente)
[System.Environment]::SetEnvironmentVariable("GOOGLE_GEMINI_BASE_URL", "https://api.codingplanx.ai", [System.EnvironmentVariableTarget]::User)
[System.Environment]::SetEnvironmentVariable("GEMINI_API_KEY", "cr_xxxxxxxxxx", [System.EnvironmentVariableTarget]::User)
[System.Environment]::SetEnvironmentVariable("GEMINI_MODEL", "gemini-3-pro-preview", [System.EnvironmentVariableTarget]::User)

Debes reiniciar tu ventana de PowerShell para que estos cambios surtan efecto.

Verificar variables de entorno

echo $env:GOOGLE_GEMINI_BASE_URL
echo $env:GEMINI_API_KEY
echo $env:GEMINI_MODEL

Preguntas frecuentes / Resolución de problemas

Versión de Node.js demasiado baja

Problema: Gemini CLI indica que la versión de Node.js es incompatible.

Solución:

Verifica tu versión: node --version
Se recomienda Node.js 18.x o superior.
Actualiza usando nvm: nvm install --lts && nvm use --lts

Las variables de entorno no surten efecto

Problema: No se puede conectar después de configurar las variables de entorno.

Solución:

Asegúrate de haber reiniciado tu terminal o ejecutado el comando source.
Verifica si los nombres de las variables están escritos correctamente (distingue entre mayúsculas y minúsculas).
Verifica el formato de tu clave API (comienza con cr_).

Problemas de conexión de red

Problema: No se puede conectar a los servicios de CodingPlanX.ai.

Solución:

Verifica tu conexión a Internet.
Verifica que GOOGLE_GEMINI_BASE_URL esté configurado correctamente.