OpenAI Codex CLI: el agente de terminal de OpenAI que no conoces

Cuando se habla de agentes de IA para desarrollo en terminal, la conversación suele girar en torno a Claude Code. Pero Codex CLI, el agente de terminal de OpenAI, tiene 67.000 estrellas en GitHub, es open source con licencia Apache 2.0, y en 2026 ya usa GPT-5.4 como modelo principal —el mismo modelo que combina las capacidades de GPT-5.3-Codex con razonamiento más fuerte y computer use nativo.

No es una herramienta menor. Es un agente de terminal maduro con un modelo de permisos granular, subagentes en paralelo, integración con MCP, búsqueda web integrada y una arquitectura completamente diferente a Claude Code. Si solo conoces uno de los dos, te estás perdiendo la mitad del mapa.

Instalación

Tres formas de instalarlo:

# Con npm (recomendado)
npm install -g @openai/codex

# Con Homebrew en macOS
brew install --cask codex

# Binario directo para macOS y Linux
# Descarga desde github.com/openai/codex/releases

Autenticación con tu cuenta de ChatGPT (Plus, Pro, Team o Enterprise):

codex auth login
# Sigue el flujo device-code — abre el navegador y confirmas

O con API key:

export OPENAI_API_KEY=sk-...
codex

Los usuarios de ChatGPT Plus reciben 5$ en créditos API gratuitos al conectar. Los de Pro reciben 50$.

Modelos disponibles en 2026

# Ver modelos disponibles
codex /model

# Cambiar modelo en mitad de una sesión
/model gpt-5.4
/model gpt-5.4-mini
/model gpt-5.3-codex-spark  # Solo ChatGPT Pro, research preview

GPT-5.4 es el recomendado para la mayoría de tareas. Combina las capacidades de codificación de GPT-5.3-Codex con razonamiento más fuerte, computer use nativo y workflows profesionales completos.

GPT-5.4-mini para tareas ligeras y subagentes. Más rápido y más barato, ideal para exploración o tareas repetitivas.

GPT-5.3-Codex-Spark en research preview para ChatGPT Pro. Optimizado para iteración en tiempo real, más de 1.000 tokens por segundo. Texto por ahora, ventana de 128K tokens.

El modelo de permisos: la clave de Codex

Lo que diferencia a Codex CLI de otros agentes es su sistema de permisos granular. Tienes tres modos:

# Modo por defecto — apruebas cada acción
codex "añade validación de email al formulario de contacto"
# Codex propone → tú apruebas → Codex ejecuta → repite

# Autopilot — ejecución autónoma completa
codex --autopilot "refactoriza el módulo de autenticación"
# Codex trabaja sin interrupciones hasta completar la tarea

# Auto Mode — clasificador inteligente de riesgos
codex  # Shift+Tab para ciclar entre modos hasta activar Auto Mode
# Las acciones seguras se ejecutan automáticamente
# Las arriesgadas se bloquean o escalan para tu aprobación

El Auto Mode es el más interesante: un clasificador integrado evalúa cada acción antes de ejecutarla. Editar un archivo de test en local → ejecuta solo. Borrar una rama de producción → te pregunta. No tienes que elegir entre velocidad y seguridad.

Comandos esenciales

# Iniciar sesión interactiva
codex

# Prompt directo sin UI interactiva
codex -p "¿cuántos archivos TypeScript hay en src/?"

# Continuar la última sesión
codex --continue

# Ejecutar en una rama específica
codex --from-pr 42  # Inicia sesión vinculada al PR #42

# Modo CI-friendly sin interacción
codex exec --profile once "ejecuta los tests y devuelve el resultado"

# Cambiar nivel de razonamiento
codex /reasoning high  # Para problemas que requieren más análisis
codex /reasoning low   # Para tareas simples, más rápido

# Fork de conversación — bifurcar desde un mensaje anterior
/fork  # Aparece en un punto anterior de la conversación

Subagentes en paralelo: la killer feature

