Instalar Codex CLI: guía básica

Objetivo

Al terminar vas a tener Codex CLI instalado, autenticado (con tu cuenta de ChatGPT o una API key), y una primera sesión corriendo sobre un proyecto real, con los ajustes de aprobación y de modelo a tu gusto.

Codex CLI es el agente de código en terminal de OpenAI. Lee tu código, edita archivos y ejecuta comandos a partir de instrucciones en lenguaje natural, con un sandbox y un modelo de aprobación que definen cuánto puede hacer sin preguntar. Corre en modo interactivo o no interactivo (codex exec) y soporta servidores MCP.

Prerrequisitos

macOS, Linux o Windows.
Una terminal con permisos para instalar binarios en tu PATH.
Alguno de estos: un plan de ChatGPT que incluya Codex (Plus, Pro, Business, Edu o Enterprise), o una API key de OpenAI con crédito.
Un proyecto local sobre el que trabajar.
Una versión LTS reciente de Node.js (20+) solo si instalás vía npm; el instalador standalone y Homebrew no lo necesitan.

Esta guía cubre Codex CLI al estado de septiembre de 2026.

Pasos

1. Instalar el binario

Elegí el método según tu sistema.

macOS / Linux (instalador standalone):

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

Windows (PowerShell):

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

Homebrew:

brew install --cask codex

npm:

npm install -g @openai/codex

Para actualizar más adelante, volvé a correr el comando del instalador, o brew upgrade --cask codex / npm install -g @openai/codex@latest.

2. Verificar la instalación

codex --version

Verificación esperada: imprime la versión instalada. Si la terminal responde "command not found", abrí una sesión nueva para que tome el PATH actualizado.

3. Iniciar sesión

Andá a un proyecto y arrancá Codex:

cd ruta/a/tu/proyecto
codex

En el primer arranque te pregunta cómo autenticarte:

Sign in with ChatGPT (recomendado) — se abre un navegador; el uso se descuenta de tu plan de ChatGPT.
API key — corré codex login --api-key y pegá una key, o exportala antes de arrancar:

export OPENAI_API_KEY=tu-api-key
codex

Por SSH, copiá la URL que se imprime en la terminal y abrila en tu máquina local.

4. Configurar aprobaciones y modelo

Dentro de la sesión:

/permissions   # Read Only, Auto o Full Access
/model         # elegir modelo y esfuerzo de razonamiento
/status        # ver la configuración de la sesión actual

Read Only responde preguntas sin tocar nada. Auto edita archivos y ejecuta comandos dentro del workspace, y pregunta antes de cualquier cosa fuera de él. Full Access elimina los prompts — usalo solo en un sandbox o un entorno descartable.

5. Correr tu primera tarea

Describí el cambio en lenguaje natural:

Agregá validación de input al handler de signup y un test para eso

Codex planifica, edita, corre el test y te reporta.

6. Correrlo en modo no interactivo

Para scripts y CI:

codex exec "generá una entrada de CHANGELOG a partir de los últimos 5 commits"

Resultado esperado

codex --version imprime una versión.
codex arranca y /status muestra que estás autenticado, con un modelo y un modo de aprobación definidos.
Una primera tarea en lenguaje natural produce cambios reales en archivos.
codex exec "..." corre sin prompt interactivo.

Troubleshooting

Problemas comunes

codex: command not found después de instalar: el instalador actualizó tu PATH pero la shell actual no lo recargó. Abrí una terminal nueva.
La instalación por npm falla o da error con un Node viejo: el paquete npm necesita una versión LTS reciente de Node.js (20+). Actualizá Node, o usá el instalador standalone / Homebrew, que traen su propio runtime.
Errores 401 / de auth con una API key: confirmá que OPENAI_API_KEY esté exportada en la misma shell, y que el proyecto de esa key tenga crédito. codex login --api-key la vuelve a guardar.
El login con ChatGPT entra en loop o no abre: copiá a mano la URL que se imprime en un navegador; útil por SSH.
Codex no edita archivos: estás en modo Read Only. Cambiá con /permissions.
Un OPENAI_API_KEY conflictivo pisa tu login de ChatGPT: si querías usar tu plan, quitá esa variable de tu perfil de shell.

Siguiente paso

Configurá Codex por máquina en ~/.codex/config.toml (modelo por defecto, esfuerzo de razonamiento, servidores MCP, aprobaciones por defecto), y agregá contexto del proyecto en un archivo AGENTS.md en la raíz del repo.