Integraciones

Gemini CLI

Conecta Gemini CLI a Half Off Dev con dos variables de entorno, paga la mitad del precio oficial de Gemini y elige tu modelo Gemini.

Gemini CLI, el asistente de terminal de código abierto de Google, habla la API de Gemini, y Half Off Dev sirve esa API de forma nativa. Con dos variables de entorno lo cambias de destino y, desde ese momento, cada llamada a Gemini se cobra a la mitad de la tarifa oficial. Primero crea una clave de API.

Configúralo#

Exporta el endpoint y la clave, y arranca la CLI con un modelo:

Shell

export GOOGLE_GEMINI_BASE_URL=https://halfoff.dev
export GEMINI_API_KEY=$HALFOFF_API_KEY
gemini -m gemini-3.1-pro

Usa solo el origen: Gemini CLI añade por su cuenta la ruta de versión de la API.

O impórtalo desde el panel#

En API keys, elige Usar en herramientas → Gemini CLI para ver estas líneas con tu clave puesta. Importar con CC Switch configura Half Off Dev como proveedor en la app de escritorio CC Switch, con los modelos incluidos (CC Switch tiene que estar instalado). Una clave nueva ya está en el diálogo; para una existente, pega la clave completa, porque Half Off Dev solo guarda un hash.

Modelos#

La opción -m elige el modelo. Sirve cualquier id de Gemini de GET /v1/models, como gemini-3.1-pro para problemas difíciles o gemini-3-flash para tareas rápidas. Todos los ids están en la lista de modelos.

Solución de errores#

Lo que ves	Qué hacer
`401` `Missing API key`	No llega ninguna clave a Half Off Dev. Exporta `GEMINI_API_KEY` en la shell que ejecuta `gemini`.
`401` `Invalid or revoked API key`	La clave está mal escrita, cortada o revocada. Pégala de nuevo o crea otra.
`404` `Model '...' is not available`	Ese id no existe. Copia un id de Gemini de `GET /v1/models` o de la lista de modelos.
`404` `Unknown endpoint /v1/v1beta/...`	`GOOGLE_GEMINI_BASE_URL` termina en `/v1`. Cámbiala a `https://halfoff.dev`.
`402`	El saldo está a cero o la clave alcanzó su tope de gasto. Mira Saldo y facturación.

Cualquier otro código se explica en Errores.