Cómo dominar Codex en 2026 (Curso para desarrolladores)

Usé Claude Code durante 12 meses. Luego cambié a Codex por 30 días.

Esto es lo que encontré

Lo que realmente es Codex en 2026

La mayoría todavía piensa que Codex es un autocompletado más inteligente. No lo es.

• Codex es una plataforma completa de desarrollo de software con agentes. Lee tu base de código, escribe y prueba código, revisa pull requests, controla tu escritorio Mac, navega por la web, genera imágenes, programa tareas recurrentes y recuerda tus preferencias entre sesiones.
• El cambio mental que esto requiere es significativo. Dejas de ser la persona que escribe código. Te conviertes en la persona que revisa el código escrito por un equipo de ingenieros júnior que nunca duerme.

La mayoría de los desarrolladores instalan Codex, envían indicaciones de una línea durante dos semanas, obtienen resultados mediocres y se rinden. Nunca configuran AGENTS.md.

Nunca escriben un Skill. Nunca usan sub-agentes. Usan el 5% de la superficie y juzgan la herramienta por ese 5%.

Este curso cubre el otro 95%.

Las cinco superficies

Antes de instalar nada, entiende dónde vive Codex. La superficie que elijas determina qué tan de cerca sigues su trabajo y dónde se ejecuta el código.

CLI es para flujos de trabajo con scripts, tareas únicas y automatización sin cabeza. Tu código nunca sale de tu máquina a menos que lo subas. Código abierto, construido en Rust, funciona en macOS, Windows y Linux.

La extensión IDE es para edición interactiva con contexto preciso de archivos. Se instala en VS Code, Cursor, Windsurf o JetBrains. Usa tu autenticación de CLI sin inicio de sesión independiente.

La aplicación de escritorio es el hogar de flujos de trabajo con múltiples hilos, el navegador integrado, Computer Use, modo Goal, Appshots y Automations. Se lanzó en macOS en febrero de 2026 y en Windows el 4 de marzo de 2026.

Cloud es para tareas asíncronas en segundo plano, PRs en paralelo y trabajo mientras duermes. Las tareas se ejecutan en contenedores con espacio aislado precargados con tu repositorio de GitHub. Nada bloquea tu máquina local.

El navegador integrado y Computer Use son para verificación de UI, iteración de frontend y pruebas de extremo a extremo. Codex abre tu servidor de desarrollo local, interactúa con él, captura la pantalla del resultado y verifica que los cambios de código produjeron la salida visual correcta.

Un flujo de trabajo real usa múltiples superficies:

• CLI para tareas con scripts
• IDE para trabajo interactivo de funcionalidades
• Cloud para tareas paralelas que no necesitas supervisar
• App para tareas impulsadas por objetivos y de larga duración

El factor principal para elegir una superficie es qué tan de cerca quieres seguir el trabajo del agente. Si quieres monitorear los cambios a medida que se realizan, la CLI o el IDE mantienen el trabajo en tu máquina y frente a ti. Si prefieres delegar una sesión más larga y revisar al final, Cloud es la opción correcta.

El modelo mental: agente, no autocompletado

Con las superficies claras, el siguiente cambio es entender la unidad de trabajo.

La unidad de trabajo es una tarea, no un turno. La salida es un PR, no una respuesta de chat.

Piensa menos "escribe una función que haga X" y más "implementa la funcionalidad Y, aquí están las restricciones, ejecuta las pruebas cuando termines".

Cada tarea de Codex sigue el mismo bucle interno. Codex lee tu tarea y contexto, produce un plan interno, ejecuta paso a paso y verifica su propio trabajo.

Deja de pensar en Codex como un asistente de codificación. Empieza a pensar en él como un equipo de ingenieros júnior a los que instruyes por la mañana y revisas por la tarde.

Un ejemplo real de esto en práctica: los desarrolladores en WorkOS ahora encolan de cuatro a cinco tareas de Codex antes de tomar su café matutino. Para cuando vuelven a sentarse, dos o tres PRs completados están esperando revisión, manejando el trabajo de mantenimiento que solía consumir del 30 al 40 por ciento de su día.

Los modelos actuales a partir de mayo de 2026:

• GPT-5.5 (predeterminado) — maneja la mayoría de las tareas, misma latencia que antes pero significativamente menos tokens para el mismo trabajo
• GPT-5.3-Codex — diseñado específicamente para ejecuciones autónomas largas, grandes refactorizaciones y distribución paralela en la nube; 25% más rápido que el especialista anterior de Codex
• GPT-5.5 Pro — el más alto razonamiento; solo para planes Pro, Business y Enterprise
• Codex Mini — permanentemente gratuito en ChatGPT Free; adecuado para aprender

Deja Codex en GPT-5.5 por defecto. Cambia a GPT-5.3-Codex para tareas agentivas grandes donde Codex se ejecuta de forma autónoma durante mucho tiempo.

Primeros pasos: tu primera sesión real

El camino más rápido hacia una sesión funcional de Codex sigue cinco pasos. Olvida el tutorial de fizzbuzz. Empieza en una base de código real.

Paso 1: Instala el CLI.

Paso 2: Abre un proyecto real.

Navega a un repositorio de bajo riesgo que ya conozcas. Esto importa.

