1. Introducción a Codex

Objetivo del tema

Presentar la versión 2025 de Codex CLI, comprender cómo se integra con los planes de ChatGPT y repasar los escenarios donde su enfoque de agente local marca la diferencia frente a otras experiencias de OpenAI.

1.1 ¿Qué es Codex CLI?

Codex CLI es un agente de desarrollo que se ejecuta en tu terminal y aprovecha modelos como GPT-5 para comprender repositorios completos. La herramienta es de código abierto y su evolución se publica en github.com/openai/codex. Al ejecutarse localmente, mantiene acceso directo al árbol de archivos, puede lanzar comandos bajo un sistema de aprobaciones y registra historiales asociados al directorio actual.

  • Inspecciona el proyecto y genera resúmenes que comparte con el modelo remoto.
  • Ejecuta scripts, tests y linters para adjuntar evidencias en sus respuestas.
  • Propone diffs y los aplica sólo cuando otorgas permiso explícito.

1.2 ¿Qué ofrece la experiencia actual?

La interfaz se divide en dos grandes modalidades:

  • TUI (Text User Interface - interfaz de usuario textual) interactiva: inicia con codex. Permite conversar, adjuntar archivos, cambiar de modelo con /model y revisar estado mediante /status.
  • Modo automatizado: ejecuta codex exec para convertir una tarea en un flujo reproducible. Puede devolver resultados en JSON, respetar plantillas y reanudarse con codex exec resume.

Los siguientes comandos son la puerta de entrada:

codex --version
codex "Explica la estructura de src/ y propone un plan de refactor"
codex resume --last
codex exec --full-auto "Genera pruebas para utils/date.ts"
codex exec --json "Resume hallazgos del repositorio"
codex completion bash

Codex también admite adjuntar imágenes (--image), modificar el directorio de trabajo sin cambiar de carpeta (--cd) y combinar instrucciones persistentes mediante archivos AGENTS.md.

1.3 Relación con ChatGPT y planes disponibles

Al ejecutar codex por primera vez, el CLI solicita iniciar sesión con tu cuenta de ChatGPT. Esa autenticación determina el modelo por defecto, los límites de uso y las políticas de almacenamiento. Los planes Plus, Pro, Team, Edu y Enterprise comparten la misma infraestructura, por lo que no necesitas credenciales separadas. También es posible usar una clave de la API exportando la variable CODEX_API_KEY o configurando perfiles en ~/.codex/config.toml.

1.4 Diferencias frente a otras experiencias de Codex

Codex CLI convive con la versión web y con extensiones para IDEs. Conocer sus matices ayuda a elegir la experiencia adecuada para cada tarea.

Comparativa de experiencias
Aspecto Codex CLI Codex Web Integración en IDE
Contexto Lee el directorio local y conserva el historial por sesión. Recibe archivos adjuntos o ZIPs y crea espacios en la nube. Trabaja sobre buffers y documentos abiertos dentro del editor.
Ejecución Corre comandos locales con sandbox configurable y requerimientos de aprobación. No ejecuta código; se limita a sugerir cambios para descargar. Puedes aceptar o rechazar snippets individuales dentro del IDE.
Automatización Incluye codex exec para flujos reproducibles y JSON estructurado. Foco en exploración y prototipos rápidos. Compatible con tareas interactivas, pero dependiente de cada extensión.
Casos ideales Equipos que viven en la terminal, pipelines CI/CD y auditorías controladas. Brainstorming, onboarding y presentaciones en vivo. Edición incremental en proyectos que ya dependen del IDE.

1.5 Casos de uso destacados

Codex CLI se adapta a diferentes etapas del ciclo de desarrollo:

  • Exploración guiada: resume repositorios, detecta dependencias y propone hojas de ruta iniciales.
  • Entrega incremental: genera diffs revisables y ejecuta pruebas entre cada iteración.
  • Documentación viva: produce reportes técnicos en Markdown, JSON u otros formatos estructurados.
  • Supervisión compartida: permite retomar sesiones con codex resume y dejar decisiones registradas en el historial.
  • Integración con otros agentes: gracias al soporte para Model Context Protocol, se puede exponer como servidor mediante codex mcp-server.

Cuanto más específico sea tu prompt (archivos, objetivos, restricciones), más precisas serán las recomendaciones. Complementa la conversación con resultados de comandos o fragmentos relevantes para acelerar el ciclo.

En resumen: Codex CLI combina el poder de los modelos de OpenAI con una experiencia local controlada por el desarrollador. Dominar sus modos de trabajo te permitirá alternar entre exploración interactiva y automatización reproducible sin abandonar la terminal.

Retornar