Codex CLI permite ejecutar múltiples agentes en paralelo sobre el mismo repositorio usando worktrees de Git. Cada agente trabaja en una copia independiente del código sin interferir con los demás:

# Lanzar subagente en background con &
& analiza la cobertura de tests en el módulo de autenticación

# Seguir trabajando mientras el subagente trabaja
codex "implementa el nuevo endpoint de posts"

# Recuperar el resultado del subagente
/resume  # Lista las sesiones activas y permite cambiar entre ellas

Uso real: mientras revisas y apruebas cambios en el módulo principal, un subagente en background analiza el impacto en el bundle, otro revisa vulnerabilidades de dependencias y un tercero genera los tests para el código nuevo. Todo en paralelo.

Búsqueda web integrada

Codex CLI incluye una herramienta de búsqueda web de primera parte. Por defecto usa un caché de resultados indexados por OpenAI:

# Búsqueda en caché (por defecto) — resultados más seguros
codex "¿cuál es la mejor forma de implementar rate limiting en Next.js 15?"

# Búsqueda live — resultados más recientes
codex --search live "novedades de Next.js en marzo 2026"

# Desactivar búsqueda web
codex --search disabled "dame un ejemplo de middleware en Next.js"

La búsqueda en caché reduce el riesgo de prompt injection desde páginas web arbitrarias. La búsqueda live es mejor cuando necesitas información muy reciente.

Comandos slash personalizados

Codex incluye comandos slash built-in y permite crear los propios:

# Built-ins útiles
/review   # Revisión de código del diff actual
/fork     # Bifurcar la conversación desde un punto anterior
/model    # Cambiar modelo en mitad de sesión

# Crear comando personalizado
mkdir -p ~/.codex/commands
cat > ~/.codex/commands/revisar-seguridad.md << 'EOF'
Revisa el código actual buscando:
1. Inyección SQL o NoSQL
2. Variables de entorno expuestas en el cliente
3. Inputs sin sanitizar
4. Dependencias con CVEs conocidos
Devuelve un informe priorizado por severidad.
EOF

# Usar el comando personalizado
codex /revisar-seguridad

Integración con MCP

# ~/.codex/config.toml — configurar servidores MCP
[mcp]
servers = [
  { name = "github", command = "npx", args = ["@modelcontextprotocol/server-github"] },
  { name = "supabase", command = "npx", args = ["@supabase/mcp-server-supabase"] },
]

Con MCP configurado, Codex puede leer issues de GitHub, consultar el schema de Supabase o interactuar con cualquier herramienta que exponga un servidor MCP.

Errores comunes al usar Codex CLI

Usar autopilot sin un repositorio limpio. En autopilot, Codex actúa sin pedir confirmación. Si tienes cambios sin commitear que no quieres perder, asegúrate de hacer un commit o un stash antes de activarlo.

No revisar el transcript. Codex guarda un transcript completo de cada sesión con todas las acciones ejecutadas. Está en ~/.codex/threads/. Revísalo si algo no salió como esperabas.

Usar GPT-5.4 para todo. Para exploración de archivos, preguntas de documentación o búsquedas, GPT-5.4-mini es 3x más rápido y mucho más barato. Reserva GPT-5.4 para implementaciones complejas.

Ignorar el modo de razonamiento. Para problemas de arquitectura o debugging difícil, /reasoning high da resultados significativamente mejores. Para generar tests repetitivos, /reasoning low es más que suficiente y más rápido.

Conclusión

Codex CLI es open source, tiene 67K estrellas en GitHub, usa GPT-5.4 y tiene características únicas que no encontrarás en Claude Code: el Auto Mode con clasificador de riesgos, los subagentes en paralelo con worktrees nativos y la búsqueda web integrada con protección contra prompt injection.

No es mejor ni peor que Claude Code en términos absolutos. Es diferente, y esa diferencia es el tema del siguiente artículo donde los comparo cara a cara con tareas reales.