Codex rinde mejor cuando puedes reconocer la salida y detectar errores. Trabajar en una base de código desconocida en la primera sesión produce resultados impredecibles.

Inicia sesión con tu cuenta de ChatGPT cuando se te solicite. Tu navegador se abre automáticamente. Haz clic en Continue y regresa a la terminal.

Paso 3: Ejecuta /init antes de hacer cualquier otra cosa.

Este comando es lo que la mayoría de los tutoriales omiten. Codex escanea tu directorio e historial de Git, identifica lenguajes, frameworks, comandos de compilación y comandos de prueba, y crea un archivo AGENTS.md poblado con lo que encuentra.

Revisa el archivo generado, ajusta cualquier cosa incorrecta y haz commit. Cada sesión futura de Codex en este proyecto lo leerá automáticamente.

Paso 4: Dale a Codex una tarea de orientación.

Pídele que explique la base de código antes de darle algo que cambiar. Esto construye tu confianza en el contexto que ha cargado:

codex exec "Explica la estructura de este proyecto, los directorios principales y las convenciones de nomenclatura. No sugieras cambios."

Lee la salida. Si describe tu base de código real con precisión, tiene el contexto que necesita. Si es vaga o incorrecta, tu AGENTS.md necesita más detalle.

Paso 5: Dale una tarea pequeña y real. Elige algo concreto y acotado.

codex exec "En el archivo src/auth/login.ts, busca la función validateSession. Añade una comprobación para que expire después de 24 horas. Ejecuta las pruebas después del cambio."

Esta es la forma correcta de una indicación para Codex: contexto de archivo específico, resultado esperado, restricciones y un paso de verificación definido. Revisa el diff que devuelve. Ahora estás usando Codex correctamente.

Paso 6: Instala la aplicación de escritorio. Descárgala desde el sitio web de OpenAI. Inicia sesión con la misma cuenta de ChatGPT.

Paso 7: Instala la extensión del IDE. Busca "OpenAI Codex" en el panel de extensiones de tu editor. Lee tu autenticación de CLI automáticamente.

Paso 8: Conecta GitHub. Ve a Configuración dentro de la aplicación de Codex y conecta tu cuenta de GitHub. Vincula al menos un repositorio antes de usar tareas en la nube.

Dónde están las cosas:

• ~/.codex/config.toml: configuración principal: modo de aprobación, modo de espacio aislado, servidores MCP, modelos predeterminados
• ~/.codex/AGENTS.md: AGENTS.md personal, se aplica a todos los proyectos
• <proyecto>/AGENTS.md: instrucciones a nivel de proyecto
• <proyecto>/.agents/skills/: Skills a nivel de proyecto
• <proyecto>/.codex/config.toml: configuración a nivel de proyecto (solo proyectos de confianza)

AGENTS.md: el archivo más importante de tu repositorio

Ahora que tienes una sesión funcionando, el siguiente paso es hacer que cada sesión futura comience con la misma calidad. Eso es lo que hace AGENTS.md.

1. AGENTS.md es el único archivo que separa la salida mediocre de Codex de una salida consistente y de alta calidad.
2. Es un archivo Markdown simple en la raíz de tu repositorio. Cada vez que una sesión de Codex comienza en tu proyecto, el agente lo lee automáticamente antes de hacer cualquier otra cosa.
3. Es un estándar abierto. Codex, Cursor, Gemini CLI, Windsurf y GitHub Copilot lo leen. Escríbelo una vez y cada agente en tu cadena de herramientas lee la misma fuente de verdad.

Orden de resolución: Codex lee ~/.codex/AGENTS.md (nivel de inicio, todos los proyectos) más <proyecto>/AGENTS.md (nivel de proyecto). Los archivos AGENTS.override.md tienen prioridad en cada nivel. El límite combinado es de 32 KiB.

Qué incluir:

• Stack, frameworks, versiones de lenguaje, gestor de paquetes
• Comandos exactos de compilación, prueba y desarrollo; copiables, no "ejecuta las pruebas habituales"
• Convenciones de estructura de archivos y reglas de nomenclatura
• Reglas de estilo y patrones
• Zonas prohibidas: qué no tocar
• Requisitos de envío: CI, convenciones de PR, mecanismo de despliegue

Qué no incluir:

• Secretos o credenciales (el archivo está en control de versiones)
• Directrices vagas ("escribe código limpio" no significa nada para un agente)
• Documentación que duplique tu README

Mantenlo por debajo de 500 palabras. El exceso empuja el contexto útil fuera de la memoria de trabajo del modelo.

Una plantilla funcional:

Revisión:

• Verifica que Codex lo esté leyendo: codex exec "Resume las instrucciones actuales que tienes cargadas"
• Para monorepos grandes, coloca archivos AGENTS.md adicionales dentro de subdirectorios.
• Un archivo en packages/api/AGENTS.md tiene prioridad sobre el archivo raíz para tareas dentro de ese paquete.
• Ejecuta codex trust . para habilitar un .codex/config.toml a nivel de proyecto. Esto evita que un repositorio clonado malicioso configure Codex a tus espaldas.

El CLI en profundidad

Con AGENTS.md configurado, lo siguiente que debes dominar es el propio CLI. La mayoría de los usuarios solo escriben codex y se pierden los comandos que lo hacen realmente poderoso.

Hay cuatro comandos que cubren el 95% del uso diario real.

