Si programas y vives en la terminal, hay una forma más directa de trabajar con IA que copiar y pegar código del chat: operar sobre tu repositorio real. Codex CLI es el agente de programación de OpenAI que corre en la terminal: lee tus archivos, propone cambios, ejecuta comandos y revisa diffs sin salir del proyecto.
Respuesta corta
Codex CLI permite trabajar con el agente de programación de OpenAI desde la terminal: leer un repo, hacer cambios, ejecutar comandos, revisar diffs, usar imágenes y retomar conversaciones anteriores.
Instalación y primer inicio de sesión
En macOS o Linux, el instalador oficial es:
curl -fsSL https://chatgpt.com/codex/install.sh | sh
También puedes instalarlo con npm o Homebrew si prefieres manejarlo con tu gestor de paquetes. Después, entra a la carpeta del proyecto y ejecuta codex. La primera vez te pide iniciar sesión: elige "Sign in with ChatGPT" o el método que tengas disponible. Para confirmar que quedó bien, pídele que describa el proyecto antes de tocar nada.
Comandos que vas a usar todos los días
codex— abre la sesión interactiva dentro del proyecto.codex "prompt"— arranca con una tarea concreta.codex resume— retoma una conversación anterior del repositorio.codex --image— adjunta una captura o diagrama al primer prompt.codex exec— modo no interactivo para scripts y CI./model,/permissions,/review,/status,/init— comandos dentro de la sesión para elegir modelo, definir permisos, revisar cambios y crear unAGENTS.md.
Permisos, modelos e imágenes
/permissions define qué puede hacer Codex sin preguntarte: editar archivos, ejecutar comandos o quedarse en modo lectura. Empieza con permisos de lectura y aprobación por cambio; suelta autonomía solo cuando entiendas el flujo. Con /model eliges el modelo y el esfuerzo de razonamiento según la tarea: una explicación rápida no necesita lo mismo que una migración. Y con codex --image, o pegando una imagen en el compositor, le das contexto visual: una captura de error o un diagrama valen más que tres párrafos.
Un ejemplo real, de principio a fin
Supongamos que un endpoint devuelve datos duplicados.
cd ~/proyectos/mi-api
codex
Dentro de la sesión:
Explícame cómo funciona src/api/usuarios.ts y dónde se podrían duplicar los resultados. No cambies nada todavía.
Cuando tengas el diagnóstico, pide un cambio chico:
Aplica el cambio mínimo para evitar duplicados y muéstrame el diff antes de ejecutar tests.
Después verifica con evidencia real: corre npm test, revisa el diff y confirma que el caso que fallaba ahora pasa. La regla es simple: cada paso deja una prueba; si no hay evidencia, todavía no terminó.
Errores que frenan el resultado
- Pedir cambios gigantes de una sola vez. Mejor una tarea chica por vuelta.
- No revisar el diff. Nunca aceptes ni publiques sin leer qué cambió.
- Dar permisos totales desde el minuto uno. La autonomía se gana por tarea.
- Ignorar el contexto. Un
AGENTS.mdcon las convenciones del repo ahorra idas y vueltas. - No guardar lo que funciona. Un prompt o comando que resolvió bien se convierte en plantilla.
Checklist antes de publicar
- El repo está limpio o commiteado antes de empezar.
- Leí el diff completo.
- Corrí tests o build y tengo la salida a mano.
- Revisé permisos, dependencias y que no haya secretos en el texto.
- Dejé el cambio acotado a lo que pedí.
Preguntas frecuentes
¿Necesito saber programar para usar Codex CLI?
Ayuda manejar la terminal y un repo con Git, pero puedes empezar con tareas chicas: leer código, explicar funciones y hacer cambios puntuales con revisión.
¿Codex CLI modifica archivos solo?
Puede proponer y aplicar cambios según el modo que elijas. Revisa siempre el diff antes de aceptar, y empieza con permiso de lectura más aprobación por cambio.
¿En qué se diferencia de copiar código del chat?
Trabaja dentro de tu proyecto real: ve tus archivos, ejecuta comandos y retoma contexto. El chat te da texto; la CLI opera sobre tu repo.
Próximo paso
Usa este artículo como primera práctica antes de entrar a proyectos más grandes. El curso de IA de AIClases te da una ruta ordenada para pasar de tareas sueltas a flujos con criterio.