La mayoría de las personas conoce Codex a través de la App, la interfaz de línea de comandos o la extensión para IDE. Estas experiencias son importantes, pero son solo algunas de las formas de usar el mismo sistema subyacente.
El arnés de ejecución de código abierto de Codex es lo que hace posibles todas estas experiencias. Ayuda a los modelos a reunir contexto, razonar sobre las tareas, usar herramientas, operar dentro de los límites configurados, solicitar aprobación y avanzar con el trabajo.
Eso cambia lo que los desarrolladores pueden crear. En lugar de pedirle a cada equipo que traslade su trabajo a un asistente de programación de propósito general, puedes integrar el agente en software diseñado en torno al trabajo concreto: un flujo de trabajo de ingeniería, un panel de operaciones, una investigación de seguridad, una consola de soporte al cliente o una aplicación interna creada para un equipo especializado.
La parte reutilizable es el ciclo del agente
Un agente capaz es más que un prompt y la respuesta de un modelo. Necesita una forma de comprender una tarea, mantener el contexto a lo largo del tiempo, examinar información relevante, llamar a herramientas, mostrar el progreso, manejar fallas, solicitar aprobación humana cuando sea necesario y devolver un resultado útil.
Ese sistema de ejecución que lo rodea es el arnés de ejecución.
El diseño del arnés de ejecución puede cambiar sustancialmente los resultados: en ARC-AGI-3, la conservación del razonamiento y la compactación elevaron la puntuación de GPT-5.6 Sol del 13,3 % al 38,3 %, al tiempo que redujeron los tokens de salida a una sexta parte.
Creamos el arnés de ejecución de Codex para gestionar el estado de la conversación, transmitir la ejecución en streaming, usar herramientas, aplicar las políticas configuradas de sandbox y aprobación, y dar continuidad al trabajo entre turnos. Con Codex app-server, exponemos esas capacidades mediante un protocolo de cliente documentado: las aplicaciones pueden crear hilos, iniciar turnos, recibir eventos y gestionar solicitudes de aprobación.
Si estás creando software que necesita un agente, puedes comenzar con Codex en lugar de inventar un nuevo entorno de ejecución y luego decidir de qué debe encargarse la aplicación que lo integra.
Un arnés de ejecución abierto que los desarrolladores pueden examinar y adaptar
Como el arnés de ejecución es de código abierto, puedes examinar la capa entre tu aplicación y el modelo, comprender cómo se comporta y adaptar la integración a tu producto.
Eso les da a los desarrolladores control sobre las partes que permiten adaptar el agente a su producto:
-
La interfaz. Un equipo puede conservar sus paneles, editores, colas, mapas, registros y flujos de aprobación existentes en lugar de forzar cada interacción a pasar por una ventana de chat genérica.
-
Contexto y herramientas. Una aplicación puede exponer los sistemas, documentos, datos y acciones relevantes para un flujo de trabajo específico, incluidos los servicios MCP propios de la aplicación.
-
Límites operativos. La aplicación anfitriona puede decidir dónde se ejecuta un agente, a qué archivos o herramientas puede acceder, qué acciones requieren aprobación, cómo se supervisa el trabajo y cómo se devuelven los resultados al sistema de registro.
Publicamos Codex CLI, app-server y el SDK oficial de Codex como componentes de código abierto. Nuestra guía de componentes de código abierto enumera cuáles están disponibles y dónde se encuentra cada uno.
La capa de código abierto comprende el arnés de ejecución y las interfaces de integración; el acceso a los modelos y los servicios administrados siguen siendo independientes.
Elige la capa de integración adecuada
Desarrollar sobre Codex no requiere la misma integración para todos los casos de uso.
-
Para un script, una tarea de CI o una tarea puntual en segundo plano, codex exec puede ejecutar un flujo de trabajo de agente con un alcance delimitado y devolver un resultado estructurado.
-
Para el código de una aplicación que necesita iniciar, reanudar o transmitir tareas de Codex en streaming, el SDK oficial de Codex proporciona una interfaz programática directa.
Para ver un ejemplo que puedas ejecutar, consulta la documentación del SDK de Codex.
Usa Codex app-server cuando el agente forme parte del producto mismo. Permite que tu aplicación se conecte a un proceso local de Codex, mantenga conversaciones abiertas, transmita eventos en streaming, interrumpa el trabajo, exponga herramientas y responda a solicitudes de aprobación. El SDK simplifica los flujos de trabajo programáticos habituales; app-server les da a los equipos de producto control directo sobre el ciclo de vida y la experiencia del usuario.
Crea software en torno al flujo de trabajo
La oportunidad más interesante no es reproducir Codex App con otro logotipo, sino crear software que refleje cómo ya trabaja una persona o un equipo en particular:
Un analista de seguridad podría necesitar una cola de investigaciones, alertas recientes, servicios afectados y un paso de aprobación antes de abrir un ticket de remediación. Un ingeniero de soporte podría necesitar el historial de la cuenta, los registros del producto, documentación interna y un borrador de respuesta. Un equipo de producto podría querer un tablero de tareas donde marcar una incidencia como lista para trabajar inicie un flujo de implementación con un alcance definido.
En cada ejemplo, la interfaz es una parte importante de la experiencia. Le indica al agente qué está viendo el usuario, le proporciona las herramientas adecuadas y le da al usuario un lugar para revisar lo que sucede a continuación.
Figura 1. Tu aplicación se encarga del contexto del producto, las reglas de negocio y las herramientas; Codex app-server proporciona el ciclo del agente y la ejecución en sandbox.
Ejemplo: Relay
Creamos Relay como una aplicación de operaciones de ejemplo sobre Codex app-server. Coloca un agente junto a un panel de envíos ficticio, lo conecta a herramientas MCP propias de la aplicación y exige aprobación humana antes de volver a reservar un envío.
El usuario no comienza escribiendo un prompt desde cero. Selecciona un envío y hace clic en una acción como Comparar opciones de recuperación. La aplicación proporciona el contexto relevante, Codex obtiene los datos operativos de ejemplo más recientes, el agente explica las opciones disponibles y cualquier operación de escritura con consecuencias importantes requiere aprobación.
Codex puede entonces usar las herramientas MCP de la aplicación para obtener datos actuales antes de recomendar una acción o, una vez aprobada, llevarla a cabo. Cuando una herramienta cambia el registro subyacente, la aplicación actualiza su vista de negocio. El arnés de ejecución gestiona el ciclo del agente, el estado de la conversación, la actividad transmitida en streaming y la interacción con las herramientas; el producto sigue encargándose de su panel, sus registros y sus controles.
Relay usa datos ficticios precargados, pero el patrón de integración es general. El mismo patrón podría servir para la respuesta a incidentes, las operaciones de cuentas, los flujos de trabajo de investigación u otras aplicaciones en las que un agente deba trabajar dentro de la experiencia de un producto existente.
Figura 2. Relay integra Codex en un panel de operaciones de envíos, con herramientas MCP propias de la aplicación y aprobación humana para acciones con consecuencias importantes.
Lo que crean los desarrolladores
Este patrón ya aparece en implementaciones públicas:
-
GitHub y JetBrains
integran Codex en los flujos de trabajo existentes en el IDE.
-
Cisco
usa el SDK de Codex en App Builder dentro de Cisco Cloud Control.
-
Thrive Holdings y Crete
usan Codex en un flujo de trabajo de preparación de declaraciones de impuestos que incorpora comentarios de profesionales del área. Su prueba piloto procesó 7000 declaraciones y redujo el tiempo de preparación aproximadamente en un tercio.
Estos ejemplos no se limitan a la ingeniería: el mismo patrón se aplica a equipos de soporte que investigan problemas de clientes, equipos de operaciones que coordinan flujos de trabajo, equipos de seguridad que clasifican y priorizan incidentes, equipos de ventas que investigan cuentas y equipos de marketing que desarrollan campañas. En cada caso, la aplicación proporciona el contexto, las herramientas y las aprobaciones, mientras que Codex ejecuta el ciclo subyacente del agente.
Crea más allá de lo evidente
En muchos tipos de trabajo, el contexto esencial se encuentra en un panel, una línea de tiempo, un mapa, un documento o un registro del sistema. Esas vistas no están ahí para verse bonitas: son el medio que las personas realmente usan para comprender lo que sucede, tomar decisiones y mantener el control.
La oportunidad no consiste en reemplazar esas interfaces por una ventana de chat universal, sino en ampliar sus capacidades con un agente que pueda comprender el trabajo, investigar el contexto adecuado, proponer un siguiente paso y llevar a cabo una acción aprobada.
Codex App, la CLI y la extensión para IDE muestran lo que el arnés de ejecución puede hacer. Al publicarlo como código abierto, les damos a los desarrolladores una forma de examinar esas capacidades, integrarlas y adaptarlas a sus propios productos y flujos de trabajo.
Si quieres desarrollar con el arnés de ejecución de Codex, comienza con el repositorio de código abierto de Codex y luego elige la integración que se ajuste a tu producto: codex exec para tareas no interactivas, el SDK de Codex para flujos de trabajo programáticos con agentes o Codex app-server para aplicaciones que necesitan conversaciones persistentes, eventos transmitidos en streaming y gestión de aprobaciones.