codex abre el modo interactivo para exploración, iteración y conversación de ida y vuelta con tu base de código.

codex exec "<tarea>" ejecuta Codex de forma no interactiva. Transmite a stdout y termina cuando termina. Esta es la herramienta potente para cualquier cosa que se pueda automatizar con scripts:

1# Ejemplo: pedir a Codex que revise una rama antes del push
2codex exec "Revisa los cambios en esta rama. ¿Hay algún problema de seguridad o regresión? Solo informa, no modifiques nada."

Conecta exec en ganchos de git, pipelines de CI y cron jobs. Es el bloque de construcción para todo lo automatizado.

codex resume --last retoma exactamente donde lo dejaste. Cada sesión se almacena:

1codex resume --last
2# Retoma la sesión anterior sin perder contexto

codex cloud gestiona tareas asíncronas en la nube, cubierto en la sección Cloud más abajo.

Banderas útiles:

• --json: flujo de eventos JSONL para canalizar a otras herramientas
• --model <nombre>: selecciona GPT-5.5 o GPT-5.3-Codex
• --reasoning <nivel>: bajo, medio o alto
• --search: permite búsqueda web durante la tarea
• -C <dir>: ejecuta en un directorio de trabajo diferente
• --sandbox <modo>: anula el modo de espacio aislado para esta sesión
• --approval <política>: anula la política de aprobación para esta sesión

Espacio aislado y aprobaciones

El CLI te da poder. El espacio aislado controla cuánto de ese poder puede ejercer Codex sin preguntar. Configurarlo correctamente mantiene tu flujo de trabajo rápido sin crear riesgos.

El espacio aislado es el límite que controla lo que Codex puede y no puede hacer. Configurarlo correctamente evita sorpresas.

Los tres modos de espacio aislado:

1. workspace-write (predeterminado): lectura y escritura dentro del espacio de trabajo, comandos rutinarios, sin red a menos que esté permitido. Úsalo casi siempre.
2. read-only: solo lectura, sin escrituras, sin shell. Úsalo para revisión de código y exploración.
3. danger-full-access: sin restricciones. Úsalo casi nunca. Resérvalo para automatizaciones probadas y verificadas.

Las dos políticas de aprobación:

• untrusted: pregunta antes de cada comando no confiable. Úsalo cuando estés aprendiendo o en un proyecto desconocido.
• on-request (predeterminado): aprueba automáticamente comandos rutinarios dentro del espacio aislado, pregunta antes de cualquier cosa que rompa el límite del espacio aislado.

auto_review es un sub-agente revisor que aprueba o rechaza automáticamente según tu AGENTS.md.

Actívalo con approvals_reviewer = "auto_review" en la configuración. Funciona bien para tareas asíncronas largas y modo Goal donde no quieres supervisar cada paso.

Añade comandos que constantemente te piden aprobación. Nunca añadas nada destructivo.

Cómo hacer indicaciones efectivas a Codex

Espacio aislado configurado, sesiones funcionando. La siguiente palanca es la calidad de las indicaciones, que tiene más impacto en la salida que cualquier otra variable.

La palanca más grande en la calidad de la salida de Codex es la estructura de la indicación. Las indicaciones vagas producen código vago.

El marco: Di, Muestra, Describe, Recuerda.

• Dile el resultado que quieres, no el método
• Muéstrale ejemplos de entrada y salidas esperadas
• Descríbele las APIs, bibliotecas y patrones a usar
• Recuérdale las convenciones de AGENTS.md

No siempre se necesitan los cuatro. Una pequeña corrección de errores puede necesitar solo "Di" y "Recuerda". Una nueva funcionalidad generalmente quiere los cuatro.

1. La regla de un solo cambio: Codex rinde dramáticamente mejor en una cosa que en cinco. "Corrige el error de autenticación, añade pruebas, refactoriza el repositorio de usuario y actualiza el README" es una moneda al aire. El mismo trabajo dividido en cuatro indicaciones es confiable.
2. Exige un plan primero para cualquier cosa no trivial: "produce un plan primero, no escribas código hasta que lo apruebe." Treinta segundos revisando un plan superan treinta minutos depurando una implementación incorrecta.
3. Especifica el comportamiento en caso de fallo explícitamente. Si se deja solo, Codex hará que las pruebas pasen por cualquier medio necesario:

``sh
codex exec "Corrige el error en src/api/handler.ts. Define el fallo como: si no se puede conectar a la base de datos, devuelve un 503. No fuerces las pruebas a pasar cambiando las aserciones."
``

Restringe el contexto explícitamente. Nombra archivos específicos para leer. "No leas ni modifiques nada más. Si necesitas información de otro lugar, pregúntame."

Niveles de esfuerzo de razonamiento:

• Bajo: ediciones triviales, formato, refactorizaciones simples
• Medio (predeterminado): la mayoría del trabajo de funcionalidades y corrección de errores
• Alto: decisiones de arquitectura, depuración difícil, grandes refactorizaciones multiarchivo

Modo Goal

Una vez que las indicaciones de una sola tarea se sienten naturales, el siguiente nivel es darle a Codex un objetivo de varios días y dejar que secuencie el trabajo por sí mismo.

El modo Goal es para trabajo demasiado grande para instruirlo tarea por tarea, pero lo suficientemente coherente para un solo objetivo. Se volvió estable en mayo de 2026.

