Qué es OpenAI Codex y cómo usar Codex CLI: guía práctica 2026

OpenAI Codex es el agente de programación de OpenAI: lee tu código, lo modifica, ejecuta comandos y tests y te devuelve los cambios para que los revises. No es un autocompletado al uso, sino un asistente al que le encargas tareas completas («añade validación a este formulario y escribe los tests», «actualiza esta dependencia y arregla lo que se rompa») y que trabaja hasta terminarlas o hasta que necesita tu permiso.

En esta guía nos centramos en Codex CLI, la versión para terminal, que es la más flexible para desarrolladores y la que mejor encaja en scripts y pipelines. Todos los datos están contrastados con la documentación oficial a fecha de octubre de 2026.

¿Dónde se puede usar Codex?

Codex está disponible en varias superficies que comparten cuenta y, en buena medida, configuración:

Codex CLI: el agente local en tu terminal. Es de código abierto con licencia Apache-2.0 (repositorio openai/codex en GitHub).
Extensión para IDE: disponible para VS Code, Cursor y Windsurf.
App de escritorio: se abre con codex app o desde chatgpt.com/codex.
Codex en la nube: tareas que se ejecutan en la infraestructura de OpenAI aunque cierres el portátil, con revisión desde web, escritorio o móvil.

¿Cómo instalar Codex CLI?

El instalador oficial para macOS y Linux es un script de una línea (el mismo comando sirve para actualizar):

curl -fsSL https://chatgpt.com/codex/install.sh | sh

En Windows, desde PowerShell:

powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"

Si prefieres un gestor de paquetes, también puedes usar npm o Homebrew:

npm install -g @openai/codex
brew install --cask codex

Hay además binarios para macOS (Apple Silicon y x86_64) y Linux (x86_64 y arm64) en las releases de GitHub.

¿Cómo iniciar sesión: cuenta de ChatGPT o clave de API?

Entra en la carpeta de tu proyecto y ejecuta codex. La primera vez te pedirá elegir método de acceso. Hay dos caminos:

Iniciar sesión con ChatGPT (recomendado): el uso se descuenta de tu plan de ChatGPT, ya sea Plus, Pro, Business, Edu o Enterprise.
Clave de API: requiere algo más de configuración y se factura a precios estándar de la API. Con clave de API tienes CLI, SDK e IDE, pero no las funciones en la nube.

Ojo a un cambio reciente: desde el 14 de octubre de 2026, GPT-5.5 ya no está disponible en Codex para quienes inician sesión con ChatGPT (las sesiones con clave de API no se ven afectadas). El sustituto indicado es GPT-6.1 Sol (gpt-6.1-sol), que ya era el modelo por defecto del catálogo desde finales de septiembre.

Primeros pasos dentro de una sesión

Una vez dentro, escribes en lenguaje natural lo que quieres. Estos comandos con barra son los primeros que conviene conocer:

/init: crea un archivo AGENTS.md con instrucciones para Codex (convenciones, cómo ejecutar los tests, qué no tocar). Es lo primero que recomendamos hacer en cualquier repositorio.
/status: muestra la configuración de la sesión actual.
/permissions: define cuándo puede editar archivos o ejecutar comandos sin preguntarte.
/model: elige modelo y nivel de razonamiento.
/review: revisa cambios contra una rama base, los cambios sin confirmar o un commit concreto, sin modificar tu árbol de trabajo.

Y desde la línea de comandos:

codex resume      # retoma una conversación reciente del repositorio
codex --search    # activa la búsqueda web en directo para esa ejecución
codex cloud       # envía trabajo a la nube y aplica después el resultado
codex mcp         # gestiona conexiones con servidores MCP

¿Qué es el sandbox de Codex y qué modo de permisos elegir?

Codex separa dos conceptos: el sandbox (qué puede tocar técnicamente) y la política de aprobación (cuándo te pregunta). Los modos de sandbox documentados son:

