Guía rápida para empezar con Codex, el agente de programación de OpenAI

Codex es el agente de programación de OpenAI. Y la palabra importante es agente: no es solo un chat que responde dudas de código. Puede leer proyectos completos, editar archivos, ejecutar comandos, revisar errores, correr pruebas y ayudarte a avanzar tareas técnicas de principio a fin.

En esta guía te explicamos cómo usar Codex desde el primer día: qué puede hacer, dónde usarlo, cómo pedirle las cosas para que salgan bien a la primera, y cómo integrarlo a tu rutina — seas desarrollador o estés aprendiendo.

Qué puede hacer Codex

Si tu tarea involucra código, archivos, errores, comandos o pasos repetitivos, probablemente Codex puede ayudar:

• Escribir código a partir de una idea.
• Explicar código que no entiendes — tuyo o heredado.
• Encontrar bugs y proponer soluciones.
• Modificar proyectos existentes respetando su estructura y estilo.
• Crear pruebas, correrlas y revisar si algo se rompió.
• Hacer refactors, migraciones y limpieza de código.
• Revisar pull requests o tus cambios locales antes de entregar.
• Automatizar tareas recurrentes.
• Conectarse con herramientas externas mediante plugins, skills, MCP o conectores (Slack, GitHub, Linear…).

Dónde se puede usar

Codex vive en varias superficies, y cada una tiene su momento ideal:

Cómo pedirle cosas bien: la fórmula de 4 partes

Codex trabaja tan bien como la petición que recibe. Una buena petición tiene cuatro partes:

1. Objetivo: «Quiero arreglar el bug donde el login falla con cuentas nuevas.»
2. Contexto: «Revisa app/Auth, routes/web.php y este error: …»
3. Restricciones: «No cambies la base de datos si no es necesario.»
4. Listo cuando: «Los tests pasen y me expliques qué cambiaste.»

La parte que más se olvida — y más retrabajo causa — es la última: sin criterio de «terminado», nadie sabe si ya quedó.

Para tareas difíciles o ambiguas, hay dos movimientos que valen oro antes de pedir el cambio:

• «Antes de modificar código, revisa el proyecto y dame un plan.» — Revisar un plan es barato; revisar un desastre es caro.
• «Hazme preguntas hasta que el requerimiento esté claro.» — Codex detecta ambigüedades que tú no viste.

Buenos primeros usos (la escalera de la primera semana)

Empieza con tareas pequeñas y de bajo riesgo, y sube la complejidad:

• «Explícame cómo está organizado este proyecto.»
• «Encuentra dónde se maneja el login.»
• «Convierte esta idea en una lista de tareas técnicas.»
• «Revisa mis cambios como si fuera un PR.»
• «Crea una prueba para este caso.»
• «Arregla este error y corre las pruebas relevantes.»
• «Limpia este componente sin cambiar su comportamiento.»

Las primeras son de solo lectura — riesgo cero. Aprendes a pedirle y a leer sus respuestas sin poder romper nada.

Cómo integrarlo a tu vida diaria

Para programar: antes de empezar, pídele que explore el repo y ubique los archivos importantes. Durante el trabajo, pide cambios concretos y que explique sus decisiones. Antes de terminar, que corra los tests, revise el diff y busque riesgos. Y después de un bug, pídele una mini retrospectiva y cómo evitar repetirlo.

Para aprender: úsalo como tutor — pide explicaciones por niveles (principiante, intermedio, experto), mapas del proyecto (arquitectura, flujo de datos, dependencias) y hazle la pregunta que evita la mitad de los desastres: «¿qué debería entender antes de tocar esta parte?».

Para organizarte: convertir ideas vagas en planes, dividir proyectos grandes en pasos, crear checklists, preparar documentación y resumir decisiones técnicas.

Para el equipo: crea un AGENTS.md en cada proyecto con las reglas de la casa — cómo correr los tests, estilo de código, convenciones y la definición de «terminado». Codex lo lee y trabaja como el equipo trabaja, sin que se lo repitan en cada tarea. Súmale revisión de PRs, skills para flujos repetidos y conectores con Slack, GitHub o Linear.