Gestiona un Goal en ejecución con estos comandos:

1. codex goal status: ve los Goals activos y su progreso
2. codex goal logs <id>: inspecciona lo que Codex ha hecho hasta ahora
3. codex goal pause <id>: detén la ejecución y espera tu entrada
4. codex goal resume <id>: continúa desde donde se pausó
5. codex goal cancel <id>: detén y descarta el Goal

Comienza con Goals acotados. "Como máximo 5 PRs" hasta que confíes en cómo Codex interpreta tus objetivos. Un Goal descontrolado haciendo con confianza lo incorrecto es el peor resultado posible.

Siempre acota con: máximo de PRs, máximo de líneas de código por PR, puertas de CI entre PRs y condiciones de parada claras. Pausa en cualquier decisión arquitectónica no cubierta en AGENTS.md. Pausa en cualquier cambio de API que rompa la compatibilidad.

Skills: flujos de trabajo reutilizables

El modo Goal maneja iniciativas grandes. Los Skills manejan los microflujos de trabajo recurrentes que aparecen en cada proyecto. Si te encuentras repitiendo las mismas instrucciones entre sesiones, esa es tu señal para escribir un Skill.

Un Skill es un flujo de trabajo reutilizable empaquetado como un directorio: instrucciones en un archivo SKILL.md, más recursos y scripts opcionales.

Codex descubre los Skills por nombre y descripción. Carga las instrucciones completas solo cuando una tarea activa el Skill. Puedes tener 50 Skills con costo de contexto cero hasta que se active uno.

Dónde viven los Skills:

• Personal: $HOME/.agents/skills/: transversal a proyectos, refleja cómo trabajas independientemente del repositorio
• Equipo: .agents/skills/ dentro del repositorio: específico del proyecto, controlado por versiones, compartido con colaboradores

El formato SKILL.md:

1## open-pr
2
3**Descripción**: Flujo de trabajo estándar de PR: verifica la rama, sube, crea el PR con un cuerpo estructurado, aplica etiquetas y solicita revisión.
4
5**Activación**: Se activa automáticamente cuando una tarea implica crear una solicitud de incorporación de cambios.
6
7**Instrucciones**:
81. Verifica la rama en la que estás. Si no es una rama de características, crea una.
92. Sube la rama actual al remoto.
103. Crea el PR usando la plantilla del proyecto.
114. Aplica las etiquetas adecuadas (por ejemplo, "feature", "bugfix").
125. Solicita revisión a los miembros del equipo según CODEOWNERS.

Los tres Skills que todo usuario avanzado debería escribir primero:

1. open-pr: es el flujo de trabajo estándar de PR: verifica la rama, sube, crea el PR con un cuerpo estructurado, aplica etiquetas y solicita revisión. El Skill más usado en el trabajo diario.
2. new-feature: lee el PRD y AGENTS.md, identifica componentes existentes para reutilizar, genera un plan, espera aprobación, implementa, prueba y abre un PR a través del Skill open-pr. Si algo en el PRD es ambiguo, pregunta antes de generar código.
3. investigate: es el Skill de diagnosticar sin corregir. Confirma la reproducción, lee las rutas de código relevantes, forma una hipótesis ("Creo que X ocurre porque Y") y genera la hipótesis y el plan de validación en Markdown. No implementa una corrección. La salida es comprensión, no código.

El Skill investigate importa porque Codex omitirá el análisis de causa raíz cada vez que se lo permitas. Saltará directamente a una corrección, y esa corrección a menudo será incorrecta. Exigir investigar primero es la mejora más grande en la calidad de la salida de depuración.

Verifica que tus Skills estén cargados: codex exec "Lista los skills disponibles"

Sub-agentes y paralelismo

Los Skills manejan tus flujos de trabajo repetitivos. Los sub-agentes manejan los paralelos. La distinción importa porque el paralelismo mal hecho crea más problemas de los que resuelve.

Un sub-agente es una instancia de agente separada y aislada. Se ejecuta en su propio contexto, devuelve un resumen y su contexto se descarta. Es diferente de un Skill, que se ejecuta en el contexto del agente principal.

Tres patrones donde los sub-agentes son la herramienta correcta:

1. Exploración: genera un sub-agente para leer 30 archivos y resumir; la lectura ocurre en su contexto, no en el tuyo
2. Implementación paralela: cinco funcionalidades independientes como cinco sub-agentes concurrentes, cada uno con su propio contexto y plan
3. Verificación: un sub-agente revisor nuevo no está sesgado por haber escrito el código recién

Los sub-agentes personalizados se definen en .codex/agents/<nombre>.md:

1# revisor
2
3Eres un revisor de código meticuloso. Lee el diff y verifica:
4- Corrección funcional
5- Seguridad (inyección, exposición de datos)
6- Rendimiento (bucles innecesarios, consultas N+1)
7- Adherencia a AGENTS.md
8
9Genera un informe con problemas clasificados por gravedad.

• La dirección de sub-agentes se lanzó en marzo de 2026. Habla con un sub-agente en ejecución por apodo con @<apodo>.
• Útil cuando varios se ejecutan en paralelo y quieres redirigir uno sin molestar a los demás.
• El patrón de distribución: genera N sub-agentes en paralelo en tareas independientes y combina los resultados.
• Cinco tareas se completan en el tiempo que toma la más lenta. Regla general: si una tarea tarda menos de 30 segundos en el contexto principal, hazla allí.

