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

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

Esto es lo que encontré

Qué es realmente 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 agente. 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 código escrito por un equipo de ingenieros junior 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 una Skill. Nunca usan subagentes. Usan el 5% de la superficie y juzgan la herramienta basándose en 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 interfaz gráfica. 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 separado.

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

Cloud es para tareas en segundo plano asíncronas, PR paralelas y trabajo mientras duermes. Las tareas se ejecutan en contenedores aislados 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 ver
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 en "escribe una función que haga X" y más en "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 junior a los que informas por la mañana y revisas por la tarde.

Un ejemplo real de esto en la práctica: los desarrolladores en WorkOS ahora encolan de cuatro a cinco tareas de Codex antes de tomar su café matutino. Cuando vuelven a sentarse, les esperan dos o tres PR completos para revisar, manejando el trabajo de mantenimiento que solía consumir del 30 al 40 por ciento de su día.

Los modelos actuales a 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 fan-out paralelo en la nube; un 25% más rápido que el especialista anterior de Codex
GPT-5.5 Pro — el de mayor razonamiento; solo en planes Pro, Business y Enterprise
Codex Mini — permanentemente gratis 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 la CLI.

Paso 2: Abre un proyecto real.

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

Codex funciona 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 abrirá automáticamente. Haz clic en Continuar y vuelve a la terminal.

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

Este único 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 genera un archivo AGENTS.md con lo que encuentra.

Revisa el archivo generado, ajusta lo que sea incorrecto y haz commit. Cada futura sesión 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 aumenta tu confianza en qué contexto ha cargado:

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.

Esta es la forma correcta de un prompt de 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 del sitio web de OpenAI. Inicia sesión con la misma cuenta de ChatGPT.

Paso 7: Instala la extensión 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 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 sandbox, servidores MCP, modelos predeterminados
~/.codex/AGENTS.md : AGENTS.md personal, 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 funcional, el siguiente paso es hacer que cada sesión futura comience con la misma calidad. Eso es lo que hace AGENTS.md.

AGENTS.md es el único archivo que separa la salida mediocre de Codex de una salida consistente y de alta calidad.
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.
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 lenguajes, 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)
Guía vaga ("escribe código limpio" no significa nada para un agente)
Documentación que duplica 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:

Verifica que Codex lo está leyendo: pide resume las instrucciones actuales que has cargado
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.

La CLI en profundidad

Con AGENTS.md configurado, lo siguiente que debes dominar es la CLI misma. La mayoría de los usuarios solo escriben codex y se pierden los comandos que la hacen verdaderamente poderosa.

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 poderosa para todo lo que se pueda automatizar con scripts:

Enlaza exec en hooks de git, pipelines de CI y cron jobs. Es el componente básico para todo lo automatizado.

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

codex cloud administra tareas en la nube asíncronas, cubiertas en la sección Cloud a continuación.

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 sandbox para esta sesión
--approval <política> : anula la política de aprobación para esta sesión

Sandbox y aprobaciones

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

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

Los tres modos de sandbox:

workspace-write (predeterminado): lectura y escritura dentro del espacio de trabajo, comandos rutinarios, sin red a menos que se permita. Úsalo casi siempre.
read-only: solo lectura, sin escrituras, sin shell. Úsalo para revisión de código y exploración.
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 sandbox, pregunta antes de cualquier cosa que rompa el límite del sandbox.

auto_review es un subagente 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 Goal mode donde no quieres supervisar cada paso.

Agrega comandos que constantemente te piden aprobación. Nunca agregues nada destructivo.

Cómo hacer prompts efectivos en Codex

Sandbox configurado, sesiones en ejecución. La siguiente palanca es la calidad del prompt, 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 del prompt. Los prompts vagos 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 API, 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 suele quererlos todos.

La regla de un solo cambio: Codex funciona dramáticamente mejor en una cosa que en cinco. "Arregla el error de autenticación, agrega pruebas, refactoriza el repositorio de usuario y actualiza el README" es una moneda al aire. El mismo trabajo dividido en cuatro prompts es confiable.
Obliga a 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.
Especifica explícitamente el comportamiento en caso de fallo. Si se deja solo, Codex hará que las pruebas pasen por cualquier medio necesario:

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 correcciones de errores
Alto: decisiones de arquitectura, depuración difícil, grandes refactorizaciones multiarchivo

Goal Mode

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

Goal mode es para trabajo demasiado grande para ser detallado tarea por tarea pero lo suficientemente coherente para un solo objetivo. Se volvió estable en mayo de 2026.

