Codex de Cero a Cien
La Guía Completa de Codex — De Principiante a Experto
Version 1.1
por Enrique Rocha · @soyenriquerocha
Codex de Cero a Cien — Junio 2026
La guía más completa en español sobre Codex de OpenAI. 500+ páginas. 25 capítulos. 5 apéndices de referencia. Todo lo que necesitas para dominar Codex: desktop, móvil, web, Cloud, IDE y CLI — del primer prompt al refactor enterprise.
Codex es la app de coding de OpenAI que vive en tu Mac, tu teléfono, tu navegador y la nube — y la mayoría de devs apenas lo usa como un chatbot mejorado.
Esta guía te lleva del "acabo de instalarlo" al "delego un refactor de mil archivos a Codex Cloud mientras duermo". Paso a paso. Sin jerga. Con ejemplos que puedes probar mientras lees.
No importa si nunca delegaste código a un agente. No importa si vienes de Copilot, Cursor o Claude Code. Cada concepto está explicado con analogías simples y comparaciones lado a lado.
Codex se mueve rápido — nuevos modelos, nuevas integraciones, cambios en la app cada mes. Te mantenemos al día con cada edición.
Acceso a nuestro newsletter exclusivo con actualizaciones de Codex, OpenAI y agentes de IA en general.
Lo que vas a aprender
- 500+ páginas de contenido práctico en español
- 25 capítulos que cubren TODO el ecosistema Codex
- 5 apéndices de referencia rápida (flags, settings, variables de entorno, glosario, changelog)
- Ejemplos de código listos para copiar y usar
- Tips, advertencias y notas en cada capítulo
- Glosario con 120+ términos explicados en lenguaje simple
- Acceso a actualizaciones de Codex e IA a través de nuestra newsletter exclusiva
- PDF protegido, listo para leer en cualquier dispositivo
Para quién es esta guía
Contenido completo
Mundo Codex (Capítulos 1–4)
- 1.Qué es Codex — El agente de coding de OpenAI (no el modelo de 2021): las 6 superficies (desktop, móvil, web, Cloud, IDE, CLI), por qué se le dice agente y no asistente, diferencias con asistentes tradicionales.
- 2.Codex vs Claude Code — Comparación completa: superficies, modelos, modos de aprobación, integraciones, precios y casos de uso. Cuándo conviene uno u otro, sin marketing.
- 3.Los Modelos de Codex — Modelos disponibles en mayo 2026, capacidades, velocidad, costo, límites de contexto, cuándo cambiar entre ellos en plena tarea.
- 4.Instalar Codex: Desktop, Móvil, Web y Terminal — Instalación paso a paso en las 6 superficies: macOS y Windows, iOS y Android, chatgpt.com/codex, VS Code, JetBrains y CLI. Troubleshooting incluido.
Codex Desktop (Capítulos 5–7)
- 5.Codex en la App de ChatGPT (macOS y Windows) — Task pane, hot corner, screenshot tool, multi-ventana, integración con Spotlight y drag-drop, atajos, concurrencia, resume de sesiones, sync con web y móvil.
- 6.Codex en VS Code, Cursor y JetBrains — Extensiones de IDE: instalación, auth, panel, sugerencias inline vs chat, diffs multi-archivo, atajos, coexistencia con Cursor AI y Copilot, configuración por IDE.
- 7.Workflows y Atajos en Escritorio — Setup de workspace, atajos para refactor/test/explicar/arreglar, hot corners, integración con Raycast y Alfred, multi-monitor, ejemplos reales de desarrollo.
Codex Móvil (Capítulos 8–10)
- 8.Codex en iOS y Android — App móvil: lanzar tasks, ver progreso, push notifications, diff viewer, aprobar PRs, adjuntos, dictado de voz, modo offline, diferencias entre iOS y Android.
- 9.Coding On-The-Go: Workflows Reales — Escenarios móviles: revisar bugs camino al trabajo, aprobar PRs en el commute, delegar a Cloud antes de dormir, debug de producción desde el café. Cuándo NO codear en móvil.
- 10.Voice, Screenshots y Push Notifications — Dictado de voz para describir tasks, screenshot capture con AI que lee imágenes, notifications inteligentes, Siri y Google Assistant, widgets y lock screen actions, permisos y privacidad.
Codex Web y Cloud (Capítulos 11–14)
- 11.Codex Web: chatgpt.com/codex — Dashboard de tasks, repos conectados, nueva task, selección de branch, progreso en vivo, diff viewer side-by-side, comentarios inline, pause/resume, historial.
- 12.Codex Cloud: Delegación de Tareas Largas — Qué es Cloud y cuándo delegar vs local, tasks ideales (refactors grandes, migraciones, batch jobs), límites, logs en vivo, concurrencia, automatización de branches y PRs.
- 13.Integración GitHub y PRs Automáticos — Auth con GitHub para repos públicos/privados y orgs, Codex como reviewer, comentarios inline en PRs, sync con issues, GitHub Actions, mejores prácticas de seguridad.
- 14.Environments, Secrets y Networking — Configuración de tasks en Cloud: setup.sh, env vars por proyecto, manejo de secrets, acceso a red on/off, sandbox vs open, caching, no commitear secrets nunca.
Flujos de Trabajo Reales (Capítulos 15–19)
- 15.Flujo TDD con Codex — TDD automatizado: Codex escribe el test primero, luego el código, luego el refactor. Ejemplo end-to-end, trampas comunes (tests malos, código pasa pero está mal, mock excesivo).
- 16.Flujo de Refactoring Grande — Refactors a escala: planeación con Codex, delegación a Cloud para no bloquear la laptop, revisión incremental de diffs, ejemplos (Express→Fastify, class→Hooks), cómo evitar refactors descontrolados.
- 17.Flujo de Code Review — Codex como reviewer automático en PRs: setup, criterios (estilo, bugs, seguridad, perf), cuándo override, review humano + Codex en paralelo, comparación con CodeRabbit, plantillas.
- 18.Flujo de Bug Fixing con Repros — Pipeline de bugs: reporte con screenshot/log → Codex genera repro test fallido → arregla el bug → test pasa → PR. Cuándo Codex falla (race conditions, memory leaks) y cuándo debug humano es esencial.
- 19.Multi-Modelo: Cuándo Cambiar Entre Modelos — Selección de modelo por tarea: reasoner caro para arquitectura compleja, modelo rápido para trabajo repetitivo, balanceado para uso diario. Costo vs velocidad vs calidad.
Avanzado (Capítulos 20–25)
- 20.AGENTS.md y Memoria del Proyecto — AGENTS.md a fondo: ubicaciones (global ~/.codex/, proyecto, subdirs), sintaxis, mejores prácticas, herencia, cómo Codex aplica las instrucciones, paridad con CLAUDE.md.
- 21.Conexiones e Integraciones — GitHub, Slack notifications y slash commands, Linear y Jira, Vercel y Netlify, webhooks, OAuth, tools custom, MCP servers. Paso a paso por integración con ejemplos reales.
- 22.Codex SDK: Automatizar Codex Programáticamente — Paquetes npm y pip, auth, API de tasks, polling de status, webhooks, ejemplos (refactor nocturno, Slack bot, CI auto-review), rate limits y costos vs API directa de OpenAI.
- 23.Codex CLI: Resumen Práctico — Cuándo CLI > app, instalación, comandos más usados (codex, codex exec, codex apply, codex status), workflow CLI + app, modos de aprobación. Referencia completa en apéndice A.
- 24.Equipos, Enterprise y Seguridad — ChatGPT Team vs Enterprise, admin console, SSO/SAML, control de acceso a repos, audit logs, data residency, compliance (SOC2, HIPAA), retention, opt-out de training, IP del código generado.
- 25.Troubleshooting y Mejores Prácticas — Errores comunes y soluciones (app no abre, login falla, Cloud no inicia, GitHub no conecta, modelo lento, costos descontrolados), rate limiting, optimización, antipatrones, recursos de soporte.
Apéndices de Referencia Rápida
- A.Referencia completa de Flags CLI
- B.Referencia completa de Settings
- C.Referencia completa de Variables de Entorno
- D.Glosario — 120+ términos técnicos en lenguaje simple
- E.Changelog — Novedades de cada edición