La aplicación de escritorio: Codex para todo

Los sub-agentes y los Skills funcionan igual de bien en el CLI, la extensión IDE y la aplicación de escritorio. Pero la aplicación de escritorio es donde viven las funciones que no tienen equivalente en el CLI.

La actualización del 16 de abril de 2026 "Codex para (casi) todo" transformó la aplicación de escritorio de una herramienta de codificación a una estación de trabajo de desarrollo completa.

Computer Use

Codex opera tu Mac: haciendo clic, escribiendo, desplazándose, abriendo aplicaciones, navegando menús y ejecutándose junto a ti sin robar el foco del cursor.

• El uso estrella es la verificación de comportamiento. Las pruebas unitarias pasan, pero la UI sigue rota.
• Computer Use cierra esa brecha al permitir que Codex abra el servidor de desarrollo, haga clic en el flujo relevante y capture la pantalla del resultado.
• Para activarlo, ve a Configuración de Codex, Computer Use, Instalar. Concede los permisos de Grabación de Pantalla y Accesibilidad cuando macOS lo solicite. Invócalo desde cualquier indicación:

codex exec "Abre el servidor de desarrollo en localhost:3000, navega a /login, rellena el formulario con credenciales de prueba, haz clic en 'Iniciar sesión', y captura la pantalla. Verifica que la página de inicio se cargue."

Computer Use con pantalla bloqueada permite que Codex continúe operando aplicaciones de escritorio después de que tu pantalla se bloquee. Actívalo en Configuración bajo Computer Use. Inicia una tarea antes de dormir, bloquea tu máquina, revisa los resultados por la mañana.

Appshots

Presiona Comando-Comando y la ventana frontal de macOS va directamente a tu hilo de Codex.

Codex captura la captura de pantalla, el texto visible y el texto de accesibilidad; a menudo incluye contenido desplazado fuera de la pantalla.

• Sin Appshots: ves un error, cambias a Codex, escribes una pregunta, tomas una captura de pantalla, la arrastras, escribes más contexto. Medio minuto de fricción.
• Con Appshots: ves el error, presionas Comando-Comando, haces tu pregunta. Cinco segundos.

Si interactuaste con un hilo de Codex en los últimos 60 segundos, el Appshot va a esa conversación.

De lo contrario, abre un nuevo hilo. Múltiples Appshots en una sesión se apilan en un hilo. Requiere permisos de Grabación de Pantalla y Accesibilidad.

El navegador integrado

El navegador integrado es un navegador nativo con agente, no una vista previa de página. Abre tu servidor de desarrollo local, hace clic, rellena formularios, inspecciona el estado del DOM, captura pantallas y verifica que el parche recién escrito corrigió el error visual.

1. Abre un servidor de desarrollo local dentro de él, luego añade comentarios en lenguaje natural directamente sobre los elementos renderizados.
2. Escribe "haz este botón 20 píxeles más alto" sobre el elemento, y Codex ejecuta el cambio en tu base de código y recarga la página.
3. El navegador integrado proporciona acceso directo al DOM sin la sobrecarga de gestión de ventanas y está aislado de tu navegador real.

Memoria

La memoria permite que Codex retenga contexto entre sesiones.

• Después de que cada sesión termina, Codex resume la interacción y la escribe en ~/.codex/memories/.
• En la próxima sesión, lee esos archivos antes de cargar tu indicación.
• Codex aprende tu formato preferido de mensajes de commit, frameworks de pruebas, patrones de arquitectura y los errores que cometió la última vez; sin que repitas todo ese contexto.
• Actívalo en Configuración, o añade memories = true bajo [features] en config.toml.

El ecosistema de más de 90 complementos

Los complementos son paquetes seleccionados de Skills, MCPs e integraciones. Instálalos con codex plugins install <nombre>.

Categorías clave de complementos:

• Gestión de proyectos: Linear, JIRA, GitHub
• CI/CD: CircleCI, Vercel, GitHub Actions
• Bases de datos: Neon, Postgres, PlanetScale
• Calidad de código: Sentry, CodeRabbit
• Productividad: Notion, Remotion

Instala solo para herramientas que uses a diario. Limita el alcance por proyecto cuando sea posible. Audita trimestralmente. Cada complemento cuesta tokens de contexto, lo uses o no.

Codex Cloud: trabajo asíncrono a escala

La aplicación de escritorio potencia tu trabajo local e interactivo. Cloud es lo que usas cuando el trabajo es demasiado grande para una sola sesión interactiva o cuando quieres que varias tareas se ejecuten en paralelo mientras te concentras en otra cosa.

Codex Cloud es la funcionalidad que convierte a Codex de un asistente de codificación rápido en un equipo de ingeniería júnior que escala horizontalmente.

Envía una tarea, Codex inicia un espacio aislado precargado con tu repositorio, trabaja, ejecuta pruebas y abre un PR. Nada bloquea tu máquina local.

Enviar una sola tarea:

1codex cloud submit "Implementar paginación en la API de usuarios. Usa cursor-based. Añade pruebas."

Tareas paralelas; el patrón central:

