Tutorial de configuración de la interfaz de línea de comandos (CLI) de OpenAI Codex

📋 Pasos preparatorios

Antes de comenzar, asegúrese de haber:

Registrado una cuenta de Koze e iniciado sesión
Creado una clave API en la página de administración de API
Instalado la CLI de Codex (npm install -g @openai/codex)

🚀 Paso 1: Configurar el archivo de configuración de Codex

Agregue la siguiente configuración al principio del archivo ~/.codex/config.toml:

model_provider = "koze"

model = "gpt-4.1"

model_reasoning_effort = "high"

disable_response_storage = true
preferred_auth_method = "apikey"

[model_providers.koze]

name = "koze"

base_url = "https://api.kozeai.com/v1"

wire_api = "responses"

requires_openai_auth = true

💡 Consejo: Reemplace `https://api.kozeai.com/v1` con su dirección proxy de Koze. El campo `model` permite seleccionar diferentes modelos según tu plan. Paso dos: Configurar la clave API Configura tu clave API en el archivo `~/.codex/auth.json`: { 'OPENAI_API_KEY': 'Tu clave API de Koze' } Paso tres: Iniciar Codex Después de la configuración, inícialo directamente en la terminal: Codex CLI utilizará automáticamente el proxy de Koze para las solicitudes API. Modelos disponibles Puedes usar los siguientes modelos en el campo `model`: Campo del archivo de configuración (según tu plan Koze):

Nombre del modelo Descripción

gpt-5.3-codex gpt-5.3-codex, adecuado para tareas de programación cotidianas

gpt-5.4-mini GPT-4.1 Mini, mejor relación calidad-precio

gpt-5.4 GPT-5.4 Multimodal Modelo

⚠️ Preguntas frecuentes

Problema Solución

Consejo: "Autenticación fallida" Verifique que la clave API en auth.json sea correcta
config.toml no funciona Asegúrese de que la configuración esté escrita al principio del archivo y que el nombre de model_provider coincida [model_providers.xxx]

El uso de Nginx Anti-prototype falla. Agregue `underscores_in_headers on;` al bloque `http` de Nginx; de lo contrario, Nginx descartará por defecto las cabeceras de solicitud con guiones bajos.

Nombre del modelo	Descripción
`gpt-5.3-codex`	`gpt-5.3-codex`, adecuado para tareas de programación cotidianas
`gpt-5.4-mini`	GPT-4.1 Mini, mejor relación calidad-precio
`gpt-5.4`	GPT-5.4 Multimodal Modelo

Problema	Solución
Consejo: "Autenticación fallida"	Verifique que la clave API en `auth.json` sea correcta
`config.toml` no funciona	Asegúrese de que la configuración esté escrita al principio del archivo y que el nombre de `model_provider` coincida `[model_providers.xxx]`
El uso de Nginx Anti-prototype falla.	Agregue `underscores_in_headers on;` al bloque `http` de Nginx; de lo contrario, Nginx descartará por defecto las cabeceras de solicitud con guiones bajos.