¿Qué es OpenAI Codex?

Codex es el agente de codificación de OpenAI. Lee un repositorio, planifica un cambio, edita archivos, ejecuta comandos en un entorno aislado y te entrega una diferencia para revisar, todo desde cuatro superficies que comparten la misma configuración: la aplicación Codex, una extensión IDE, una CLI y un entorno en la nube/web para tareas de mayor duración o en segundo plano. Porque las cuatro leen lo mismo ~/.codex La configuración, un servidor MCP o un complemento que configure una sola vez, le acompañará tanto en la terminal como en el IDE.

En breve: Codex es menos una herramienta individual que un entorno de ejecución: un lugar donde las habilidades, las conexiones de aplicaciones y los servidores MCP se integran en torno a una tarea de codificación, en lugar de tener que reconstruir la misma configuración en cada proyecto.

¿Por qué los desarrolladores están adoptando Codex?

La mayoría de las comparaciones de "asistentes de codificación con IA" se centran en la calidad del modelo, pero el cambio más interesante es estructural. Codex separa tres elementos que antes se encontraban en una única y enorme solicitud del sistema: instrucciones (AGENTES.md), procedimientos reutilizables (habilidades) y acceso a la herramienta (aplicaciones y servidores MCP). Esa separación es lo que hace posible el uso de complementos: un complemento es simplemente un conjunto de esos tres elementos que se pueden instalar y desinstalar como una unidad, en lugar de pegar código repetitivo en cada nuevo chat.

El resultado práctico: un equipo puede estandarizar la forma en que Codex revisa las solicitudes de extracción, lee los problemas de Sentry o redacta la documentación, y distribuir ese estándar como un paquete instalable en lugar de una página wiki que nadie lee.

Instalación y configuración de Codex

La CLI es el lugar más rápido para ver que la configuración surte efecto. Codex almacena la configuración en ~/.codex/config.toml por defecto (sobrescribir con CODEX_HOME para un perfil específico del proyecto).

# Abre el navegador de complementos dentro del códice CLI /plugins # Agrega un servidor MCP directamente desde el códice CLI mcp add context7 -- npx -y @upstash/context7-mcp # Consulta los servidores MCP activos en una sesión en ejecución /mcp

Para un control más preciso (tiempos de espera, listas de herramientas permitidas, modos de aprobación por herramienta), edite config.toml directamente. Aquí hay un bloque mínimo y realista para un servidor MCP HTTP con capacidad de transmisión:

[mcp_servers.figma] url = "https://mcp.figma.com/mcp" bearer_token_env_var = "FIGMA_OAUTH_TOKEN" [mcp_servers.figma] startup_timeout_sec = 20 tool_timeout_sec = 45

Plugins vs. Habilidades vs. Aplicaciones vs. MCP

Estos cuatro términos se usan indistintamente en la publicidad, y es precisamente por eso que los principiantes se confunden. Aquí está la distinción que realmente importa al decidir qué instalar.

Así que cuando alguien dice "instala el complemento de GitHub", lo que realmente se instala en tu máquina puede ser una habilidad, una conexión de aplicación, un servidor MCP o las tres cosas a la vez; el complemento es simplemente el envoltorio que permite instalarlo y compartirlo.

Directorio de complementos

Codex organiza los complementos en tres grupos, tanto si los exploras en la aplicación como en la interfaz de línea de comandos (CLI):

• Seleccionado por OpenAI — Complementos revisados ​​disponibles para todos los usuarios de Codex.
• Compartido contigo — complementos que otro miembro de tu espacio de trabajo de ChatGPT haya publicado internamente.
• Creado por ti — complementos que has creado y añadido a tu propio espacio de trabajo.

