Usa tu clave en Codex CLI

Configura un proveedor de modelos personalizado en ~/.codex/config.toml con wire_api = responses y elige un modelo.

Codex es el agente de programación de OpenAI (CLI y escritorio). Admite proveedores de modelos personalizados: apunta un proveedor a OLETOKEN y usará tu clave y tu cuota de modelos de OLETOKEN.

Antes de empezar

Has creado una clave de API y has guardado la clave completa.
Has elegido un ID de modelo en el catálogo de modelos.
Tienes Node.js y npm instalados.

Configuración

Un proveedor personalizado debe ir en el ~/.codex/config.toml a nivel de usuario. Los campos model_provider y model_providers de un .codex/config.toml a nivel de proyecto se ignoran.

model = "gpt-5.6-terra"
model_provider = "oletoken"

[model_providers.oletoken]
name = "OleToken"
base_url = "https://<your-base-url>/v1"
env_key = "OLETOKEN_API_KEY"
wire_api = "responses"

Campo	Significado
`model`	ID del modelo predeterminado
`model_provider`	Apunta al proveedor definido más abajo
`base_url`	Dirección compatible con OpenAI, incluido `/v1` (Codex llama a `{base_url}/responses`)
`env_key`	Nombre de la variable de entorno que contiene la clave: la clave en sí no queda en el archivo
`wire_api`	Hoy solo se admite `responses`

Exporta la clave y lanza:

export OLETOKEN_API_KEY="YOUR_API_KEY"   # añádelo a ~/.zshrc o ~/.bashrc para que sea permanente
npm i -g @openai/codex
codex

El diálogo Inicio rápido de la página de claves de API ofrece la descarga de este mismo script con tu clave, tu modelo y tu Base URL ya rellenados: añade lo que falta y, si config.toml ya tiene model / model_provider, solo imprime el bloque para que lo fusiones tú en lugar de reescribir tu archivo.

Solución de problemas

Síntoma	Causa y solución
401	`OLETOKEN_API_KEY` no está exportada o contiene un valor incorrecto: `env_key` solo nombra la variable, la clave debe existir en el entorno
404	A `base_url` le falta `/v1`
Proveedor ignorado	La configuración está en un `.codex/config.toml` a nivel de proyecto; muévela a `~/.codex/config.toml`
Model not found	El ID no aparece en este sitio; cópialo del catálogo de modelos
Insufficient balance	Recarga primero

wire_api solo admite responses, así que Codex envía las solicitudes a {base_url}/responses: asegúrate de que tu Base URL expone ese endpoint (un 401 sin clave significa que la ruta existe).