Qué es
Codex CLI es el agente de línea de comandos oficial de OpenAI para coding, lanzado en 2025 y mantenido en el repo openai/codex bajo Apache-2.0. Corre localmente en tu terminal, engancha con auth de ChatGPT Pro/Plus o API, y usa los modelos de razonamiento de OpenAI (familia GPT-5 + serie o) con tooling completo de file-edit, shell y patch.
Codex CLI también es la herramienta que popularizó la convención AGENTS.md — un equivalente vendor-neutral del CLAUDE.md de Claude. AGENTS.md ahora es adoptado por múltiples agentes (Aider, Continue.dev, pronto Gemini CLI), haciendo que tus instrucciones project-level sean portables.
Es la herramienta a la que recurrir cuando:
- Ya pagas ChatGPT Pro/Plus y quieres usar esa cuota para coding en terminal.
- Quieres un archivo de instrucciones vendor-neutral que otros agentes respetarán.
- Te gustan las fortalezas de los modelos de razonamiento de OpenAI en pasadas de bug-finding y refactor-planning.
Por qué destaca
| Característica | Qué te da |
|---|---|
| Auth ChatGPT | Inicia sesión con tu cuenta ChatGPT Pro/Plus — sin API key separada |
| AGENTS.md | Archivo de instrucciones vendor-neutral, soportado entre agentes |
| Apache-2.0 | Misma licencia OSI que Gemini CLI; puedes hacer fork libremente |
| Soporte MCP | Añadido a finales de 2025; Codex CLI ya lee ~/.codex/mcp.json |
| Modos de aprobación | --auto-edit, --full-auto, --read-only para confianza graduada |
| Modelos de razonamiento | Fortalezas de GPT-5 / serie o en pases de planificación profunda |
| Shell con sandbox | Apple Seatbelt en macOS, Landlock en Linux para ejec más seguro |
Cómo instalar
# macOS / Linux / WSL
npm install -g @openai/codex
# O vía Homebrew
brew install codex
Tras instalar, corre codex en cualquier directorio de proyecto. El primer run pide login ChatGPT (OAuth navegador) o OPENAI_API_KEY. Pon un AGENTS.md en la raíz del repo con las convenciones del proyecto y Codex CLI lo leerá al inicio de cada sesión.
Qué instalar dentro de Codex CLI
La superficie de Codex CLI usa dos configs principales: ~/.codex/config.toml para settings globales y AGENTS.md (project-level) para instrucciones. Tres packs TokRepo para empezar:
- Plantillas AGENTS.md — archivos de instrucciones probados en batalla para monorepos Python / Node / Go / Rust
- Stack de Servidores MCP — servers MCP de Postgres, GitHub, Filesystem compartidos con Claude Code
- OpenAI Reasoning Workflow Pack — comandos codex afinados para fortalezas de la serie o
Lanza tokrepo install con cualquiera y tu AGENTS.md más directorio ~/.codex/ arrancan en la baseline que muestran los previews de research de OpenAI.
Errores comunes
- Mezclar API key y auth ChatGPT — elige una; mezclar hace que el CLI pingee ambos endpoints con cuotas conflictivas.
- Olvidar el coste de
--full-auto— full auto corre todos los comandos shell propuestos; combina con sandboxing o reharásnpm install30 veces en un loop de refactor. - AGENTS.md creciendo sin control — Codex lo re-lee cada turno. Mantén bajo 200 líneas o mueve trozos a archivos
AGENTS.mdpor directorio. - Resolución de path MCP — Codex mira
~/.codex/mcp.json, no.claude/. No los simlinkees; conviértelos con el flagtokrepo migrate. - macOS Seatbelt bloquea herramientas GUI — si tus tareas necesitan browser automation, corre con
--sandbox=nonesolo dentro de una VM desechable, nunca en tu máquina dev.
Relación con otras herramientas
La mayor victoria de Codex CLI es la convención AGENTS.md — muchos agentes respetan ese archivo, así que escribirlo bien paga a través de toda tu toolchain. Comparado con Claude Code, Codex CLI tiene un ecosistema de subagents menos maduro pero integración más estrecha con cuentas ChatGPT Pro. Comparado con Gemini CLI, le falta la fluidez multimodal pero ofrece los modelos de la serie o para refactors duros. Muchos equipos en 2026 usan Codex CLI como entorno de autoría AGENTS.md y rotan otros agentes para fases específicas.
Lo más instalado para Codex CLI
7 recursos compatibles con Codex CLI
Preguntas frecuentes
¿Es Codex CLI gratis?
El CLI en sí es Apache-2.0 open source y gratis. Para correrlo necesitas o una API key de OpenAI (pay-as-you-go) o suscripción ChatGPT Pro/Plus. ChatGPT Pro a $200/mes da la cuota Codex CLI más generosa; Plus a $20/mes funciona para uso ligero.
¿Qué es AGENTS.md y por qué Codex CLI lo usa?
AGENTS.md es un archivo vendor-neutral en la raíz de tu proyecto que le dice a cualquier agente cómo trabajar en ese codebase — convenciones de código, comandos de build, qué evitar. Codex CLI fue el primer agente importante en darle soporte, y la spec en agents.md ya es adoptada por Aider, Continue y otros. Escribe una vez, porta entre herramientas.
¿Funciona Codex CLI con modelos Claude o Gemini?
Oficialmente Codex CLI sale apuntando a modelos OpenAI (GPT-5, serie o). Forks comunitarios permiten cambiar base URLs a OpenRouter o endpoints compatibles con Anthropic, pero los esquemas de tool-call difieren lo bastante para ser frágiles. La ruta mainstream es modelos OpenAI para Codex CLI, CLIs separados para otros vendors.
Codex CLI vs Claude Code — ¿cuál es mejor?
Fortalezas distintas. Claude Code tiene el ecosistema de subagents y hooks más maduro. Codex CLI tiene la mejor integración con ChatGPT Pro y arrancó la convención AGENTS.md. Muchos devs corren ambos: Codex CLI cuando quieren los modelos de razonamiento de OpenAI, Claude Code para refactors largos multi-paso.
¿Puede Codex CLI correr en CI / no-interactivo?
Sí. Usa codex --quiet --full-auto con OPENAI_API_KEY seteado. Patrón común: job de GitHub Actions que corre Codex CLI para draftear una review de PR o codemod, luego humanos aprueban antes de merge. Combina con --sandbox=workspace-write para limitar el daño.
Explora todas las herramientas en la página principal
8 herramientas curadas · logos reales · agrupadas por tipo
Volver a todas las herramientas