Usos prácticos fuera de la programación

Aunque nació como agente de programación, cada vez más gente usa Codex para administrar su trabajo diario — de hecho, OpenAI reporta que su base de usuarios crece más rápido entre no-desarrolladores. La lógica es simple: si Codex puede leer archivos, ejecutar comandos y seguir instrucciones, entonces puede hacer mucho más que código. Estos son casos reales documentados por OpenAI y su comunidad — con ejemplos de cómo pedirlos.

Administrar tu computadora y tus archivos

Codex puede ordenar el caos digital que todos acumulamos: carpetas de descargas con 400 archivos, proyectos regados en tres lugares, documentos con nombres como «final_v2_AHORA_SI.docx». Le pides que primero analice («dime qué hay en esta carpeta y propón una organización») y después que ejecute («aplícala, pero no muevas nada fuera de esta carpeta»).

Un truco de los usuarios avanzados: asociar cada proyecto o área de tu vida a una carpeta real — comunidad, administración, contenido, logística — y trabajar cada tema de Codex dentro de su carpeta. Así el contexto (documentos, notas, conversaciones) se vuelve persistente: retomas un tema meses después y todo sigue ahí.

Prompt de ejemplo: «Revisa mi carpeta de Descargas, agrupa por tipo y proyecto, proponme una estructura de carpetas y espera mi OK antes de mover nada.»

Correo y mensajes

Dos usos que ahorran horas a la semana: filtrar (encontrar los correos que realmente requieren tu atención entre el ruido) y redactar (respuestas formales para asuntos operativos, con tu tono). El truco para que suene a ti: dale dos o tres correos tuyos como ejemplo de voz. Y la regla de higiene que repiten todos los que lo usan en serio: Codex redacta, tú das el toque final y envías — borradores, no envíos directos.

Prompt de ejemplo: «De estos 30 correos, dime cuáles necesitan respuesta mía hoy. Para los 3 más urgentes, redacta borradores con el tono de los ejemplos que te di.»

Datos y hojas de cálculo

Probablemente el uso no-técnico con más retorno inmediato. Codex puede:

• Limpiar tablas desordenadas: quitar duplicados, estandarizar formatos de fecha y teléfono, separar los registros conflictivos en otra hoja — siempre sin tocar el archivo original.
• Responder preguntas directas sobre un CSV: «¿cuáles fueron los 10 productos más vendidos por margen?», «¿qué clientes no compran desde marzo?».
• Generar análisis con visualizaciones: de un archivo de exportación desordenado a un reporte con gráficas.
• Pronósticos financieros: identificar puntos de liquidez en hojas de trabajo editables que luego tú ajustas.

Prompt de ejemplo: «Toma ventas_2026.csv, límpialo (duplicados y formatos) en una copia, y dime los 5 hallazgos más importantes con una gráfica cada uno. No modifiques el original.»

Revisar contratos y documentos antes de firmar

Un uso administrativo que pocos conocen y muchos agradecen: darle un contrato y pedirle que analice las cláusulas, detecte lenguaje ambiguo, señale puntos potencialmente problemáticos y genere la lista de preguntas que deberías hacer antes de firmar. No sustituye a tu abogado — pero llegas a la revisión legal (o a la negociación) con los ojos abiertos y las preguntas correctas.

Prompt de ejemplo: «Lee este contrato de servicios. Resume mis obligaciones y las del proveedor, marca cláusulas ambiguas o riesgosas (penalizaciones, renovación automática, propiedad del trabajo) y dame las 5 preguntas que debería hacer antes de firmar.»

Redes sociales: el flujo completo

Conectado con una herramienta de publicación mediante skills o conectores (por ejemplo Postiz, que se integra con más de 30 plataformas), Codex puede llevar el ciclo entero de redes sociales desde la terminal:

1. Analizar: «Revisa las métricas del mes pasado y dime qué 5 posts funcionaron mejor y por qué.»
2. Planear: «Con eso, proponme el calendario de 2 semanas: temas, formato y día/hora por red.»
3. Ejecutar: «Redacta los posts del calendario con el tono de la marca y guárdalos como borradores para mi revisión.»
4. Publicar: «Los aprobados, prográmalos en X y LinkedIn. Y repite este flujo cada lunes como automatización.»

