halfoff.devDocs
Obtén una clave
Integraciones

Codex CLI

Usa Codex CLI con modelos GPT a mitad del precio oficial: añade Half Off Dev como proveedor en config.toml, define la clave y elige modelo.

Codex CLI te permite registrar proveedores de modelos adicionales en ~/.codex/config.toml. Añade Half Off Dev como uno de ellos y Codex enviará aquí sus llamadas a la API Responses de OpenAI, donde los modelos GPT cuestan la mitad de la tarifa oficial. El resto de tu configuración de Codex no cambia. Primero crea una clave de API.

Registra el proveedor#

Añade esto a ~/.codex/config.toml:

~/.codex/config.toml
model = "gpt-6.1-sol"
model_provider = "halfoff"

[model_providers.halfoff]
name = "Half Off Dev"
base_url = "https://halfoff.dev/v1"
env_key = "HALFOFF_API_KEY"
wire_api = "responses"

La clave no va en el archivo. Codex la lee de la variable de entorno que indica env_key:

Shell
export HALFOFF_API_KEY="ho-..."
codex

Configuraciones antiguas

Las versiones recientes de Codex rechazan wire_api = "chat". Si copiaste tu configuración de una guía vieja, cámbialo a "responses".

O impórtalo desde el panel#

En API keys, elige Usar en herramientas → Codex CLI para obtener esta configuración con tu clave ya puesta. Importar con CC Switch añade Half Off Dev como proveedor en la app de escritorio CC Switch, con los modelos definidos (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#

Aquí la API Responses sirve modelos GPT, así que usa un id gpt-*. model en config.toml es el predeterminado, y codex -m <model> lo cambia para una sesión. Todos los ids están en la lista de modelos.

Caché de prompts#

Cada sesión de Codex envía un prompt_cache_key. Half Off Dev lo usa para mantener todos los turnos de la sesión en el canal que guarda la caché, así el contexto repetido se cobra a precio de entrada en caché. Mira Caché de prompts.

Solución de errores#

Lo que vesQué hacer
401 Missing API keyNo llega ninguna clave a Half Off Dev. Exporta HALFOFF_API_KEY en la shell que ejecuta codex y comprueba que env_key tenga exactamente ese nombre.
401 Invalid or revoked API keyLa clave está mal escrita, cortada o revocada. Pégala de nuevo o crea otra.
404 not served in responses formatLa API Responses solo sirve modelos GPT. Pon en model un id gpt-*.
404 Unknown endpoint /responsesA base_url le falta /v1. Cámbiala a https://halfoff.dev/v1.
Codex rechaza wire_api = "chat"Usa wire_api = "responses".
402El 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.