MÓDULO 2.1
Terminal y Codex en la práctica
Abre un proyecto de entrenamiento en Codex y produce una modificación verificable.
Qué es
El terminal es la ventana en la que escribes comandos para la computadora. Shell es el programa que interpreta esos comandos. Aquí los ejemplos de terminal usan Bash en Linux o macOS; en Windows, usa un entorno Bash vía WSL o sigue el instalador oficial para Windows. No pegues comandos de Linux directamente en PowerShell sin adaptación.
Por qué aprender
Saber en qué entorno estás evita errores que parecen fallas de la IA. El comando cd cambia la carpeta actual; pwd muestra la ubicación en Bash. No es necesario memorizar decenas de comandos para comenzar.
Conceptos clave
Terminal; shell; carpeta actual; comando y respuesta.
Qué es
La página oficial de Codex ofrece instalador para macOS/Linux y orientaciones específicas para Windows. Instalar significa añadir el programa a la máquina. El comando de instalación descarga y ejecuta un script oficial; lee la fuente, verifica el dominio y usa tu propia cuenta. No ejecutes comandos recibidos de páginas desconocidas.
Por qué aprender
Instalación, inicio de sesión y ejecución son etapas diferentes. Un programa instalado aún necesita autenticación. Un inicio de sesión completado no significa que hayas abierto la carpeta correcta.
Conceptos clave
Fuente oficial; instalación; versión; diagnóstico.
Qué es
Ejecuta codex login y completa el flujo del navegador para entrar con ChatGPT. Si optas por API, la clave debe estar en la variable OPENAI_API_KEY; pásala por la entrada estándar, sin escribirla en el comando. Un archivo .env solo no autentica a Codex: algún mecanismo debe cargar la variable.
Por qué aprender
Pegar la clave en ejemplos, mensajes o historial puede exponer la cuenta. También es posible estar autenticado con el método incorrecto y consumir una modalidad diferente a la esperada.
Conceptos clave
codex login; codex login status; entrada estándar; cuenta activa.
Qué es
La carpeta de trabajo es la bancada de la tarea. Crea un área pequeña, con archivos de entrenamiento, antes de permitir cambios. Un README.md describe la finalidad para las personas; AGENTS.md da instrucciones operativas al agente. No necesitas abrir toda tu carpeta personal para experimentar.
Por qué aprender
Un alcance pequeño reduce la ambigüedad y facilita revisar diferencias. Cuando algo sale mal, queda claro qué archivos deberían haber sido afectados.
Conceptos clave
Alcance local; README; AGENTS; archivos de entrada.
Qué es
Comienza solicitando inspección: listar la estructura, leer instrucciones y explicar pendientes. Pide que el agente cite qué archivos utilizó. Después de comprobar, autoriza un cambio pequeño y nombrado, como crear plano.md con tres próximos pasos.
Por qué aprender
Separar diagnóstico y cambio crea una referencia para la revisión. Aprendes el flujo sin mezclar instalación, gran refactorización y publicación en un solo intento.
Conceptos clave
Inspeccionar; planear; cambiar; validar.
Qué es
Los permisos del cliente controlan el acceso a archivos, red y ejecución. Las instrucciones en lenguaje natural orientan el comportamiento, pero no sustituyen el aislamiento técnico. Comienza con permisos restringidos a la carpeta de entrenamiento. No enseñes a eliminar todas las protecciones para sortear cualquier error.
Por qué aprender
Recuperar un cambio requiere saber qué existía antes. Git y copias de archivos ofrecen puntos de retorno; se practicarán más adelante. Lee lo que hará el comando antes de ampliar permisos.
Conceptos clave
Permiso mínimo; cambios pequeños; comparación; punto de retorno.