Administra un Goal en ejecución con estos comandos:

codex goal status: ver Goals activos y su progreso
codex goal logs <id>: inspeccionar lo que Codex ha hecho hasta ahora
codex goal pause <id>: detener la ejecución y esperar tu entrada
codex goal resume <id>: continuar desde donde se detuvo
codex goal cancel <id>: detener y descartar el Goal

Comienza con Goals acotados. "Máximo 5 PRs" hasta que confíes en cómo Codex interpreta tus objetivos. Un Goal descontrolado que hace con confianza lo incorrecto es el peor escenario.

Siempre delimita con: máx. PRs, máx. líneas de código por PR, compuertas de CI entre PRs y condiciones claras de detención. 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

Goal mode maneja iniciativas grandes. Las Skills manejan los microflujos de trabajo recurrentes que aparecen en todos los proyectos. Si te encuentras repitiendo las mismas instrucciones entre sesiones, esa es tu señal para escribir una Skill.

Una 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 Skills por nombre y descripción. Carga las instrucciones completas solo cuando una tarea activa la Skill. Puedes tener 50 Skills con costo de contexto cero hasta que se active una.

Dónde viven las Skills:

Personales: $HOME/.agents/skills/: transversales a proyectos, reflejan cómo trabajas independientemente del repositorio
De equipo: .agents/skills/ dentro del repositorio: específicas del proyecto, versionadas, compartidas con colaboradores

El formato SKILL.md:

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

open-pr es el flujo de trabajo de PR estándar: verificar la rama, subir, crear el PR con un cuerpo estructurado, aplicar etiquetas y solicitar revisión. La Skill más usada en el trabajo diario.
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 de la Skill open-pr. Si algo en el PRD es ambiguo, pregunta antes de generar código.
investigate es la Skill de diagnosticar sin arreglar. Confirma la reproducción, lee las rutas de código relevantes, forma una hipótesis ("Creo que X ocurre debido a Y") y genera la hipótesis y el plan de validación como Markdown. No implementa una corrección. La salida es comprensión, no código.

La Skill investigate es importante porque Codex omitirá el análisis de causa raíz cada vez si se lo permites. 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 cargadas: lista de skills disponibles

Subagentes y paralelismo

Las Skills manejan tus flujos de trabajo repetibles. Los subagentes manejan los paralelos. La distinción importa porque el paralelismo mal hecho crea más problemas de los que resuelve.

Un subagente 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 una Skill, que se ejecuta en el contexto del agente principal.

Tres patrones donde los subagentes son la herramienta correcta:

Exploración: generar un subagente para leer 30 archivos y resumir; la lectura ocurre en su contexto, no en el tuyo
Implementación paralela: cinco funcionalidades independientes como cinco subagentes concurrentes, cada uno con su propio contexto y plan
Verificación: un subagente revisor nuevo no está sesgado por haber escrito el código recién

Los subagentes personalizados se definen en .codex/agents/<nombre>.md:

El direccionamiento de subagentes se lanzó en marzo de 2026. Habla con un subagente 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 fan-out: generar N subagentes en paralelo en tareas independientes y fusionar los resultados.
Cinco tareas se completan en el tiempo que toma la más lenta. Regla general: si una tarea toma menos de 30 segundos en el contexto principal, hazla allí.

La aplicación de escritorio: Codex para todo

Los subagentes y las Skills se ejecutan igualmente bien en la 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 la 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 completa para desarrolladores.

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 clave es la verificación de comportamiento. Las pruebas unitarias pasan pero la UI aún está rota.
Computer Use cierra esa brecha al permitir que Codex abra el servidor de desarrollo, navegue por el flujo relevante y capture la pantalla del resultado.
Para activarlo, ve a Configuración de Codex, Computer Use, Instalar. Concede permisos de Grabación de Pantalla y Accesibilidad cuando macOS lo solicite. Invócalo desde cualquier prompt:

Computer Use bloqueado permite que Codex continúe operando aplicaciones de escritorio después de que bloquees tu pantalla. Actívalo en Configuración, en 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 solo hilo. Requiere permisos de Grabación de Pantalla y Accesibilidad.

El navegador integrado

El navegador integrado es un navegador agentivo nativo, no una vista previa de página. Abre tu servidor de desarrollo local, hace clic, llena formularios, inspecciona el estado del DOM, captura capturas de pantalla y verifica que el parche recién escrito haya corregido el error visual.

