OpenAI Codex CLI

El agente de codificación en terminal oficial de OpenAI. Como habla la API estándar de OpenAI, las mismas dos variables de entorno desbloquean todas las herramientas compatibles con OpenAI del ecosistema — una vez que Codex funciona, Aider / Continue / LangChain / la CLI openai sin más también funcionan.

Antes de empezar

Crea una clave API en Console → API Keys. Cópiala de inmediato — solo se muestra una vez.

Paso 1 — Configurar las variables de entorno

# ~/.zshrc (or equivalent)
export OPENAI_BASE_URL="https://synthorai.io/v1"
export OPENAI_API_KEY="sk-..."   # your Synthorai key

⚠

La base URL compatible con OpenAI debe terminar en /v1. A diferencia del SDK de Anthropic, el SDK de OpenAI no lo añade automáticamente. Un error común es pegar https://synthorai.io; las solicitudes llegarán entonces a /chat/completions (404) en lugar de /v1/chat/completions.

Paso 2 — Envía tu primera solicitud

# Open a new shell so env vars take effect, then:
codex exec -m gpt-5.4-mini "refactor this function for readability" < src/foo.py

# Or for long reasoning-heavy tasks:
codex exec -m gpt-5.3-codex "implement unit tests for bar()"

La misma configuración funciona para el openai CLI, los SDK de Python/Node, Aider y cualquier otra herramienta compatible con OpenAI — todos leen OPENAI_BASE_URL y OPENAI_API_KEY.

Modelos recomendados

Parámetro	Tipo	Descripción
`gpt-5.3-codex`	`coding`	Ajustado para generación de código. Opción predeterminada para Codex CLI.
`gpt-5.4`	`reasoning`	Razonamiento insignia. Úsalo para refactorizaciones a nivel de arquitectura.
`gpt-5.4-mini`	`fast`	Rápido, económico y aun así muy capaz. Buena opción predeterminada para tareas cortas.
`gpt-5.4-nano`	`cheapest`	La opción de OpenAI más barata. Úsala para ediciones pequeñas y clasificación.

Solución de problemas

«404 Not Found» en /chat/completions — a tu OPENAI_BASE_URL le falta el /v1 sufijo. Solución: export OPENAI_BASE_URL="https://synthorai.io/v1".

«Sigue llegando a api.openai.com» — las nuevas variables de entorno solo se aplican a los shells nuevos. Abre un terminal nuevo, o source tu perfil.

«Modelo no encontrado» — curl $OPENAI_BASE_URL/models -H "Authorization: Bearer $OPENAI_API_KEY" para ver la lista exacta disponible para tu workspace.

Anulación por proyecto — si no quieres estas variables de forma global, ponlas en un proyecto .envrc (con direnv) o una función por shell.

Consulta cómo se comparan los cuatro niveles en precio en la model price comparison.