Qué vas a aprender
- Instalar y comprobar Codex CLI.
- Distinguir CLI, extensión de IDE, app y tareas en la nube.
- Abrir una primera sesión dentro de un repositorio.
Instalación mínima
Codex CLI trabaja sobre los archivos y herramientas de tu máquina. En macOS y Linux, OpenAI recomienda el instalador autónomo. npm sigue disponible como alternativa multiplataforma. Comprueba la versión antes de iniciar sesión.
# Recomendado en macOS y Linux curl -fsSL https://chatgpt.com/codex/install.sh | sh # Alternativa con npm npm install -g @openai/codex codex --version cd ~/codigo/mi-proyecto codex
En el primer inicio, sigue el flujo de autenticación que muestra Codex. Dentro de la sesión, /status resume el directorio, modelo y permisos activos.
/status /permissions /model
Qué superficie elegir
- CLI: trabajo local rápido, scripts y una relación directa con Git y la terminal.
- IDE: cambios ligados al archivo y selección que estás viendo.
- App: tareas largas, revisión visual y coordinación de varios trabajos.
- Nube: trabajo aislado y delegable cuando el entorno ya está configurado.
Codex junto a Cursor, Windsurf o tu IDE
No hace falta elegir una sola herramienta. Usa Cursor, Windsurf o tu IDE para edición localizada, navegación visual y refactors pequeños. Usa Codex cuando necesites recorrer un repo, ejecutar comandos, revisar Git, automatizar pruebas o cerrar una tarea completa con evidencia.
La regla práctica: si el contexto está en una pantalla, el IDE va muy bien; si el contexto vive en muchos archivos, comandos, logs y commits, Codex suele darte más control operativo.
Primera comprobación
Pide una tarea de solo lectura: «Resume la arquitectura, dime cómo se ejecutan los tests y no cambies archivos». Revisa que Codex detecte correctamente el lenguaje, el gestor de paquetes y el estado de Git.
Entrega de la lección
Qué vas a construir
Un entorno Codex funcional y una primera sesión de solo lectura.
Por qué es importante
Antes de delegar cambios necesitas saber qué superficie usar, qué permisos están activos y cómo comprobar la instalación.
Repositorio o archivos iniciales
Cualquier repositorio pequeño con Git inicializado. Si no tienes uno, crea una carpeta vacía con README.md.
Pasos
- 1. Instala Codex CLI.
- 2. Comprueba la versión.
- 3. Abre Codex dentro del repositorio.
- 4. Ejecuta /status, /permissions y /model.
- 5. Pide un análisis sin editar archivos.
Encargo listo para Codex
Resume la arquitectura de este repositorio, dime cómo se ejecutan los tests y no cambies archivos. Cita rutas concretas y separa hechos observados de inferencias.
Resultado esperado
Codex identifica el tipo de proyecto, comandos probables y límites de lo que todavía no ha inspeccionado.
Comando de verificación
codex --version && git status --short
Comprobación manual
Confirma que no aparecen cambios en git status después del análisis.
Mini ejercicio
Abre una segunda sesión y pide el mismo análisis limitándolo a una carpeta concreta.
Ver solución
Usa un prompt con alcance explícito: «Céntrate solo en app/ y di qué partes no has leído».
Evidencia que debes guardar
Guarda versión de Codex, salida de /status y git status limpio.
Fuentes oficiales y versión probada
Si has guardado la evidencia de esta lección, continúa con «Explora un repositorio sin perderte». Si no, repite la comprobación antes de avanzar.