Abre un servidor de desarrollo local dentro de él, luego agrega comentarios en lenguaje natural directamente sobre los elementos renderizados.
Escribe "haz este botón 20 píxeles más alto" en el elemento, y Codex ejecuta el cambio en tu base de código y recarga la página.
El navegador integrado proporciona acceso directo al DOM sin 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 prompt.
Codex aprende tu formato de mensaje de commit preferido, frameworks de prueba, patrones de arquitectura y los errores que cometió la última vez; sin que repitas ese contexto.
Actívalo en Configuración, o agrega memories = true bajo [features] en config.toml.

El ecosistema de más de 90 plugins

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

Categorías clave de plugins:

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 por proyecto cuando sea posible. Audita trimestralmente. Cada plugin cuesta tokens de contexto, lo uses o no.

Codex Cloud: Trabajo asíncrono a escala

La aplicación de escritorio impulsa tu trabajo local e interactivo. Cloud es a lo que recurres cuando el trabajo es demasiado grande para una sola sesión interactiva o cuando quieres que múltiples tareas se ejecuten en paralelo mientras te enfocas en otra cosa.

Codex Cloud es la función que transforma a Codex de un asistente de codificación rápido a un equipo de ingeniería junior que escala horizontalmente.

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

Envío de una sola tarea:

Tareas paralelas; el patrón central:

Veinte minutos después, cuatro PR están abiertos. Revisa, clasifica, fusiona.

CSV fan-out te permite enviar un archivo de tareas y Codex las distribuye como agentes en la nube paralelos con seguimiento de progreso:

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

Integración con GitHub

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

Codex y GitHub se integran en tres niveles: entornos de repositorio, revisión 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 enviarán el resultado como una rama o PR. AGENTS.md se lee automáticamente para cada tarea en la nube.

La revisión de pull requests funciona 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 publique una revisión, pídele que corrija los problemas marcados 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 GitHub Action oficial que ejecuta la CLI de Codex dentro de tu pipeline de CI/CD en cualquier disparador: push, programación, creación de issue o apertura de PR. Esta es la forma recomendada de integrar Codex en pipelines completamente automatizados donde no hay ningún humano presente.

Automations: Trabajo sin supervisión

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

Las Automations son tareas de Codex programadas que se ejecutan en worktrees dedicados. Configúralas desde el panel de Automations: nombre, proyecto, prompt, programación 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:

Revisión semanal de dependencias (lunes 6am): Ejecuta pnpm outdated y pnpm audit. Reporta hallazgos críticos, mayores y menores. Auto-PR de actualizaciones seguras menores y de parche. No toques actualizaciones críticas o mayores; esas necesitan decisiones humanas.
Clasificación diaria 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 clasificación. Solo diagnóstico, sin correcciones.
Limpieza semanal de PR obsoletos (viernes 5pm): Lista los PR abiertos con más de 7 días. Para cada uno, determina si está esperando por ti, esperando revisión o se ha vuelto obsoleto, y publica un comentario de aviso. No cierres ni fusiones nada.

Mata cualquier automation cuya salida deje de leerse. Una buena automation ahorra una tarea recurrente que definitivamente harías de todos modos, produce una sola salida escaneable y no realiza acciones destructivas sin supervisión.

Integración MCP

Las Automations trabajan con lo que está en tu repositorio. Los servidores MCP extienden Codex para trabajar con todo lo externo.

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

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 endpoint de red. Se usa para MCP de equipo alojados.

Agregar un servidor MCP puro:

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

Configura aprobaciones por herramienta: aprobación automática para lecturas, preguntar antes de escribir. Cada servidor MCP añade definiciones de herramientas al contexto de Codex, consumiendo tokens y diluyendo la atención. Solo habilita lo que realmente usas.

El 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 extienden lo que Codex puede alcanzar. La aplicación móvil extiende dónde puedes alcanzar 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 revisar una tarea en la nube de larga duración o una ejecución en modo Goal desde tu teléfono mientras no estás en 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 diferencias antes de fusionarlas 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 tener al menos un entorno en la nube configurado en Ajustes, en Codex, Entornos. La aplicación 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 tu 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 extiende tu alcance. La extensión de Chrome extiende 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, agregando 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 a través de subagentes en diferentes hilos, cada pestaña aislada.

Una gran ventaja sobre la automatización de navegador sin interfaz gráfica: 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 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; integrando 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:

javascript

1npm install @openai/codex-sdk

Uso básico:

javascript