1codex cloud submit "Implementar página de configuración" &
2codex cloud submit "Añadir filtro de búsqueda en /products" &
3codex cloud submit "Corregir error de desbordamiento en el carrito" &
4codex cloud submit "Actualizar dependencias obsoletas" &

Veinte minutos después, cuatro PRs están abiertos. Revisa, prioriza, fusiona.

La distribución por CSV te permite enviar un archivo de tareas y Codex las distribuye como agentes en la nube paralelos con seguimiento de progreso:

1codex cloud submit --csv tareas.csv

codex cloud ls navega por las tareas activas y terminadas. codex cloud apply <id-de-tarea> trae los cambios localmente antes de fusionar.

Integración con GitHub

Las tareas en la nube llegan a tu repositorio como PRs. La integración con GitHub determina cómo se revisan esos PRs y cómo Codex se integra en tu pipeline de CI/CD existente.

Codex y GitHub se integran a tres niveles: entornos de repositorio, revisiones de pull requests y codex-action para CI/CD.

Los entornos de repositorio son la base. Vincula un repositorio de GitHub en Configuración de Codex y las tareas en la nube clonarán el repositorio, ejecutarán tareas en un contenedor aislado y subirán el resultado como una rama o PR. AGENTS.md se lee automáticamente para cada tarea en la nube.

Las revisiones de pull requests funcionan de dos maneras:

• Menciona @codex review en cualquier comentario de PR. Codex reacciona con un emoji de ojos para confirmar la recepción, luego publica una revisión estructurada centrada en problemas graves verificados contra tu AGENTS.md.
• Activa las Revisiones Automáticas para que Codex publique en cada nuevo PR sin un disparador manual.

Después de que Codex publica una revisión, pídele que corrija los problemas señalados directamente dentro del hilo de comentarios del PR. Realiza el commit de la corrección en la misma rama y actualiza el PR.

codex-action es una Acción de GitHub oficial que ejecuta el CLI de Codex dentro de tu pipeline de CI/CD en cualquier disparador: push, programación, creación de incidencias o apertura de PR. Esta es la forma recomendada de integrar Codex en pipelines completamente automatizados donde no hay un humano presente.

Automations: trabajo sin supervisión

La integración con GitHub maneja lo que ocurre cuando un humano abre un PR. Las Automations manejan lo que ocurre cuando no es necesario que ningún humano esté involucrado.

Las Automations son tareas programadas de Codex que se ejecutan en worktrees dedicados. Configúralas desde el panel de Automations: nombre, proyecto, indicación, horario y entorno de ejecución.

La reutilización de hilos se lanzó en abril de 2026. Las Automations pueden reutilizar un hilo entre ejecuciones, acumulando contexto y volviéndose más inteligentes con el tiempo.

Tres Automations iniciales que todo proyecto debería tener:

11. Revisión semanal de dependencias (lunes 6am): Ejecuta pnpm outdated y pnpm audit. Informa hallazgos críticos, mayores y menores. Auto-PR de actualizaciones menores y de parches seguras. No toques actualizaciones críticas ni mayores; esas requieren decisiones humanas.
22. Triaje diario de Sentry (días laborables 8am): Obtén los errores de las últimas 24 horas agrupados por huella. Para cada grupo con 3 o más ocurrencias, identifica el archivo y la línea, lee el código relevante e identifica la causa raíz. Publica un informe de triaje. Solo diagnóstico, sin correcciones.
33. Limpieza semanal de PRs estancados (viernes 5pm): Lista PRs abiertos con más de 7 días. Para cada uno, determina si está esperando por ti, esperando revisión o se ha estancado, y publica un comentario de recordatorio. No cierres ni fusiones nada.

Detén cualquier Automation cuya salida deje de leerse. Una buena Automation ahorra una tarea recurrente que definitivamente harías de todas formas, produce una única salida escaneable y no toma acciones destructivas sin supervisión.

Integración MCP

Las Automations funcionan con lo que está en tu repositorio. Los servidores MCP extienden Codex para trabajar con todo lo que está fuera de él.

MCP (Model Context Protocol) es el estándar abierto detrás de los complementos. Usa un complemento cuando exista uno. Usa MCP directamente para integraciones personalizadas con herramientas internas.

Tipos de transporte:

• STDIO: Codex inicia un proceso local y se comunica a través de stdin/stdout. Cubre el 95% del uso individual.
• Streamable HTTP: Codex se conecta a un punto final de red. Se usa para MCPs de equipo alojados.

Añadir un servidor MCP directamente:

1codex mcp add mi-servidor -- npx @modelcontextprotocol/server-postgres --stdio

O directamente en ~/.codex/config.toml:

1[mcpServers.mi-servidor]
2command = "npx"
3args = ["@modelcontextprotocol/server-postgres", "--stdio"]

Confirme configuraciones por herramienta: aprueba automáticamente las lecturas, pregunta antes de escribir. Cada servidor MCP añade definiciones de herramientas al contexto de Codex, lo que consume tokens y diluye la atención. Solo habilita lo que realmente usas.

Docker MCP Toolkit conecta Codex a más de 220 servidores preconstruidos con un solo comando: docker mcp-client configure codex

Aplicación Móvil

Los servidores MCP amplían lo que Codex puede alcanzar. La aplicación móvil amplía dónde puedes alcanzar a Codex.

