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 interfaces son importantes, pero representan solo algunas de las formas en que se puede usar el sistema que tienen en común.
Todas funcionan gracias al arnés de ejecución de código abierto de Codex. Este ayuda a los modelos a recopilar contexto, razonar sobre cómo resolver tareas, usar herramientas, operar dentro de los límites configurados, solicitar aprobación y dar continuidad al trabajo.
Esto amplía las posibilidades para quienes desarrollan software. En lugar de pedirle a cada equipo que traslade su trabajo a un asistente de programación de uso general, puedes integrar el agente en software diseñado para la tarea concreta: un flujo de trabajo de ingeniería, un panel de operaciones, una investigación de seguridad, una consola de atención al cliente o una aplicación interna creada para un equipo especializado.
El ciclo del agente es la parte reutilizable
Para que un agente sea eficaz, hace falta algo más que un prompt y la respuesta de un modelo. El agente necesita entender la tarea, mantener el contexto a lo largo del tiempo, examinar la información pertinente, llamar a herramientas, mostrar el avance, gestionar fallos, solicitar aprobación humana cuando sea necesario y devolver un resultado útil.
El sistema que rodea al agente y le permite hacer todo esto es el arnés de ejecución.
El diseño del arnés de ejecución puede influir considerablemente en los resultados. En ARC-AGI-3, la combinación de dos ajustes, la conservación del razonamiento y la compactación del contexto, elevó la puntuación de GPT-5.6 Sol del 13,3 % al 38,3 % y redujo a una sexta parte la cantidad de tokens de salida.
Creamos el arnés de ejecución de Codex para gestionar el estado de la conversación, transmitir la actividad durante la ejecución, usar herramientas, aplicar las políticas configuradas de sandbox y aprobación, y continuar el trabajo de un turno a otro. Con Codex app-server, ofrecemos estas capacidades mediante un protocolo de cliente documentado. Las aplicaciones pueden crear hilos, iniciar turnos, recibir eventos y gestionar solicitudes de aprobación.
Si desarrollas software que necesita un agente, puedes empezar con Codex sin tener que crear un nuevo entorno de ejecución. Luego puedes decidir de qué se encargará la aplicación que integra el agente.
Un arnés de ejecución abierto que puedes examinar y adaptar
Como el arnés de ejecución es de código abierto, puedes examinar la capa que conecta tu aplicación con el modelo, entender cómo funciona y adaptar la integración a tu producto.
Así puedes controlar los aspectos que permiten adaptar el agente a tu producto:
-
La interfaz. Cada equipo puede conservar sus paneles, editores, colas, mapas, registros y flujos de aprobación sin tener que llevar todas las interacciones a una ventana de chat genérica.
-
El contexto y las herramientas. La aplicación puede dar acceso a los sistemas, documentos, datos y acciones que necesita un flujo de trabajo específico, incluidos sus propios servicios MCP.
-
Los límites operativos. La aplicación que aloja al agente puede decidir dónde se ejecuta, a qué archivos o herramientas puede acceder, qué acciones requieren aprobación, cómo se supervisa el trabajo y cómo se incorporan los resultados al sistema oficial de registro.
Publicamos la CLI de Codex, app-server y el SDK oficial de Codex como componentes de código abierto. En nuestra guía de componentes de código abierto puedes consultar qué componentes están disponibles y dónde encontrar 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 se ofrecen por separado.
Elige la capa de integración adecuada
Puedes elegir cómo integrar Codex según el caso de uso.
-
Para un script, un trabajo de CI o una tarea puntual en segundo plano, codex exec puede ejecutar un flujo de trabajo de alcance definido con un agente y devolver una salida estructurada.
-
Si el código de tu aplicación necesita iniciar o reanudar tareas de Codex, o transmitir su actividad mientras se ejecutan, el SDK oficial de Codex ofrece una interfaz programática directa.
Si quieres 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. Tu aplicación podrá conectarse a un proceso local de Codex, mantener conversaciones abiertas, transmitir eventos a medida que ocurren, interrumpir el trabajo, poner herramientas a disposición del agente y responder a solicitudes de aprobación. El SDK simplifica los flujos de trabajo programáticos habituales. Con app-server, los equipos de producto tienen control directo sobre el ciclo de vida del agente y la experiencia del usuario.
Diseña el software en torno al flujo de trabajo
Más que reproducir Codex App con otro logotipo, lo interesante es crear software que refleje cómo trabaja una persona o un equipo en particular.
Un analista de seguridad podría necesitar una cola de investigaciones, alertas recientes, una lista de los servicios afectados y un paso de aprobación antes de abrir un ticket para corregir el problema. 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, al marcar una incidencia como lista para implementar, se inicie un flujo de implementación con un alcance definido.
En cada ejemplo, la interfaz cumple una función importante. Le indica al agente qué está viendo el usuario, pone a su disposición las herramientas adecuadas y ofrece al usuario un lugar donde revisar lo que sucede a continuación.
Figura 1. Tu aplicación controla el contexto del producto, las reglas de negocio y las herramientas. Codex app-server proporciona el ciclo del agente y la ejecución en un sandbox.
Ejemplo: Relay
Creamos Relay con Codex app-server como ejemplo de una aplicación de operaciones. Relay muestra un agente junto a un panel de envíos ficticios, lo conecta a las herramientas MCP de la aplicación y exige aprobación humana antes de volver a reservar el transporte de un envío.
Para empezar, el usuario selecciona un envío y hace clic en una acción como Comparar opciones de recuperación, sin tener que escribir un prompt desde cero. La aplicación proporciona el contexto pertinente, Codex consulta los datos operativos de ejemplo más recientes y el agente explica las opciones disponibles. Toda operación de escritura que tenga consecuencias importantes requiere aprobación.
Así, Codex puede usar las herramientas MCP de la aplicación para consultar datos actuales antes de recomendar una acción o, una vez aprobada, ejecutarla. Cuando una herramienta modifica el registro, la aplicación actualiza la vista de operaciones. El arnés de ejecución gestiona el ciclo del agente, el estado de la conversación, la transmisión de la actividad en tiempo real y la interacción con las herramientas. El producto sigue a cargo de su panel, sus registros y sus controles.
Relay usa datos ficticios precargados, pero el patrón de integración se puede aplicar de forma general. El mismo patrón podría servir para responder a incidentes, gestionar operaciones de cuentas, apoyar flujos de investigación o desarrollar otras aplicaciones en las que el agente deba trabajar dentro de un producto que ya se usa.
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 las acciones que tienen consecuencias importantes.
Qué están creando los desarrolladores
Ya hay implementaciones públicas que usan este patrón:
-
GitHub y JetBrains integran Codex en los flujos de trabajo que los desarrolladores ya usan en sus 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 preparación de declaraciones de impuestos que incorpora los comentarios de los profesionales que las preparan. En la prueba piloto procesaron 7000 declaraciones y redujeron el tiempo de preparación en alrededor de un tercio.
El patrón también tiene aplicaciones fuera de la ingeniería. Los equipos de soporte pueden usarlo al investigar problemas de clientes, los de operaciones al coordinar flujos de trabajo, los de seguridad al clasificar y priorizar incidentes, los de ventas al investigar cuentas y los de marketing al desarrollar campañas. En cada caso, la aplicación proporciona el contexto, las herramientas y las aprobaciones, mientras Codex se encarga del ciclo del agente.
Crea aplicaciones que vayan más allá de lo evidente
En muchos trabajos, el contexto esencial se encuentra en un panel, una línea de tiempo, un mapa, un documento o un registro del sistema. Estas vistas cumplen una función que va más allá de lo estético. Las personas las usan para entender qué sucede, tomar decisiones y mantener el control.
En lugar de reemplazar esas interfaces con una ventana de chat universal, puedes ampliar sus capacidades al integrar un agente que entienda el trabajo, investigue el contexto pertinente, proponga el siguiente paso y ejecute una acción aprobada.
Codex App, la CLI y la extensión para IDE muestran lo que puede hacer el arnés de ejecución. Al publicar su código, les damos a los desarrolladores la posibilidad 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, empieza por el repositorio de código abierto de Codex. Luego elige la integración que mejor se adapte a tu producto: codex exec para trabajos no interactivos, el SDK de Codex para gestionar flujos de trabajo de agentes desde tu código o Codex app-server para aplicaciones que necesiten mantener conversaciones persistentes, transmitir eventos a medida que ocurren y gestionar aprobaciones.