Codex Básico

🟢 Qué es

Codex pide confirmación para cada acción de forma predeterminada. Las approval policies controlan cuándo y si pide aprobación: desde preguntar siempre hasta no preguntar nunca.

💡 Por qué aprender

Si estás en un entorno seguro (contenedor, VM aislada), desactivar las confirmaciones elimina fricción y acelera mucho el ciclo. Para producción o sistemas críticos, mantén las confirmaciones.

🔑 Flags de aprobación

# ~/.codex/config.toml

# Configuração equilibrada (recomendada em containers)
approval_policy = "never"
sandbox_mode = "workspace-write"

# Configuração mais agressiva (só em ambientes isolados)
# approval_policy = "never"
# sandbox_mode = "danger-full-access"

🟢 Qué es

Las Skills son instrucciones reutilizables para tareas recurrentes. La creas una vez y Codex la invoca automáticamente cuando la tarea coincide con la descripción, o la llamas explícitamente con $nome-da-skill.

💡 Por qué aprender

Las Skills eliminan la repetición. Una skill de «revisión de PR» puede ejecutar 3 subagentes en paralelo (seguridad, pruebas, arquitectura) sin que tengas que volver a escribir el prompt cada vez.

🔑 Estructura de una skill

meu-projeto/
  .agents/
    skills/
      pr-review-agent/
        SKILL.md          ← obrigatório
        scripts/          ← opcional
        references/       ← opcional

---
name: pr-review-agent
description: Use esta skill quando o usuário pedir revisão de pull
  request, branch, diff ou código alterado. Revise segurança,
  testes, arquitetura e riscos.
---

Ao revisar um PR:
1. Leia o diff completo
2. Identifique arquivos alterados
3. Procure riscos de segurança
4. Verifique cobertura de testes
5. Avalie arquitetura e manutenção
6. Classifique achados por severidade
7. Sugira ações concretas
8. Finalize com checklist

# Invocação explícita
$pr-review-agent

# Invocação natural (Codex detecta automaticamente)
"Revise o PR #42 e encontre problemas de segurança"

# Combinando com subagentes
"Use a skill $pr-review-agent com 3 subagentes em paralelo:
segurança, testes, arquitetura"

🟢 Qué es

Codex tiene varios «nombres» para los agentes, pero en la práctica los creas de 3 formas: hilo/tarea normal, subagentes configurados y automatizaciones programadas.

💡 Por qué aprender

Entender la jerarquía evita confusiones con la terminología. Empieza con threads + skills + automatizaciones. Los subagentes y workers vienen después.

🔑 Tabla de los 10 tipos

🟢 Qué es

Los subagentes son agentes especializados activados en paralelo. Codex no los crea automáticamente — tienes que pedirlo explícitamente en el prompt con «usa subagentes en paralelo».

💡 Por qué aprender

Las tareas complejas, como auditar un codebase, planificar funciones y hacer refactoring, pueden dividirse y ejecutarse en paralelo, lo que reduce drásticamente el tiempo total.

🔑 Fórmula del prompt para subagentes

Use subagentes em paralelo para [objetivo].

Divida o trabalho assim:
1. Subagente A: [papel específico]
2. Subagente B: [papel específico]
3. Subagente C: [papel específico]

Regras:
- Cada subagente trabalha de forma independente
- Não edite arquivos ainda, apenas analise e planeje
- Espere todos terminarem
- Consolide os resultados
- Remova duplicações
- Priorize por impacto

Formato final:
1. Resumo
2. Achados por agente
3. Plano consolidado
4. Riscos
5. Próximas ações

Usa la skill $pr-review-agent con subagentes en paralelo.

Crea:
- 1 subagente enfocado en seguridad
- 1 subagente enfocado en pruebas
- 1 subagente enfocado en arquitectura
- 1 subagente enfocado en rendimiento

Cada uno aplica el proceso de la skill a su enfoque.
Después, consolida los resultados sin duplicaciones.

🟢 Qué es

Los worktrees permiten que varios agentes trabajen en paralelo sin mezclar cambios en la misma branch o directorio. OpenAI destaca los worktrees como parte central del flujo multiagente de Codex.

💡 Por qué aprender

Sin worktrees, dos agentes que editan el mismo archivo crean conflictos. Con worktrees, cada agente trabaja en su propio directorio + branch y luego haces merge.

🔑 Capacidades de Git/GitHub de Codex

🟢 Qué es

Las automatizaciones permiten configurar rutinas que Codex ejecuta con un horario o una frecuencia definidos, sin que tengas que estar presente. Disponible en la pestaña Automatizaciones de Codex App (Windows).

💡 Por qué aprender

Las automatizaciones convierten a Codex en un miembro del equipo que trabaja mientras duermes: revisa código, ejecuta pruebas, genera informes y crea commits.

🔑 Ejemplo: revisión semanal automática

Todos los lunes a las 9 h:

1. Actualizar dependencias si es seguro
2. Ejecutar pruebas
3. Ejecutar el build
4. Revisar errores recientes
5. Generar un informe en reports/weekly-review.md
6. Si hay cambios, crear un commit con un mensaje claro

Usa un thread nuevo en cada ejecución.
Usa razonamiento medio.
No hagas deploy sin mi aprobación.

🟢 Qué es

Ejemplo real documentado en la comunidad: construcción de un app de portafolio de acciones completo usando Codex 5.5 — con interfaz, base de datos, datos reales del mercado y material de marketing — 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 para elegir la interfaz, pruebas automáticas y reverse prompting.

🔑 Flujo del proyecto