El 14 de mayo de 2026, Codex llegó a la aplicación móvil de ChatGPT en iOS y Android.

Codex Móvil es una superficie de control remoto y monitoreo, no un editor de código. El caso de uso típico es verificar una tarea en la nube de larga duración o una ejecución en modo Goal desde tu teléfono mientras estás lejos de tu escritorio.

Desde tu teléfono, puedes:

• Ver ejecuciones en vivo en laptops, devboxes o entornos remotos conectados
• Navegar por hilos y saltar entre tareas paralelas
• Revisar diffs antes de que se fusionen en una rama
• Aprobar o rechazar comandos que Codex quiere ejecutar en tu hardware
• Cambiar el modelo a mitad de tarea si se necesita uno más potente
• Iniciar nuevas tareas desde un prompt nuevo o directamente desde un issue de GitHub
• Comentar en un pull request que Codex abrió

Para configurarlo, actualiza ChatGPT a la versión del 13 de mayo de 2026 o posterior, inicia sesión con la misma cuenta de escritorio y asegúrate de que al menos un entorno en la nube esté configurado en Ajustes, en Codex, Entornos. La app móvil hereda automáticamente todos los hilos y hosts conectados existentes.

El ciclo práctico que esto permite: inicia una ejecución en modo Goal por la mañana antes de salir de casa, revisa su progreso en el trayecto, aprueba una decisión pausada desde tu teléfono y llega a la oficina con los primeros dos PRs ya abiertos.

Extensión de Chrome

La aplicación móvil amplía tu alcance. La extensión de Chrome amplía el alcance de Codex a cualquier sitio web en el que ya hayas iniciado sesión.

• Esto significa que puede acceder a servicios autenticados: LinkedIn, Salesforce, Gmail, Workday y cualquier herramienta interna que requiera inicio de sesión.
• Instálala yendo a Plugins dentro de la aplicación de escritorio de Codex, añadiendo el plugin de Chrome y siguiendo la configuración guiada.
• La extensión muestra el estado Conectado cuando está activa. Invócala desde cualquier hilo de Codex:

Codex puede controlar múltiples pestañas de Chrome mediante subagentes en diferentes hilos, cada pestaña aislada.

Una gran ventaja sobre la automatización headless del navegador: la extensión de Chrome puede acceder a las herramientas de desarrollo web. Codex puede inspeccionar el DOM, leer errores de consola y diagnosticar problemas en tiempo de ejecución en una sesión de navegador en vivo. Funciona tanto en macOS como en Windows.

El SDK de Codex

La extensión de Chrome maneja la automatización del navegador. El SDK maneja la automatización programática; integrar Codex como infraestructura dentro de tus propias aplicaciones y pipelines.

El SDK de Codex brinda a los desarrolladores control programático sobre Codex desde sus propias aplicaciones y pipelines de CI.

Instala el SDK de JavaScript:

Uso básico:

• Vuelve a llamar a run() en el mismo hilo para continuar la conversación. Reanuda un hilo guardado con codex.resumeThread(threadId).
• El SDK de Python usa from codex_app_server import Codex. Pasa un nombre de modelo al iniciar: thread = codex.thread_start(model="gpt-5.5").
• El SDK es actualmente experimental y requiere una instalación local de la CLI de Codex.
• Se comunica con el servidor de la aplicación local a través de JSON-RPC; controla el mismo agente con el que interactúas en la aplicación de escritorio.

Verificación: Cómo Confiar Realmente en el Resultado de Codex

Todas las superficies anteriores generan resultados. La verificación es lo que determina cuánto de ese resultado puedes realmente enviar a producción.

La generación está resuelta. La verificación es el cuello de botella.

Cinco PRs en la nube en paralelo son cinco oportunidades de enviar un bug. Sin una capa de verificación, tu rendimiento está limitado por lo rápido que puedas leer PRs.

El problema central es la adulación. El modelo que escribió el código tiene un sesgo a pensar que es correcto. Pídele que revise su propio trabajo y obtendrás un visto bueno la mayoría de las veces.

Dos soluciones estructurales:

1. auto_review (dentro de Codex) es el subagente revisor integrado de Codex. Contexto nuevo, sin inversión en el resultado anterior, con mucha más probabilidad de detectar problemas reales.
2. Verificación entre proveedores (estándar de oro) significa que Codex escribe y Claude Code revisa. La verificación entre proveedores detecta puntos ciegos específicos de una familia de modelos. Este es el hábito de verificación mínimo viable para código de producción.

El Uso de Computadora para verificación conductual cierra la brecha entre "las pruebas pasan" y "la cosa realmente funciona". Haz que Codex abra el servidor de desarrollo, haga clic en el flujo relevante, capture la pantalla del resultado y la compare con tu PRD.

El hábito mínimo viable en cada PR: ejecuta una revisión automatizada con un modelo diferente antes de abrir el diff tú mismo. Lee primero el resumen de la revisión. Solo abre el diff cuando la revisión esté limpia; luego lee por gusto, no por corrección. Para cambios de UI, mira la captura de pantalla.

Recetas: Patrones Probados en Batalla

Con los hábitos de verificación en su lugar, aquí están las plantillas de extremo a extremo para las tareas que los desarrolladores ejecutan más a menudo a través de Codex.

