🟢 Codex básico — De cero a avanzado

🟢 Qué es

O Codex es el agente de codificación de OpenAI, rival de Claude Code. Su diferencial: ejecuta agentes en la nube, delega tareas de forma remota (incluso desde el celular) y devuelve pull requests listos. Contexto de 274K tokens.

💡 Por qué aprender

Más contexto que Claude Code, soporte nativo para worktrees e integración directa con GitHub Actions. Para tareas largas en la nube, es un complemento natural de Claude.

🔑 Las 3 versiones

🟢 Qué es

Instalación mediante npm. Requisito previo: Node.js v18+. El inicio de sesión usa autenticación de dispositivo — abres un enlace en el browser, sin exponer una clave de API.

💡 Por qué aprender

Una versión desactualizada de Node.js causa fallas silenciosas. La autenticación del dispositivo es más segura que una API key: funciona en contenedores Docker sin variables de entorno expuestas.

🔑 Paso a paso

winget install --id Git.Git -e --source winget
# depois instale Node.js em nodejs.org

curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
sudo apt-get install -y nodejs

npm install -g @openai/codex

codex login --device-auth
# Abre link no browser → digita código → ✓ logado

🟢 Qué es

Después de instalar, codex abre el modo interactivo. / accede a comandos internos, @ hace referencia a archivos del proyecto.

💡 Por qué aprender

O agents.md es equivalente a CLAUDE.md: define el contexto permanente. Sin él, Codex empieza desde cero en cada sesión.

🔑 Conceptos clave

codex                    # modo interativo
codex "crie uma API"     # prompt direto
codex chat               # modo conversa
codex --full-auto "..."  # sem confirmação

🟢 Qué es

Las políticas de aprobación controlan cuándo Codex pide confirmación. Desde preguntar siempre hasta no preguntar nunca: ajústalas según el entorno (desarrollo local frente a producción).

💡 Por qué aprender

En un contenedor o una VM aislada, desactivar las confirmaciones elimina fricción y acelera mucho. En producción, mantén siempre activas las confirmaciones.

🔑 Flags principales

🟢 Qué es

Las Skills son instrucciones reutilizables para tareas recurrentes. Créala una vez y úsala con $nome-da-skill o deja que Codex lo invoque automáticamente.

💡 Por qué aprender

Eliminan la repetición. Una skill de "revisión de PR" puede ejecutar 3 subagentes en paralelo sin reescribir el prompt cada vez.

🔑 Estructura mínima

---
name: pr-review-agent
description: Use quando pedir revisão de PR, diff ou código alterado.
---
Ao revisar um PR:
1. Leia o diff completo
2. Identifique riscos de segurança
3. Verifique cobertura de testes
4. Classifique achados por severidade

🟢 Qué es

Codex tiene varios «nombres» para los agentes: hilo, agente de tareas, worker, subagente, agente en segundo plano, automatización, skill. Todos son variantes de cómo estructuras el trabajo.

💡 Por qué aprender

Entender la jerarquía evita confusiones. Empieza con threads + skills + automatizaciones. Los subagentes y workers llegan cuando se necesita paralelismo real.

🔑 Tabla de los 10 tipos

🟢 Qué es

Subagentes especializados activados en paralelo. Codex no los crea automáticamente — lo pides explícitamente con «usa subagentes en paralelo».

💡 Por qué aprender

Las auditorías, la planificación de funciones y la refactorización, divididas en paralelo, reducen drásticamente el tiempo total.

🔑 Fórmula del prompt

Use subagentes em paralelo para [objetivo].
Divida:
1. Subagente A: [papel específico]
2. Subagente B: [papel específico]
3. Subagente C: [papel específico]
Regras: trabalho independente, não edite ainda, consolide no final.

🟢 Qué es

Los worktrees permiten que varios agentes trabajen en paralelo sin mezclar cambios. Cada agente tiene su propio directorio y branch. OpenAI destaca los worktrees como parte central del flujo multiagente.

💡 Por qué aprender

Sin worktrees, dos agentes que editan el mismo archivo crean conflictos. Con worktrees, cada uno trabaja de forma aislada y luego haces merge.

🔑 Capacidades de Git/GitHub

🟢 Qué es

Las automatizaciones configuran rutinas que Codex ejecuta en horarios definidos sin que tengas que estar presente. Disponible en la pestaña Automatizaciones de Codex App (Windows).

💡 Por qué aprender

Convierte a Codex en un miembro del equipo que trabaja mientras duermes: revisa código, ejecuta pruebas y genera informes.

🔑 Ejemplo: revisión semanal

Toda segunda-feira às 9h:
1. Atualizar dependências (se seguro)
2. Rodar testes
3. Rodar build
4. Gerar reports/weekly-review.md
5. Se houver mudanças, criar commit

🟢 Qué es

Construcción de un app de portafolio de acciones completo — con UI, base de datos, datos reales del mercado y material de marketing — usando Codex 5.5, sin experiencia previa en programación.

💡 Por qué aprender

Muestra Codex al límite: multitarea real con 3 agentes simultáneos (desarrollo + video + investigación), generación de imágenes y reverse prompting.

🔑 Flujo del proyecto