Codex CLI · Agentes de IA para programar

Codex CLI es el agente de programación de código abierto de OpenAI para la terminal. Corre una interfaz de terminal (TUI) interactiva sobre tu repositorio local, edita archivos y ejecuta comandos de shell dentro de un sandbox impuesto por el sistema operativo, y también puede funcionar de forma no interactiva en scripts y en CI. Existe además un producto aparte, Codex cloud, que ejecuta tareas en contenedores gestionados por OpenAI; esta sección cubre el CLI local.

Repositorio: github.com/openai/codex
Documentación oficial: developers.openai.com/codex

Instalación

# macOS / Linux (script de instalación)
curl -fsSL https://chatgpt.com/codex/install.sh | sh

# npm
npm install -g @openai/codex

# Homebrew
brew install --cask codex

En Windows, usa el instalador de PowerShell:

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

También se publican binarios precompilados en GitHub Releases. Volver a ejecutar el mismo comando de instalación actualiza Codex; codex update se actualiza solo cuando la versión instalada lo admite.

Primer arranque y autenticación

codex          # abre la TUI interactiva
codex login    # inicia sesión (por defecto, OAuth de ChatGPT en el navegador)

Puedes entrar con una cuenta de ChatGPT (planes Plus/Pro/Business/Edu/Enterprise) o con una API key:

printenv OPENAI_API_KEY | codex login --with-api-key   # API key por stdin
codex login --device-auth                              # flujo de código de dispositivo
codex login status                                     # comprueba el estado (sale con 0 si hay sesión)

Las credenciales se guardan en ~/.codex/auth.json o en el almacén de credenciales del sistema. Para automatizar, la variable de entorno CODEX_API_KEY da autenticación por API key para una sola ejecución. La referencia completa está en Comandos de terminal.

Empezar rápido

# Sesión interactiva con la combinación local recomendada
codex --sandbox workspace-write --ask-for-approval on-request

# Ejecución única no interactiva (ideal para scripts)
codex exec "Resume qué hace este repositorio"

# Retoma tu sesión más reciente en este directorio
codex resume --last

Dentro de la TUI, escribe / para abrir el menú de comandos slash y @ para adjuntar archivos. Prueba /init para generar un AGENTS.md inicial para tu proyecto y luego pídele a Codex que te explique el código.

En esta sección

Documento	Qué cubre
Comandos slash	Todos los `/comando` verificados de la TUI, con explicaciones a fondo de los más importantes
Comandos de terminal	Comandos de terminal: `codex`, `exec`, `resume`, `login`, `mcp`, `review`, `apply`, `cloud` y más
Flags del CLI	Flags globales y de `codex exec`, agrupados por propósito
Configuración	`config.toml`: dónde está, campos clave, perfiles, precedencia y confianza de proyectos
Instrucciones de proyecto (AGENTS.md)	Cómo se descubre `AGENTS.md`, cómo se sobrescribe, sus límites de tamaño y un ejemplo
Subagentes	Subagentes: los integrados, los archivos TOML propios y las herramientas de spawn/wait
Skills	Skills (`SKILL.md`): estructura, descubrimiento, invocación y plugins
MCP	Conectar servidores MCP con `codex mcp add` y `config.toml`
Permisos	Políticas de aprobación, modos de sandbox, notas por plataforma y avisos de seguridad
Flujos de trabajo	Mini-flujos: entender, construir, depurar, refactorizar y revisar

Última verificación: 2026-09-07

Fuentes oficiales:

Las herramientas de IA para programar evolucionan rápido. Si encuentras información desactualizada, abre un issue o un pull request.