El paso 3 es la clave de seguridad: borradores para revisión, no publicación directa — al menos hasta que el flujo esté validado. Un agente publicando en las redes de la empresa sin revisión es el equivalente a subir código a producción sin pruebas.

Presentaciones, imágenes y video

Para contenido multimedia, Codex funciona como productor asistente: estructura la presentación diapositiva por diapositiva, escribe el prompt específico de cada imagen y las genera; y para video puede trabajar con herramientas locales como FFmpeg — cortar, convertir, detectar los mejores momentos de una grabación o procesar renders en lote. Cosas que antes requerían saber usar tres programas distintos, ahora se piden en una frase.

Prompt de ejemplo: «De esta grabación de 40 minutos, encuentra los 5 momentos más citables, córtalos en clips de menos de 60 segundos y deja los archivos en /clips con nombres descriptivos.»

Reportes y seguimiento del equipo

Codex puede volverse el asistente ejecutivo que prepara el contexto de tu día y de tu semana:

• Brief matutino: convierte tu calendario, mensajes y pendientes en una lista de prioridades del día: qué juntas necesitan preparación, qué mensajes merecen respuesta.
• Resumen semanal: revisa las juntas y documentos de la semana e identifica lo terminado, las decisiones tomadas y los bloqueos — listo para enviárselo a tu jefe con enlaces a las fuentes.
• Triaje de pendientes: convierte hilos largos de Slack en una cola de acciones ordenada por prioridad, con responsable sugerido.
• Memos de decisión: revisa archivos internos y restricciones de presupuesto, separa la evidencia interna de la investigación externa, y entrega recomendación con sus contras.

Documentos de trabajo

Procedimientos operativos (SOPs) a partir de cómo realmente se hace el trabajo, documentos de requisitos armados desde notas de reuniones y contexto de Slack, formularios y briefs de contenido. La ventaja sobre pedírselo a un chat: Codex lee los archivos reales del proyecto antes de escribir, así que el documento sale con el contexto correcto en lugar de generalidades. Un detalle que ayuda mucho en la práctica: puedes adjuntar capturas de pantalla anotadas para mostrarle exactamente qué parte de una interfaz o documento te interesa.

Onboarding y aprendizaje

Para integrar a alguien nuevo: preparar el rastreador de tareas de su primera semana, el resumen del equipo y los borradores de bienvenida. Para aprender tú: convertir documentación densa en reportes de aprendizaje claros, pedir explicaciones por niveles, o asignarle a Codex un objetivo de largo plazo que va avanzando entre sesiones. Y en lo personal, la comunidad lo usa para hobbies, finanzas personales y educación.

Lo que la comunidad realmente hace con él

En los foros de usuarios (r/codex) aparecen casos aún más creativos — y muy reveladores de hacia dónde va esto:

• Vigilancia competitiva automatizada: «dame un reporte mensual de las empresas de mi sector y cualquier noticia que mueva la aguja» — corriendo solo, cada mes.
• Beneficios de tarjeta que caducan: una automatización mensual que entra a la cuenta y revisa qué beneficios (que expiran cada mes o trimestre) aún no has usado. Dinero real recuperado.
• Salud personal: extraer las estadísticas de apps y wearables (Oura Ring, etc.), armar el gráfico semanal y evaluar la actividad de la semana.
• Planear un viaje complejo: itinerario con múltiples escalas trabajado en conversación → convertido en un mini-sitio web navegable → PDFs bonitos para los compañeros de viaje. Todo con el mismo agente.
• Impuestos y trámites: revisar formularios fiscales antes de presentarlos.
• Administrar servidores y homelab: gestionar todo un laboratorio casero (Home Assistant, media servers, bóvedas de Obsidian) sin abrir una terminal — Codex ejecuta, tú diriges. Varios lo conectan por SSH a sus servidores para mantenimiento.
• Monitoreo con acción: «vigila los logs de producción; cuando encuentres algo mal, mándame una notificación y abre un ticket».
• Prospección de clientes: combinado con el navegador y Google Workspace, buscar prospectos y comparar precios de mercado.
• Ciencia e ingeniería: desde derivaciones teóricas en LaTeX validadas contra simulaciones, hasta diseñar el circuito Y el código de un proyecto de electrónica en el mismo contexto.