1. Implementar una funcionalidad: usa la Skill new-feature. Lee el PRD y AGENTS.md. Planifica primero, espera la aprobación. Pruebas para el camino feliz y un caso de error. Si algo es ambiguo, pregunta antes de generar código.
2. Corregir un bug: usa primero la Skill investigate. Solo diagnostica. Genera pasos de reproducción, hipótesis de causa raíz y un plan de validación. No corrijas hasta que esté confirmado.
3. Refactorizar: lista todas las ubicaciones con grep. Genera el plan de migración. Espera la aprobación. Todas las pruebas existentes deben pasar sin modificaciones. Si una prueba necesita actualización, la prueba está mal; detente e informa. Un PR.
4. Integración de terceros: envuélvelo en /lib/integrations/[nombre].ts. Añade variables de entorno a .env.example. Sin UI en este PR. Ábrelo como borrador para pruebas manuales contra el servicio externo.
5. Relleno de pruebas: genera el plan de pruebas que cubra casos felices, límite y error. Espera la aprobación. Todas las pruebas deben pasar contra el código de producción existente. No modifiques el código de producción.
6. Actualización de dependencias: lee las notas de la versión entre versiones. Lista los cambios disruptivos. Espera la aprobación. Actualiza y aplica los cambios de código. Ejecuta pruebas hasta que estén limpias.
7. Iniciativa en modo Goal: delimita con un máximo de PRs, un máximo de líneas de código por PR, una puerta de CI entre PRs y condiciones de parada claras. Pausa en decisiones arquitectónicas que no estén en AGENTS.md. Pausa ante cualquier cambio de API disruptivo.

Errores Comunes

Estos patrones cubren los aciertos comunes. La sección siguiente cubre las pérdidas comunes; los diez errores que explican la mayoría de las malas experiencias con Codex.

1. Tareas vagas. Nombra resultados, archivos y restricciones específicos. Si no puedes ser específico, la tarea no está lista para ser instruida.

1. Sin AGENTS.md. Escribe uno. Incluso uno malo es mejor que ninguno.

1. Saltarse el plan. "Genera un plan primero" en cualquier cosa no trivial.

1. Prompts multitarea. Una tarea por prompt. Usa subagentes o tareas en la nube para trabajo en paralelo.

1. Empezar con acceso total peligroso. workspace-write y on-request es el valor predeterminado correcto para todo excepto automatizaciones probadas.

1. Demasiados MCPs y plugins. Mantén la lista ajustada. Deshabilita lo que no uses activamente.

1. Autorevisión. Usa auto_review o una herramienta completamente diferente. El modelo que escribió el código tiene un sesgo hacia él.

1. Confiar en que compilar sea sinónimo de corrección. Incluye verificación conductual. Usa Uso de Computadora para cambios de UI.

1. Exceso de paralelización. Paraleliza solo trabajo independiente. Los archivos compartidos deben serializarse.

1. Goals sin límite. Máximo de PRs, máximo de líneas de código, máximo de tiempo, condiciones de parada claras. El modo Goal es más útil con la correa que le pondrías a un ingeniero junior.

Hoja de Referencia Rápida

Comandos de la CLI:

Ubicaciones clave de archivos:

• Configuración global: ~/.codex/config.toml
• AGENTS.md global: ~/.codex/AGENTS.md
• AGENTS.md del proyecto: <raíz-del-repo>/AGENTS.md
• Archivo de anulación: AGENTS.override.md
• Memorias: ~/.codex/memories/
• Skills (personales): $HOME/.agents/skills/
• Skills (equipo): .agents/skills/ dentro del repositorio
• Subagentes: .codex/agents/<nombre>.md

La estructura de cuatro partes del prompt:

1. Di : el resultado, no el método
2. Muestra : ejemplos de entrada y salidas esperadas
3. Describe : las APIs, librerías y patrones a usar
4. Recuerda : convenciones de AGENTS.md

Conclusión

Después de 12 meses usando Claude, el punto de inflexión no fue un mal día. Fue la acumulación de límites de tasa, fricción en el flujo de trabajo y una experiencia de aplicación de escritorio que se interponía constantemente.

Esa frustración fue lo que impulsó el cambio a Codex.

• En los últimos 90 días, profundizar en el ecosistema de OpenAI ha dejado una cosa clara: Codex se siente más completo como entorno de trabajo para flujos de trabajo serios de desarrollo.
• El modelo agéntico es más fuerte, las superficies circundantes son más amplias y el sistema es más fácil de confiar una vez que AGENTS.md, Skills, Cloud y los bucles de verificación están en su lugar.
• Eso no significa que Claude Code no tenga valor. Significa que las concesiones dejaron de tener sentido.

Si Claude Code todavía funciona para tu flujo de trabajo, sigue usándolo. Pero si estás cansado de los límites de tasa, las sesiones frágiles y las herramientas que parecen estar peleando contra tu proceso, Codex ya es lo suficientemente bueno como para justificar un cambio serio.

Este artículo fue escrito para facilitar ese cambio.

Espero que lo hayas disfrutado y empieces a construir ❤️

Aviso Legal

Este artículo fue escrito por el autor basándose en sus notas, investigación y experiencias personales, y editado por un modelo de IA (Sonnet 4.6).

La imagen de miniatura fue tomada de Pinterest y modificada usando IA.