halfoff.devDocs
Obtén una clave
Primeros pasos

Integraciones

Usa Claude Code, Codex CLI, Gemini CLI, Cherry Studio, DeepChat, AionUI o cualquier app compatible con OpenAI a mitad de precio con una clave de Half Off Dev.

Si un cliente te deja cambiar su URL base de API, puede funcionar con Half Off Dev, y cada petición que haga se cobra a la mitad del precio oficial. El cambio siempre son los mismos dos valores, endpoint y clave; tus prompts, ajustes y forma de trabajar no se tocan. Empieza creando una clave de API.

Elige tu cliente#

Cada guía cubre un cliente de principio a fin: archivo de configuración o comandos, qué modelos elegir y los errores más habituales.

Deja que el panel lo rellene#

En la página API keys, cada clave tiene un botón Usar en herramientas (y una clave recién creada muestra Usar en herramientas… justo al lado). El diálogo que abre trae la configuración de cada cliente de arriba con tu clave ya puesta, más atajos de importación:

  • Claude Code, Codex CLI y Gemini CLI: Importar con CC Switch registra Half Off Dev como proveedor en la app de escritorio CC Switch, con los modelos incluidos. Necesitas tener CC Switch instalado.
  • Cherry Studio, DeepChat y AionUI: Open in app añade Half Off Dev como proveedor dentro de esa app. Necesitas tenerla instalada.

Una clave que acabas de crear ya aparece en el diálogo. Si es una clave anterior, pégala tú: solo se guarda su hash, así que Half Off Dev no puede volver a mostrarla.

¿Qué URL base uso?#

Depende del formato de API que hable tu cliente, nunca del modelo que elijas:

Formato de APILo usanURL base
Anthropic MessagesClaude Code, SDK de Anthropichttps://halfoff.dev
OpenAI Chat Completions y ResponsesCodex CLI, SDK de OpenAI, apps compatibles con OpenAIhttps://halfoff.dev/v1
GeminiGemini CLI, SDK Google Gen AIhttps://halfoff.dev
Campo "API host" compatible con OpenAICherry Studio, DeepChat, AionUIhttps://halfoff.dev (la app añade /v1)

Cuando algo falla#

Lo que vesQué hacer
401 Missing API keyNo llega ninguna clave a Half Off Dev. Revisa el nombre de la variable y que esté exportada en la misma shell que lanza el cliente.
401 Invalid or revoked API keyLa clave está mal escrita, cortada o revocada. Pégala de nuevo o crea otra.
404 Model '...' is not availableEse id de modelo no existe. Copia uno de GET /v1/models o de la lista de modelos.
404 Unknown endpointEl cliente pide una API que Half Off Dev no ofrece, como embeddings. Cámbialo a Chat Completions, Responses, Anthropic Messages o Gemini.
404 con /v1/v1/ en la rutaEl cliente añade /v1 por su cuenta. Usa https://halfoff.dev como host.
402El saldo está a cero o la clave alcanzó su tope de gasto. Mira Saldo y facturación.

Cada guía incluye los errores propios de su cliente, y Errores cubre todos los códigos de estado.