La instalación es la misma en todas partes: abra la página de detalles de un complemento, seleccione instalar (o Instalar complemento En la CLI, conecta cualquier aplicación externa que necesite cuando se le solicite y luego inicia un nuevo hilo antes de usarla. Tus ajustes de aprobación existentes seguirán rigiendo lo que el complemento puede hacer una vez que esté activo; instalarlo no otorga permisos generales.

Para deshabilitar un complemento sin eliminarlo, cambie su entrada en config.toml:

[plugins."gmail@openai-curated"] habilitado = falso

El ecosistema de complementos de Codex

Al momento de escribir este artículo, el directorio seleccionado de OpenAI se centra en un conjunto específico de herramientas en lugar de un extenso catálogo de aplicaciones; una decisión deliberada, ya que cada complemento seleccionado ha pasado por un proceso de revisión. Los complementos de terceros y los creados por el propio espacio de trabajo se extienden mucho más allá de esta lista, pero ofrecen diferentes garantías de confianza, por lo que conviene saber cuáles son cuáles.

Cómo leer una tarjeta de plugin

Cada complemento de esta guía está etiquetado con el tipo de límite de confianza que lo respalda:

Desarrollo

Documentación y diseño

Productividad

Depuración

Despliegue

Integración con GitHub

GitHub recibe un trato especial porque Codex incluye tanto un plugin seleccionado como una integración más profunda de primera mano, además de una acción de GitHub específica para ejecuciones activadas por CI. En la práctica, esto significa tres puntos de entrada distintos: asignar Codex a una incidencia desde la interfaz de usuario de GitHub, invocarlo desde la línea de comandos en un repositorio extraído o activarlo desde un archivo de flujo de trabajo en cada solicitud de extracción. Los equipos que estandarizan Codex para la revisión de código suelen empezar con la acción, ya que no requiere que cada colaborador tenga Codex configurado localmente.

Integración con Figma

Figma se conecta a Codex a través de su propio servidor MCP, en lugar de una integración de Codex, tanto en su versión local (aplicación de escritorio) como remota (alojada). Este es un buen ejemplo del modelo de complementos en su máxima expresión: OpenAI no tuvo que desarrollar herramientas específicas para Figma, solo tuvo que ofrecer un buen soporte para MCP, y el servidor de Figma se encarga del resto. La desventaja es que el comportamiento del servidor, los límites de velocidad y la fiabilidad quedan fuera del control de OpenAI.

Integración de conceptos

El plugin de Notion, cuidadosamente seleccionado, combina la lectura y escritura de páginas y bases de datos con funcionalidades optimizadas para convertir la información de ingeniería (registros de confirmación, resúmenes de solicitudes de extracción, cronogramas de incidentes) en contenido estructurado de Notion. Representa una ventaja evidente para los equipos que ya utilizan Notion como fuente principal de información para la toma de decisiones, ya que elimina la necesidad de que alguien actualice manualmente la documentación.

Integración con Slack

Al igual que GitHub, Slack cuenta con un plugin especializado y una integración nativa más completa. La diferencia práctica se hace evidente en los flujos de trabajo sensibles a la latencia: las integraciones nativas suelen admitir activadores más complejos (una ejecución de Codex iniciada desde un mensaje de Slack, no solo una publicación de Codex en Slack), mientras que un plugin por sí solo suele ser unidireccional, desde Codex hacia el canal.

Integración de Sentry

Sentry es, sin duda, el plugin más útil para un equipo que ya trabaja con rapidez, ya que simplifica el proceso de "detectar el error → encontrar el rastreo de la pila → encontrar la confirmación → proponer la solución" en un único ciclo de conversación. El inconveniente: Codex propondrá una solución para un problema antiguo o duplicado si no se especifica el alcance de la consulta (problemas abiertos, últimas 24 horas, proyecto específico), por lo que la especificidad en la solicitud es más importante aquí que en casi cualquier otro lugar de esta guía.

Automatización del navegador

Para cualquier tarea que se ejecute en un navegador en lugar de una API (verificar visualmente un cambio en la interfaz de usuario, extraer información de una página sin API pública, gestionar un proceso de inicio de sesión), Codex utiliza servidores MCP del navegador en lugar de un complemento específico. Los dos más mencionados en la documentación son Playwright y Chrome DevTools, ambos controlables mediante MCP. La aplicación Codex también incluye su propio navegador integrado y una extensión para Chrome que permite una interacción más fluida entre la visualización de la página y la edición del código.

Flujo de trabajo del terminal

La interfaz de línea de comandos (CLI) es donde se configuran los complementos y el MCP en el día a día. Algunos comandos que vale la pena memorizar:

/plugins # explorar, instalar y activar/desactivar plugins por marketplace /mcp # listar servidores MCP activos en esta sesión codex mcp add # agregar un nuevo servidor MCP desde la consola codex mcp --help

En las pestañas del mercado del navegador de complementos, al presionar Espacio En un complemento instalado, lo activa o desactiva para la sesión actual; esto resulta útil cuando se desea descartar un complemento como la causa de una llamada inesperada a una herramienta sin desinstalarlo por completo.

AGENTES.md

AGENTS.md es la palanca menos utilizada en la mayoría de las configuraciones de Codex. Codex lo lee antes de realizar cualquier trabajo, construyendo una cadena de instrucciones a partir de un archivo global en ~/.codex/AGENTS.md Recorriendo cada directorio entre la raíz de tu proyecto y tu directorio de trabajo actual, cada archivo anidado se superpone o reemplaza a los que están por encima.

# AGENTS.md ## Expectativas del repositorio: - Ejecuta `npm run lint` antes de abrir una solicitud de extracción. - Documenta las utilidades públicas en docs/ cuando cambies el comportamiento.

Anidado AGENTES.override.md Los archivos permiten que un subdirectorio específico (por ejemplo, un servicio de pagos con reglas más estrictas) reemplace por completo la guía que se encuentra encima, en lugar de agregarle información; esto resulta útil en monorepos donde "ejecutar las pruebas" significa algo diferente en cada paquete.

Memoria

El sistema de memoria local de Codex es independiente de la memoria web de ChatGPT y está desactivado por defecto. Una vez habilitado, Codex puede convertir el contexto de sesiones pasadas inactivas y elegibles en archivos de memoria local en ~/.codex/memorias/, eliminando la información confidencial a medida que avanza y omitiendo las conversaciones breves para que no resuma el trabajo que aún está en curso.

[características] recuerdos = verdadero

Dos configuraciones que vale la pena conocer: recuerdos.usar_recuerdos controla si los recuerdos pasados ​​se inyectan en las nuevas sesiones y recuerdos.deshabilitar_en_contexto_externo Evita por completo que los chats que dependían de búsquedas web o llamadas a herramientas MCP se generen en memoria, lo cual resulta útil si no quieres que una sesión de triaje de Sentry contamine la memoria con el rastreo de pila de otra persona.

Ingeniería de indicaciones, contexto y bucles

Tres habilidades relacionadas pero distintas diferencian a los desarrolladores que luchan contra Codex de los desarrolladores que lo utilizan para agilizar el proceso de desarrollo.

Ingeniería rápida

Indica qué quieres que se cambie y cómo se ve el resultado final, no solo el síntoma. "Corrige la prueba de pago inestable" es menos efectivo que "la prueba de pago falla intermitentemente en la aserción del código de descuento; reprodúcela, encuentra la condición de carrera y agrega una prueba de regresión".

Ingeniería de contexto

Se trata de a qué tiene acceso Codex, no de lo que escribas: el ámbito correcto de AGENTS.md, los servidores MCP habilitados correctos, los archivos abiertos correctos. Incluso una solicitud perfectamente redactada fallará si Codex no puede ver el archivo de configuración que controla el comportamiento que estás consultando.

Ingeniería de bucle

La práctica de diseñar ciclos repetibles de proponer → ejecutar → verificar → repetir en lugar de solicitudes únicas —por ejemplo, configurar Codex para que ejecute el conjunto de pruebas después de cada cambio y continúe iterando hasta que sea correcto, en lugar de revisar cada intento manualmente— documenta este patrón directamente en el manual de Codex para bucles de reparación iterativos.

Flujos de trabajo multiagente y subagente

Codex admite subagentes: instancias de agente con ámbito definido a las que una sesión principal de Codex puede delegar tareas específicas. Su uso práctico consiste en paralelizar el trabajo independiente: un subagente ejecuta el conjunto de pruebas y genera informes mientras la sesión principal continúa editando, en lugar de que un solo agente realice todas las tareas de forma secuencial. Esta funcionalidad es más reciente y avanzada que los complementos o MCP, y conviene considerarla como una optimización una vez que el flujo de trabajo con un solo agente sea fiable, no como un punto de partida.

Flujos de trabajo reales, paso a paso.

1. Crea una aplicación React con Codex

Primero, crea una estructura básica con un archivo AGENTS.md claro (administrador de paquetes, comando de prueba) y luego solicita la funcionalidad en términos de resultados. Solicita las pruebas junto con el componente, no como una opción posterior.

2. Solucione los errores de producción utilizando el complemento Sentry.

Defina el alcance de la consulta, solicite la causa raíz antes de realizar una corrección y exija una prueba de regresión en la misma diferencia.

3. Generar la interfaz de usuario directamente desde Figma.

Dirige Codex a un fotograma específico, no a un archivo completo; los archivos grandes ralentizan la inspección de MCP y aumentan la probabilidad de que se incluyan componentes no relacionados.

4. Escribir documentación a partir de confirmaciones de GitHub.

5. Refactorizar un código heredado

Solicita un plan antes de escribir el código. Las refactorizaciones de sistemas heredados son donde la ingeniería de bucles demuestra su valía: deja que Codex refactorice un módulo, ejecuta el conjunto de pruebas y continúa solo cuando el resultado sea positivo.

6. Revisar automáticamente las solicitudes de extracción.

La acción de GitHub es el punto de partida adecuado: activa la revisión del Codex en cada solicitud de extracción en lugar de depender de que alguien recuerde solicitarla manualmente.

7. Generar migraciones SQL

Sin un complemento de base de datos seleccionado, esto normalmente se ejecuta a través de un servidor MCP con ámbito de proyecto para su base de datos, y la migración siempre se revisa y aplica manualmente en lugar de ejecutarse automáticamente.

8. Implementar en Vercel

Mantén los despliegues de producción bajo un proceso de aprobación manual, incluso cuando los despliegues de vista previa se conviertan en algo rutinario.

Mejores prácticas

Del

• Mantén el archivo AGENTS.md con un alcance definido y específico: una regla clara es mejor que cinco reglas vagas.
• Iniciar nuevos complementos en inmediato modo de aprobación antes de cambiar a auto.
• Desinstala los complementos que no estés utilizando activamente; cada herramienta instalada es una superficie de ataque.
• Limite las credenciales del servidor MCP al mínimo necesario para la tarea.

No hacer

• No confíes en la memoria para reglas que siempre deben aplicarse; usa AGENTS.md.
• No le otorgues a un plugin acceso de escritura en producción "para guardar un paso"; el paso que guarda es el que detecta los errores.
• No apile servidores MCP no relacionados en una misma sesión solo porque estén instalados; cada uno agrega tokens al contexto y aumenta la posibilidad de confusión entre las herramientas.

Errores que cometen los principiantes

• Tratar la instalación de un complemento como una decisión que se toma una sola vez, en lugar de revisar sus permisos a medida que el proyecto madura.
• Indicaciones para la redacción que describan el síntoma en lugar del estado final deseado.
• Omitir por completo el archivo AGENTS.md y volver a explicar las convenciones del proyecto en cada una de las indicaciones.

Lista de verificación para la organización del repositorio

• Un archivo AGENTS.md de nivel raíz con comando de prueba, administrador de paquetes y acciones prohibidas.
• AGENTS.override.md anidado solo cuando un subdirectorio difiere realmente
• Delimitado por el alcance del proyecto .codex/config.toml para servidores MCP específicos de este repositorio
• Una breve lista de los complementos aprobados para este repositorio y por qué.

Preguntas frecuentes

Conclusión

El sistema de complementos es lo que convierte a Codex de una excelente herramienta de autocompletado en un agente que puede integrarse fácilmente con las herramientas de tu equipo (GitHub, Figma, Sentry, Slack, Notion) sin necesidad de crear código de conexión. Sin embargo, esto no reemplaza el buen criterio: revisa las diferencias, define los modos de aprobación y mantén actualizado el archivo AGENTS.md. Empieza con un complemento que elimine una molestia cotidiana, familiarízate con sus ajustes de aprobación y amplíalo a partir de ahí. El flujo de trabajo que más tiempo te ahorra rara vez es el más complejo, sino el que realmente sigues utilizando.