read-only: puede leer archivos y ejecutar comandos dentro del sandbox de solo lectura.
workspace-write: puede leer, editar y ejecutar comandos dentro del espacio de trabajo; salir de él o usar la red requiere aprobación.
danger-full-access: sin sandbox. Úsalo solo en entornos desechables.

Las políticas de aprobación más habituales son on-request (lo permitido por el sandbox se ejecuta sin preguntar) y never (no pregunta, pero el sandbox sigue aplicando). El preset Auto equivale a:

codex --sandbox workspace-write --ask-for-approval on-request

Por defecto, el agente funciona sin acceso a red. Existe la opción --dangerously-bypass-approvals-and-sandbox (alias --yolo), que elimina sandbox y aprobaciones a la vez; nuestra recomendación es no usarla nunca en tu máquina de trabajo.

Lee también: Copilot cloud agent (antes coding agent): guía para delegar issues

Configurar Codex con config.toml

La configuración personal vive en ~/.codex/config.toml, y cada proyecto puede tener su propio .codex/config.toml (solo se carga si marcas el proyecto como de confianza). Un ejemplo razonable para empezar:

model = "gpt-6.1-sol"
approval_policy = "on-request"
sandbox_mode = "workspace-write"
model_reasoning_effort = "medium"
web_search = "cached"

Si necesitas red dentro de workspace-write (por ejemplo, para instalar paquetes), se habilita así:

[sandbox_workspace_write]
network_access = true

Los flags de línea de comandos tienen prioridad sobre la configuración del proyecto, y esta sobre la personal. También puedes crear perfiles y cargarlos con --profile nombre.

¿Cómo usar Codex en scripts y CI?

Para automatizaciones existe codex exec, que ejecuta Codex de forma no interactiva: útil en pipelines, hooks o tareas programadas. Por ejemplo, para generar un resumen de cambios antes de una release:

codex exec "Resume los cambios desde la última etiqueta y propón notas de versión"

En CI lo habitual es autenticar con clave de API y mantener un sandbox restrictivo. Recuerda que con clave de API el consumo se cobra a tarifa de API, no contra tu plan de ChatGPT.

¿Cuánto cuesta Codex? Planes a fecha de octubre de 2026

Según la página de precios oficial de Codex:

Free (0 $/mes) y Go (8 $/mes): tareas rápidas con GPT-6 Luna en la app de escritorio, sujeto a despliegue.
Plus (20 $/mes): Codex en web, CLI, IDE e iOS, integraciones en la nube, GPT-6.1 Sol y GPT-6 Luna.
Pro: planes de 100, 200 o 500 $/mes; el de 500 incluye el modo Ultrafast. Actualmente sin límite de cinco horas.
Business: 20 $ por usuario/mes con facturación anual (mínimo 2 usuarios) o 25 $ mensual.
Enterprise y Edu: precio bajo consulta, con controles de cumplimiento y residencia.

En Plus y Business Standard los límites se expresan en mensajes estimados por ventana de cinco horas: por ejemplo, entre 15 y 160 con GPT-6.1 Sol y entre 350 y 3.000 con GPT-6 Luna, con posibles límites semanales adicionales. Si se agotan, Plus y Pro pueden comprar créditos extra.

Consejos para no llevarte sustos

Haz un commit antes y después de cada tarea: la propia OpenAI recomienda crear puntos de control en Git para poder revertir.
Invierte en tu AGENTS.md: explicar cómo se lanzan los tests y qué carpetas no tocar mejora más los resultados que cambiar de modelo.
Empieza con workspace-write y on-request y amplía permisos solo cuando entiendas qué está haciendo.
Usa /review antes de abrir un PR, también con código que no haya escrito Codex.

Si estás decidiendo entre herramientas, en nuestra comparativa de Codex, Claude Code, GitHub Copilot y Antigravity analizamos precios, agentes en la nube y para qué perfil encaja cada uno.