MÓDULO 2.1 / 3 DE 8
Terminal y Codex en la práctica
Abre un proyecto de entrenamiento en Codex y produce una modificación verificable.
1El terminal es una puerta de entrada
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.
En la práctica
Si abres Codex en la carpeta Downloads, no está trabajando automáticamente dentro de meu-primeiro-projeto. Debes elegir la carpeta de inicio.
✓ Hazlo
En Bash, ejecute pwd y luego ls. Lea la salida: primera ubicación, luego archivos. No altere nada en este paso.
✗ Evita
Aceptar una conclusión sin comprobar la entrada que la sustenta.
2Instala desde la fuente oficial
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.
En la práctica
Después de la instalación, codex --version informa la versión reconocida por el terminal. Si aparece “command not found”, reabra el terminal y verifique la ruta indicada por el instalador.
3Autentica sin divulgar secretos
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.
En la práctica
Para la API, el comando documentado es printenv OPENAI_API_KEY | codex login --with-api-key. Envía el valor directamente al programa, en lugar de mostrar la clave en pantalla.
Secuencia para experimentar
- Prepara una copia de entrenamiento.
- Elige un método, completa el inicio de sesión y ejecuta codex login status. Registra solo “ChatGPT” o “API” en la ficha del proyecto.
- Registra el resultado observado y la próxima corrección.
4Entra en la carpeta antes de solicitar
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.
En la práctica
El proyecto contiene README.md y entradas/reuniao.txt. La primera tarea es explicar esos dos archivos. No es necesario acceder a documentos personales ni a otros proyectos.
✓ Hazlo
En Bash: mkdir -p ~/projetos/meu-primeiro-projeto. Entra con cd ~/projetos/meu-primeiro-projeto e inicia codex.
✗ Evita
Mezclar la copia de entrenamiento con archivos privados o trabajo en producción.
5Realiza una primera tarea de lectura
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.
En la práctica
Solicitud inicial: “Lee AGENTS.md y README.md. Explica el propósito y lista lo que falta, sin editar.” Segunda solicitud: “Crea solo plano.md, con tres acciones y una verificación para cada una.”
6Usa permisos y recuperación
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.
En la práctica
El agente solicita acceso externo para consultar la documentación. Evalúa esa necesidad por separado de los permisos para borrar archivos o enviar mensajes.
Criterios para revisar su entrega
Use esta rúbrica después del laboratorio. Cada línea pide una evidencia; marcar lectura no significa que la práctica se haya ejecutado.
| Criterio | Evidencia esperada | Si no pasó |
|---|---|---|
| Alcance | La entrega corresponde al objetivo de esta clase. | Reduzca la tarea y nombre un único resultado. |
| Entradas | Usted sabe qué archivos o datos se usaron. | Liste las fuentes y elimine material sin relación. |
| Ejecución | El procedimiento se realizó en el entorno de entrenamiento. | Diferencie lo que se planificó de lo que se hizo. |
| Conferencia | Un resultado se comparó con una referencia. | Abra el archivo o repita la consulta verificable. |
| Secretos | No se compartió ningún token, contraseña o dato privado. | Revise la copia de trabajo antes de cualquier envío. |
| Continuidad | Otra persona puede encontrar el siguiente paso. | Actualice el README y registre una pendiente concreta. |
MANOS A LA OBRA / ~15 MIN O EN ETAPAS
Primer proyecto acompañado
Use archivos ficticios y una carpeta de entrenamiento. Las prácticas con instalación, Telegram o VPS pueden requerir tiempo adicional para registro y configuración.
Bash · Linux o macOS
Lea el bloque antes de usar. Campos como Su Nombre y usuario@ip-de-vps son ejemplos para adaptar; los comandos administrativos pertenecen solo a su entorno de entrenamiento.
mkdir -p ~/projetos/meu-primeiro-projeto cd ~/projetos/meu-primeiro-projeto pwd codex --version codex login codex login status codex
Criterio de listo
Abre un proyecto de entrenamiento en Codex y produce una modificación verificable. Registra el archivo creado, la prueba ejecutada y el resultado observado.
Abrir archivos y modelos del laboratorioCompruebe lo que quedó
Codex no encontró README.md. ¿El primer paso es aumentar el razonamiento?
Ver respuesta comentada
No. Verifica el directorio actual, el nombre del archivo y el permiso de lectura.
Si su respuesta fue diferente, vuelva al tema correspondiente y escriba la diferencia en una frase. La verificación no bloquea su estudio.
Resumen del módulo
- Terminal; shell; carpeta actual; comando y respuesta.
- Fuente oficial; instalación; versión; diagnóstico.
- codex login; codex login status; entrada estándar; cuenta activa.
- Alcance local; README; AGENTS; archivos de entrada.
- Inspeccionar; planear; cambiar; validar.
- Permiso mínimo; cambios pequeños; comparación; punto de retorno.
Consulte la fuente
Herramientas verificadas el 20/09/2026; los nombres de pantallas y la disponibilidad pueden cambiar.