1import { Codex } from '@openai/codex-sdk';
2
3const codex = new Codex({ apiKey: process.env.OPENAI_API_KEY });
4const thread = await codex.createThread();
5await thread.run('Write a unit test for this function');

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 actualmente es experimental y requiere una instalación local de Codex CLI.
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 producen 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 error. Sin una capa de verificación, tu rendimiento está limitado por la rapidez con que puedes leer PRs.

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

Dos soluciones estructurales:

auto_review (en-Codex) es el subagente revisor incorporado de Codex. Contexto nuevo, sin inversión en el resultado anterior, mucho más propenso a señalar problemas reales.
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 en producción.

Computer Use para verificación de comportamiento cierra la brecha entre "las pruebas pasan" y "la cosa realmente funciona". Haz que Codex abra el servidor de desarrollo, navegue por el flujo relevante, tome una captura de 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 establecidos, aquí están las plantillas de extremo a extremo para las tareas que los desarrolladores ejecutan con Codex con más frecuencia.

Implementar una funcionalidad: usa la Skill new-feature. Lee el PRD y AGENTS.md. Planifica primero, espera aprobación. Pruebas para el camino feliz y un caso de error. Si algo es ambiguo, pregunta antes de generar código.
Corregir un error: 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.
Refactorizar: lista todas las ubicaciones con grep. Genera el plan de migración. Espera aprobación. Todas las pruebas existentes deben pasar sin modificaciones. Si una prueba necesita actualizarse, la prueba está mal; detente y reporta. Un solo PR.
Integración de terceros: envuélvelo en /lib/integrations/[nombre].ts. Agrega variables de entorno a .env.example. Sin UI en este PR. Ábrelo como borrador para pruebas manuales contra el servicio externo.
Relleno de pruebas: genera el plan de pruebas que cubra casos felices, límite y error. Espera aprobación. Todas las pruebas deben pasar contra el código de producción existente. No modifiques el código de producción.
Actualización de dependencias: lee las notas de la versión entre versiones. Lista los cambios disruptivos. Espera aprobación. Actualiza y aplica cambios de código. Ejecuta pruebas hasta que estén limpias.
Iniciativa de modo Goal: delimita con máximo de PRs, máximo de líneas de código por PR, puerta de CI entre PRs y condiciones claras de parada. Pausa en decisiones arquitectónicas no incluidas en AGENTS.md. Pausa en cualquier cambio de API que sea disruptivo.

Errores Comunes

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

Tareas vagas. Nombra resultados, archivos y restricciones específicos. Si no puedes ser específico, la tarea no está lista para ser asignada.
Sin AGENTS.md. Escribe uno. Incluso uno malo es mejor que ninguno.
Saltarse el plan. "Produce un plan primero" en cualquier cosa que no sea trivial.
Prompts multitarea. Una tarea por prompt. Usa subagentes o tareas en la nube para trabajo en paralelo.
Empezar con acceso total peligroso. workspace-write y on-request son los valores predeterminados correctos para todo excepto automatizaciones probadas.
Demasiados MCPs y plugins. Mantén la lista ajustada. Desactiva lo que no uses activamente.
Autorevisión. Usa auto_review o una herramienta completamente diferente. El modelo que escribió el código está sesgado hacia él.
Confiar en que compile correctamente como señal de corrección. Incluye verificación de comportamiento. Usa Computer Use para cambios de UI.
Sobreparalelización. Paraleliza solo trabajo independiente. Los archivos compartidos deben serializarse.
Goals sin límites. Máximo de PRs, máximo de líneas de código, tiempo máximo, condiciones claras de parada. El modo Goal es más útil con la correa que le darías a un ingeniero junior.

Hoja de Referencia Rápida

Comandos de CLI:

Ubicaciones clave de archivos:

Configuración global: ~/.codex/config.toml
AGENTS.md global: ~/.codex/AGENTS.md
AGENTS.md del proyecto: \<repo-root>/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 prompt en cuatro partes:

Decir: el resultado, no el método
Mostrar: ejemplos de entrada y salidas esperadas
Describir: las APIs, librerías y patrones a usar
Recordar: convenciones de AGENTS.md

Conclusión

Después de 12 meses usando Claude, el punto de quiebre 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 seguía interponiéndose.

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 compensaciones 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, sesiones frágiles y herramientas que parecen estar peleando contra tu proceso, Codex ahora es lo suficientemente bueno como para justificar un cambio serio.

Este artículo fue escrito para hacer ese cambio más fácil.

Espero que hayas disfrutado esto y empieces a construir ❤️

Descargo de Responsabilidad

Este artículo fue escrito por el autor basado 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.