El matiz honesto: dónde brilla y dónde no

Un consenso interesante de la comunidad: Codex es más fuerte en tareas iterativas y verificables — donde se puede comprobar si el resultado es correcto (datos, archivos, documentación de código existente, procesos con criterio de éxito claro). Para prosa larga y trabajo de conocimiento general (ensayos, notas creativas, lluvia de ideas), un chat conversacional normal sigue dando mejores resultados: Codex está optimizado para contexto de archivos y uso de herramientas, no para escribir bonito. La herramienta correcta para cada tarea — ese también es criterio.

Skills personalizados y automatizaciones recurrentes

Aquí es donde todo lo anterior se profesionaliza. Un skill es tu metodología condensada en instrucciones reutilizables: cómo redactas tus reportes, cómo revisas un contrato, cómo estructuras un post — lo escribes una vez y lo invocas cuando lo necesitas, con la garantía de que la lógica crítica se sigue exacta. Las automatizaciones combinan un prompt recurrente + skills + una cadencia (diaria, semanal, mensual): el brief de cada mañana, el resumen de cada viernes o el calendario de redes de cada lunes corren solos, y como Codex puede trabajar varias tareas en paralelo, lo pesado avanza en segundo plano mientras tú sigues en lo tuyo.

La constante de todos estos usos es la misma: si la tarea vive en archivos, datos o pasos repetibles, se puede delegar — y la fórmula de 4 partes aplica igual que en el código.

Lecturas recomendadas sobre estos usos: los casos de uso oficiales de Codex y la excelente guía en español «Codex como herramienta de trabajo» de Rodrigo Olivares, y los hilos de la comunidad en r/codex sobre usos fuera del desarrollo y usos no relacionados con programación.

Seguridad y criterio: las dos reglas que no se negocian

1) Permisos limitados primero. Codex puede ejecutar comandos y editar archivos, así que conviene empezar con permisos restringidos y ampliarlos solo cuando confías en el proyecto y en la tarea.

2) Revisa antes de aceptar. Codex ayuda muchísimo, pero no reemplaza el criterio del desarrollador. Lo ideal es usarlo como compañero: que proponga, implemente, pruebe y explique — pero que tú revises. Un cambio que no entiendes es un cambio que no se acepta.

Preguntas frecuentes

¿Necesito saber programar para usar Codex?

Para sacarle todo el jugo, sí ayuda. Pero muchas tareas — explicar un proyecto, convertir ideas en planes, crear checklists, preparar documentación — funcionan perfecto para perfiles no técnicos que trabajan cerca del código.

¿Codex reemplaza al desarrollador?

No: reemplaza las partes tediosas del trabajo (buscar, escribir boilerplate, correr pruebas, revisar lo obvio) y amplifica al desarrollador que sabe pedir bien y revisar con criterio. La decisión final siempre es humana.

¿Cuál es la mejor forma de aprender a usarlo?

Usarlo todos los días en tareas pequeñas — empezando por las de solo lectura — e ir subiendo la complejidad. La habilidad clave es la fórmula de 4 partes: objetivo, contexto, restricciones y «listo cuando».

¿Esto aplica también para otros agentes de IA?

Sí. La fórmula de 4 partes, el «plan primero», los permisos graduales y la revisión de cambios aplican a cualquier agente de programación. Son buenas prácticas de trabajar con agentes, no de una marca.

En Azterion usamos agentes de IA todos los días — para construir software, automatizar procesos con inteligencia artificial y hasta para atender clientes con chats de IA entrenados por negocio. Si quieres que tu empresa aproveche esta tecnología con estrategia y no por moda, nuestra consultoría tecnológica es el punto de partida.