Proveedor personalizado de Codex CLI/App: config.toml, API Key y Base URL

Codex CLI y Codex App se conectan a BetterToken mediante OpenAI Responses. El archivo de configuración es ~/.codex/config.toml y la API Key se proporciona mediante BETTERTOKEN_API_KEY.

Ajustes principales

Campo	Valor
API Key	Variable de entorno `BETTERTOKEN_API_KEY`
Base URL	`https://www.bettertoken.ai/v1`
Model	`YOUR_MODEL_ID`

Requisitos previos

Instala Node.js
Crea una BetterToken API Key
Copia un Model ID del model plaza o del cuadro de diálogo Setup de la Key

Instalación

npm install -g @openai/codex

Configuración por línea de comandos

El script de configuración automática de BetterToken escribe la configuración del proveedor para Codex. Requiere Node.js y solicita la API Key o el Model ID si no se proporcionan como argumentos.

macOS / Linux
Windows

curl -fsSL "https://bettertoken.ai/install-codex-provider.sh" | bash

iwr "https://bettertoken.ai/install-codex-provider.ps1" -OutFile "$env:TEMP\install-codex-provider.ps1"; powershell -ExecutionPolicy Bypass -File "$env:TEMP\install-codex-provider.ps1"

Cuando termine, abre ~/.codex/config.toml (o %USERPROFILE%\.codex\config.toml en Windows), confirma que model, review_model y el proveedor BetterToken se hayan escrito correctamente y reinicia Codex por completo.

Configuración manual

GPT, Kimi y GLM usan la misma estructura de config.toml. Sustituye únicamente YOUR_MODEL_ID por un Model ID actual del proveedor seleccionado. La configuración por línea de comandos con un solo comando está disponible actualmente solo para GPT.

Configurar la API Key

macOS / Linux
Windows PowerShell

export BETTERTOKEN_API_KEY="YOUR_API_KEY"

Añade esta línea a ~/.zshrc o ~/.bashrc para conservarla.

[Environment]::SetEnvironmentVariable("BETTERTOKEN_API_KEY", "YOUR_API_KEY", "User")
$env:BETTERTOKEN_API_KEY = "YOUR_API_KEY"

No guardes una BetterToken API Key en ~/.codex/auth.json. Ese archivo corresponde al inicio de sesión oficial de Codex; un proveedor personalizado debe leer la variable de entorno mediante env_key.

Configurar config.toml

Edita ~/.codex/config.toml:

model_provider = "custom"
model = "YOUR_MODEL_ID"
review_model = "YOUR_MODEL_ID"
model_reasoning_effort = "high"

[model_providers.custom]
name = "BetterToken"
base_url = "https://www.bettertoken.ai/v1"
env_key = "BETTERTOKEN_API_KEY"
wire_api = "responses"
requires_openai_auth = false
request_max_retries = 4
stream_max_retries = 8
stream_idle_timeout_ms = 300000
supports_websockets = false

model_provider = "custom" debe coincidir con la tabla [model_providers.custom]. Sustituye ambos valores YOUR_MODEL_ID por un Model ID completo y actual.

Verificar la conexión

Abre una terminal nueva y ejecuta:

codex

Envía una tarea corta. Una respuesta en streaming sin errores de inicio de sesión, 401 o modelo confirma la configuración.

Cambiar de modelo

Cambia model y, de forma opcional, review_model. Guarda el archivo, detén el proceso actual de Codex y vuelve a iniciarlo. Usa el Model ID del cuadro de diálogo Setup o del model plaza.

Errores frecuentes

Error	Solución
`401` o solicitud de inicio de sesión de OpenAI	Comprueba `BETTERTOKEN_API_KEY` y confirma que `requires_openai_auth = false`.
No se encuentra el proveedor	Haz que `model_provider = "custom"` coincida con `[model_providers.custom]`.
Error de modo API	Mantén `wire_api = "responses"`; no cambies a Chat Completions.
No se encuentra el modelo	Sustituye `YOUR_MODEL_ID` por un ID completo y actual del cuadro Setup o del model plaza.
La configuración no se aplica	Abre una terminal nueva, verifica la variable de entorno y reinicia Codex por completo.

Configuración avanzada

Proveedores compatibles

Proveedor	Estado
Claude	No compatible
GPT	Línea de comandos y configuración manual
Kimi	Configuración manual
GLM	Configuración manual

Los estados se aplican al método de configuración de BetterToken descrito en esta página.

Qué significa cada método de configuración

Configuración por línea de comandos y manual: usa un comando generado o sigue todos los pasos manuales.
Configuración manual: introduce la API Key, la Base URL y el Model.
No compatible: todavía no hay un método de conexión directa verificado.

Extensión de Codex

La extensión de Codex para VS Code comparte config.toml, pero conservar el inicio de sesión oficial requiere una configuración de autenticación diferente. Consulta la guía de configuración de la extensión de Codex.

La configuración de CLI/App y la de la extensión con inicio de sesión oficial son alternativas. No pegues dos tablas [model_providers.custom] en el mismo archivo TOML.

Preguntas relacionadas

Referencia oficial

Referencia de configuración de Codex

Detalles técnicos

Protocolo Responses

Codex usa OpenAI Responses. Configura base_url como https://www.bettertoken.ai/v1 y mantén wire_api = "responses". Codex añade /responses.

Primeros pasos

Configuración de Coding Agents

Configuración de plataformas de aplicaciones de IA

Configuración avanzada

Proveedor personalizado de Codex CLI/App: config.toml, API Key y Base URL

Ajustes principales

Requisitos previos

Instalación

Configuración por línea de comandos

Configuración manual

Configurar la API Key

Configurar config.toml

Verificar la conexión

Cambiar de modelo

Errores frecuentes

Configuración avanzada

Proveedores compatibles

Extensión de Codex

Preguntas relacionadas

Referencia oficial

Detalles técnicos

​Ajustes principales

​Requisitos previos

​Instalación

​Configuración por línea de comandos

​Configuración manual

​Configurar la API Key

​Configurar config.toml

​Verificar la conexión

​Cambiar de modelo

​Errores frecuentes

​Configuración avanzada

​Proveedores compatibles

​Extensión de Codex

​Preguntas relacionadas

​Referencia oficial

​Detalles técnicos

Ajustes principales

Requisitos previos

Instalación

Configuración por línea de comandos

Configuración manual

Configurar la API Key

Configurar config.toml

Verificar la conexión

Cambiar de modelo

Errores frecuentes

Configuración avanzada

Proveedores compatibles

Extensión de Codex

Preguntas relacionadas

Referencia oficial

Detalles técnicos