Tiempo: 60–90 minutos
Superficie: CLI o extensión de IDE
Plataformas: macOS, Windows y Linux
Carácter: opcional
Qué vas a aprender
- Utilizar Codex desde una terminal o editor manteniendo las normas de seguridad del curso.
- Reconocer los controles principales de una sesión.
- Decidir si estás preparado para continuar con «Codex para programadores».
La terminal no es un nivel de inteligencia
CLI e IDE ofrecen una relación más directa con archivos, Git, herramientas y automatización. Avanza hacia ellas cuando tu trabajo lo necesite. No son un requisito para haber aprendido a dirigir y revisar un agente.
La CLI en cuatro acciones
- Abre la terminal.
- Entra en la carpeta exacta.
- Inicia
codex. - Describe el resultado y revisa lo que propone.
cd /ruta/a/Aprender-Codex/mi-primera-web
codex
En Windows PowerShell utiliza rutas Windows. En WSL2 utiliza rutas Linux y mantén proyecto y herramientas dentro del mismo entorno.
Comprobaciones iniciales
codex --version
Dentro de la sesión, escribe / para ver los comandos reales de tu versión. Pueden incluir:
/status: configuración y uso; en CLI puede mostrar modelo, aprobación, raíces escribibles y contexto./permissions: perfil de permisos./model: modelo activo./plan: planificación, cuando está disponible./review: revisión de cambios en un repositorio Git./mention: añadir un archivo o carpeta al contexto.
No memorices una lista antigua: utiliza el selector de tu instalación.
Primer encargo CLI, todavía sin editar
Analiza esta carpeta sin modificar archivos. Enumera su estructura hasta dos
niveles, explica cómo abrir la web y señala cualquier archivo que no entiendas.
Indica las raíces escribibles y separa hechos observados de inferencias.
Comprueba con /status y el explorador de archivos que estás en la carpeta correcta.
Imágenes en CLI
Puedes adjuntar una captura al iniciar:
codex -i captura.png "Describe el problema visible y no cambies archivos"
Identifica qué muestra la imagen, qué zona importa y qué resultado esperas. Oculta notificaciones y datos personales.
Extensión de IDE
Sigue la documentación oficial para instalar la extensión compatible con Visual Studio Code. Después abre la carpeta, inicia sesión, revisa permisos y añade como contexto solo archivos o selecciones relevantes. La extensión comparte con CLI la configuración del mismo host, mientras sus preferencias visuales pertenecen al editor.
Windows nativo o WSL2
Utiliza Windows nativo si el proyecto y las herramientas viven en Windows. Elige WSL2 si tu flujo ya utiliza Linux. WSL1 no es una ruta compatible actual. En WSL2 instala bubblewrap y procura guardar repositorios bajo el hogar Linux.
Cuándo utilizar codex exec
codex exec ejecuta una tarea no interactiva. Es apropiado para análisis repetibles cuando entrada, salida, permisos y fallos están definidos. No es una solución para una petición ambigua.
codex exec --sandbox read-only "Revisa la estructura actual. No edites archivos. Devuelve riesgos y límites."
Práctica de transición
Lee AGENTS.md y resume las reglas activas. Revisa index.html y styles.css sin
editar. Propón una única mejora de accesibilidad, explica cómo verificarla y
espera mi aprobación.
Autoriza el cambio solo si comprendes el diff. Después abre la web y comprueba la mejora con teclado y una ventana estrecha.
Recuperación
Interrumpe si ruta o permisos no son correctos. En Git, conserva cambios ajenos y revisa git status antes de revertir. Si la instalación falla, codex doctor puede ayudar cuando está disponible; revisa el informe antes de compartirlo porque puede contener rutas u otros datos del sistema.
Error frecuente
Copiar comandos sin comprender el entorno. Antes de instalar, elevar permisos o usar red, pide qué cambia, qué acceso necesita y cómo se deshace.
Señales de que puedes continuar
- Abres la carpeta correcta.
- Comprendes lectura, escritura, red y acciones externas.
- Revisas un diff.
- Defines resultado y comprobación.
- No utilizas Full access como opción predeterminada.
- Conservas una versión recuperable.
Evidencia que debes guardar
- Versión y superficie.
- Estado sin datos sensibles.
- Primer análisis de solo lectura.
- Diff y comprobación de la mejora opcional.
Ejemplo resuelto: del lenguaje natural a un cambio revisable en el IDE
Dani abre un repositorio pequeño en el IDE. Antes de tocar código pide orientación:
No modifiques nada. Lee las instrucciones del repositorio y explícame:
- qué hace el proyecto;
- cómo se instala y ejecuta;
- dónde están las pruebas;
- qué estado tiene Git;
- qué dudas debes resolver antes de cambiar el formulario de contacto.
Con el mapa entendido, formula una tarea estrecha: validar que el correo tenga formato correcto y mostrar un mensaje accesible. Pide plan, cambio mínimo y pruebas. Mientras Codex trabaja, Dani observa archivos abiertos y comandos; si aparece una dependencia nueva sin justificación, corrige el rumbo.
Al terminar revisa el diff en el IDE, ejecuta la prueba indicada y hace una prueba manual. La respuesta final debe distinguir entre comprobaciones ejecutadas y recomendaciones no ejecutadas.
Traducción de términos: repositorio es la carpeta con historia de cambios; rama es una línea de trabajo; diff es la comparación; commit es un punto guardado con intención; prueba es una comprobación reproducible. No necesitas dominar todos los comandos para hacer preguntas precisas sobre ellos.
Ejercicio puente: pide a Codex que explique cada comando antes de ejecutarlo y que no utilice variantes destructivas. Luego intenta predecir el resultado de un comando de lectura, ejecútalo y compara.
Señal de alarma: se propone reescribir historia, descartar cambios ajenos, publicar una rama o utilizar secretos sin que la tarea lo exija.
Criterio de terminado: entiendes el propósito del cambio, el diff es limitado, las pruebas relevantes pasan y el repositorio no contiene cambios inesperados.
Cambia una variable
Repite el ejercicio desde CLI o desde IDE y anota qué interfaz te ayuda mejor a observar contexto, comandos y diferencias. La herramienta preferida puede depender de la tarea.
Comprueba que lo has entendido
- ¿Por qué se lee
AGENTS.mdo las instrucciones antes de modificar un repositorio? - ¿Un diff pequeño garantiza por sí solo que el cambio sea correcto?
Respuesta razonada
Las instrucciones contienen convenciones, límites y comprobaciones del proyecto. Un diff pequeño facilita revisar, pero todavía necesita pruebas y validación del comportamiento.
Fuentes oficiales
Revisado contra la documentación: 14 de julio de 2026.
Continuación recomendada: Codex para programadores.
Si has guardado la evidencia de esta lección, continúa con «Proyecto final según tu perfil». Si no, repite la comprobación antes de avanzar.