Da el salto a CLI, IDE y repositorios cuando lo necesites

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.md o 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.