Integración con Slack, Linear y SDK: cómo invocar a Codex en otras plataformas e integrarlo en su propio producto

📚 Navegación de la serie: El artículo anterior 〔28 Modo no interactivo codex exec〕 detalló el comando codex exec para ejecutar tareas desatendidas de forma directa, constituyendo la base de la automatización en scripts y CI. Este artículo avanza en dos direcciones: primero, cómo interactuar con Codex directamente desde Slack y Linear mediante menciones simples; segundo, cómo usar el SDK oficial y el App Server para integrar Codex como un componente de software en sus propias aplicaciones. El siguiente artículo 〔30 Cómo elegir el modelo〕 analizará los criterios para seleccionar el modelo adecuado para cada tarea.

ℹ️ Esta es una sección opcional orientada a usuarios avanzados. Si actualmente utiliza Codex únicamente desde la terminal, la App de escritorio o las extensiones de IDE, no requiere implementar este contenido de inmediato. Consúltelo cuando surja la necesidad de gestionar tareas desde los canales de comunicación de su equipo o de integrar las capacidades de Codex en sus propios desarrollos de software.

Comencemos con una conversación adaptada de un caso real para comprender de qué trata este artículo:

Un colega publica una captura de pantalla de un error en un canal de Slack y pregunta: "El endpoint de inicio de sesión devolvió un error 500 otra vez, ¿alguien puede revisarlo?" Sin abrir mi computadora, respondo directamente bajo su mensaje: @Codex revisa el error 500 reportado arriba e identifica la causa en openai/our-backend. A los pocos segundos, Codex reacciona al mensaje con un 👀 y publica un enlace de seguimiento: "Tarea iniciada, un momento". Entro a una reunión. Al salir, Codex ha publicado en el hilo de Slack el diagnóstico del problema junto con un diff de los cambios, incluyendo un enlace directo para abrir el PR.

En este flujo no escribí código, no abrí la terminal e incluso operé sin tener la computadora a la mano. Esto es "invocar a Codex en otras plataformas": desacoplar la herramienta de la terminal local y llevarla a los entornos de comunicación del equipo como Slack y Linear. Por otro lado, la integración con SDK y App Server representa un paso más avanzado: permitirle integrar el motor de Codex dentro de su propio software.

Al terminar de leer este artículo, obtendrás:

• La diferencia entre los dos niveles de integración: invocar a Codex mediante herramientas sin código (Slack/Linear) frente a integrarlo en su software mediante programación (SDK/App Server).
• Cómo configurar e interactuar con @Codex desde Slack, incluyendo cómo selecciona el entorno de ejecución, los repositorios de destino y la gestión de datos en planes Enterprise.
• Cómo asignar incidencias (issues) a Codex en Linear mediante asignaciones o comentarios, y cómo estructurar reglas de triage para la asignación automática de tareas.
• Cómo implementar el Codex SDK (disponible para TypeScript y Python), su proceso de instalación, la sintaxis mínima de uso y sus diferencias con codex exec.
• Qué es el App Server, en qué escenarios es necesario y la recomendación de priorizar el uso del SDK en fases iniciales.
• Un ejercicio práctico completo para ejecutar un programa mínimo utilizando el SDK.

⚠️ Los comandos, nombres de paquetes, variables y comportamientos predeterminados se basan en la documentación oficial de Codex (Slack / Linear / SDK / App Server). Los planes de servicio y modelos de IA son ilustrativos y pueden variar con el tiempo.

---

01 Los dos niveles de integración: invocar sin código o integrar mediante programación

Esta sección aborda herramientas diversas: integraciones con Slack, Linear, SDK y App Server. Las clasificaremos en dos niveles de integración diferenciados para facilitar su análisis:

Analogía: Dos formas de solicitar los servicios de un asistente. El primer nivel consiste en interactuar con el asistente a través de las herramientas de oficina que ya utiliza (Slack, Linear), enviando instrucciones mediante menciones con @ (las integraciones sin código listas para usar provistas por OpenAI). El segundo nivel consiste en incorporar los servicios del asistente dentro de la estructura de su propia empresa y procesos de negocio mediante código (SDK / App Server), convirtiéndolo en un componente de su software.

Clasificación de herramientas:

Nivel	Componente	Acción requerida	Entorno de ejecución
Invocar sin código	Integración con Slack, Integración con Linear	Activar el conector y mencionar @Codex	Tareas en la nube (Codex cloud)
Integrar mediante programación	Codex SDK (TS / Python)	Programar peticiones para controlar a Codex	Su proceso / entorno de CI / servidor
Integrar mediante programación (Bajo nivel)	App Server	Comunicarse mediante protocolo JSON-RPC	Su cliente / producto de software

Un concepto clave de seguridad y arquitectura: las tareas iniciadas desde Slack y Linear se ejecutan como tareas en la nube (Codex cloud, descritas en el artículo [10]). Esto significa que al mencionar a @Codex en Slack, el sistema levanta un contenedor aislado en la nube de OpenAI, clona el repositorio de GitHub asociado y realiza la tarea. Por lo tanto, las integraciones heredan las pautas de configuración de las tareas en la nube (vinculación de cuenta de GitHub, definición de entornos de ejecución y planes de pago compatibles).

Escenarios de uso recomendados:

• "Deseo enviar un reporte de error o requerimiento rápido a Codex sin tener que encender mi computadora para usar la terminal" — use la integración con Slack o Linear.
• "Deseo automatizar un flujo de trabajo de Codex estructurado y ejecutarlo en una tarea de integración continua (CI)" — use el SDK.
• "Deseo construir mi propio cliente de desarrollo o extensión de IDE similar a la extensión oficial de VS Code, gestionando el historial de chats y flujos de eventos" — use el App Server.

💡 Resumen en una frase: Las integraciones con Slack y Linear permiten invocar a Codex sin escribir código (ejecutándose como tareas en la nube), mientras que el SDK y el App Server permiten integrar las capacidades de Codex dentro de su propio software mediante programación.

---

02 Invocar a Codex en Slack: interactuar mediante menciones @Codex

La integración con Slack permite mencionar a @Codex en un canal o hilo de conversación junto con una instrucción, para que Codex ejecute la tarea en la nube y devuelva los resultados en el mismo hilo.

Analogía: Consultar a un colega en un canal común de trabajo. En lugar de acudir a su escritorio para cada consulta, lo menciona en el chat grupal para indicarle el requerimiento. Él procesa la información y publica la respuesta en el mismo canal. Codex opera de la misma forma: usted lo menciona, detalla la tarea y el sistema reporta la conclusión en el hilo de Slack, reteniendo el contexto de la conversación para consultas posteriores.

Configuración de la integración

La integración con Slack requiere completar tres pasos:

1. Configurar el entorno en la nube: la cuenta debe contar con un plan compatible (Plus, Pro, Business, Enterprise o Edu) y tener configurado al menos un entorno de ejecución con su repositorio de GitHub vinculado (los requerimientos de tareas en la nube del artículo [10]).
2. Instalar el conector de Slack: acceda a la sección de conectores en la configuración de Codex e instale la aplicación en su espacio de trabajo de Slack (esto puede requerir aprobación del administrador de su organización).
3. Agregar a @Codex al canal: invite al bot al canal de Slack correspondiente.

Uso y flujos de trabajo

Una vez configurado, el flujo es el siguiente:

1. Mencione a @Codex en un canal o hilo de conversación e ingrese su solicitud. El bot leerá los mensajes anteriores en el hilo para entender el contexto.
2. (Opcional) Especifique el repositorio o entorno de destino en su mensaje, por ejemplo: @Codex corrige el fallo reportado en openai/codex.
3. El bot reaccionará con el emoji 👀 y publicará un enlace de seguimiento. Al finalizar la tarea, reportará las diferencias y el estado de la ejecución en el mismo hilo.

Resolución de entornos y repositorios

Si no especifica el repositorio en el mensaje, Codex aplicará las siguientes reglas para determinar el destino:

• Analiza los entornos activos a los que tiene acceso y selecciona el que mejor se ajuste a la solicitud; si la instrucción es ambigua, tomará el último entorno utilizado.
• La tarea se ejecutará sobre la rama predeterminada del primer repositorio declarado en el mapa de repositorios (repo map) del entorno. Si requiere modificar este comportamiento, actualice el mapa en la configuración de su entorno.
• En caso de no encontrar un repositorio compatible, el bot le indicará el fallo en Slack para que configure el mapa de repositorios correspondiente.

Para evitar ambigüedades en entornos con múltiples proyectos, se recomienda declarar explícitamente el repositorio en la instrucción (ej. ...en openai/our-backend).

Control de datos en planes Enterprise

En organizaciones corporativas, los administradores de la cuenta Enterprise de ChatGPT pueden restringir la exposición de información del código en los canales de comunicación de Slack:

Los administradores de cuentas Enterprise pueden desactivar la opción 'Allow Codex Slack app to post answers on task completion' en el panel de administración. Con esta opción desactivada, Codex se limitará a publicar el enlace de seguimiento de la tarea, omitiendo los detalles del diff en el hilo de Slack.

El flujo de integración con Slack se representa de la siguiente manera:

Este diagrama representa el ciclo de vida de la petición: se inicia con una mención en Slack → el sistema crea el entorno en la nube de OpenAI → se descarga el repositorio de GitHub → el agente procesa la tarea → el resultado final se publica en Slack y se provee un enlace para auditorías.

Ejercicio práctico: Invocar a Codex desde Slack

Requisitos: ser miembro de un espacio de trabajo de Slack con permisos de instalación de aplicaciones, y tener configurado un entorno de tareas en la nube con un repositorio de GitHub vinculado (ver artículo [10]).

Paso 1: Instalar el conector de Slack

Acceda a la pestaña de conectores en la configuración y autorice la aplicación de Slack.

Resultado esperado: la aplicación Codex debe aparecer en el listado de aplicaciones instaladas de su espacio de trabajo de Slack.

Paso 2: Invitar al bot al canal de pruebas

En un canal de pruebas en Slack, escriba @Codex y confirme su incorporación al canal.

Paso 3: Enviar una tarea de prueba

Envíe una instrucción sencilla dirigida a un repositorio de pruebas en el que cuente con permisos de escritura:

@Codex en openai/tu-repositorio-de-pruebas escribe una línea que diga "Hello from Slack" al inicio del archivo README.md. No realices más cambios.

Reemplace openai/tu-repositorio-de-pruebas por la ruta del repositorio configurado en su entorno.

Resultado esperado: el bot reacciona con un 👀, publica la tarjeta con el enlace de la tarea y, tras procesarla en la nube, comparte las diferencias del archivo README.md en el hilo. La aparición del diff y el enlace para abrir el PR confirman el éxito del flujo.

💡 Resumen en una frase: La integración con Slack permite enviar tareas a la nube mediante menciones @Codex en hilos de chat; requiere configurar previamente el entorno de ejecución en la nube y se aconseja declarar el repositorio en la instrucción para evitar ambigüedades.

---

03 Invocar a Codex en Linear: asignar incidencias de desarrollo

La integración con Linear traslada las capacidades de Codex al gestor de proyectos y tareas del equipo. Permite asignar una incidencia (issue) a Codex para que procese el requerimiento de forma autónoma.

Analogía: Asignar una tarea en el tablero de desarrollo. Tal como asigna una tarjeta de requerimiento a un desarrollador en su equipo para que la resuelva y actualice el estado del ticket, usted asigna la incidencia a Codex. El sistema analiza el ticket, ejecuta la tarea en la nube y reporta las actualizaciones en la sección de actividad del ticket, proveyendo los enlaces para el control y aprobación de los cambios.

Esta función se encuentra disponible en planes compatibles y requiere que los administradores de la organización tengan habilitadas las tareas en la nube y el conector Codex for Linear.

Configuración de la integración

1. Configurar el entorno en la nube: vincule su cuenta de GitHub y configure los entornos de ejecución correspondientes.
2. Habilitar el conector: active el conector de Linear en la sección de conectores.
3. Vincular su cuenta de Linear: realice una mención a @Codex en los comentarios de un issue en Linear para iniciar la autenticación de la cuenta.

Métodos de asignación de tareas

Existen dos vías para enviar tareas desde Linear:

• Asignar el issue a Codex: asigne el campo 'Assignee' del ticket a la cuenta de Codex. El sistema iniciará la tarea automáticamente analizando la descripción del issue.
• Mencionar a @Codex en comentarios: publique un comentario mencionando al bot para consultar detalles o solicitar cambios específicos sobre el ticket. El hilo de comentarios mantendrá el historial de la conversación.

Codex determinará el repositorio de destino analizando los metadatos del issue de Linear o recurriendo al último entorno utilizado. Puede forzar el repositorio incluyendo su nombre en el ticket o comentario (ej. @Codex resuelve esto en openai/codex).

La actividad y el estado de la tarea en la nube se reportarán en la sección de Activity del issue de Linear, compartiendo un enlace final con el diff y la propuesta de PR al concluir la tarea.

Automatización de flujos con reglas de triage

Linear permite automatizar la asignación de tickets a Codex mediante reglas en la bandeja de entrada del equipo (Triage):

1. Acceda a la sección de Settings en Linear.
2. Seleccione su equipo en Your teams.
3. En la sección de workflows, active la opción Triage.
4. Cree una regla en Triage rules configurando la acción Delegate dirigida a Codex.

Una vez configurada, las nuevas incidencias que cumplan con los criterios de la regla se asignarán automáticamente a Codex.

IMPORTANT

Al utilizar reglas de triage, Codex ejecutará las tareas en la nube bajo las credenciales del creador del issue, consumiendo los recursos de la cuenta de ese desarrollador.

Integración local con Linear MCP

A diferencia de la integración en la nube, si desea que Codex acceda a los datos de Linear desde su entorno de desarrollo local (terminal, App o extensiones) para resolver tareas locales, debe configurar el Linear MCP server:

codex mcp add linear --url https://mcp.linear.app/mcp

Este comando vincula a Linear como un proveedor de datos para su agente local. También puede configurarlo manualmente en el archivo ~/.codex/config.toml:

[mcp_servers.linear]
url = "https://mcp.linear.app/mcp"

Tras añadirlo, inicie sesión ejecutando codex mcp login linear.

Diferencia de alcances:

• Integración remota en Linear (connector): Codex actúa como un usuario en el sitio web de Linear y ejecuta tareas en contenedores en la nube.
• Linear MCP: su agente local lee incidencias de Linear para resolver tareas en su máquina local.

Comparación de integraciones en la nube:

Característica	Slack Connector	Linear Connector
Activador	Mención @Codex en hilos	Asignación de issue / Comentario @Codex
Flujo automático	No disponible	Reglas de triage para asignación automática
Contexto de entrada	Mensajes del canal e hilo	Título, descripción y comentarios del issue
Destino de salida	Mensaje en hilo de Slack	Actividad e historial del issue
Opción MCP local	No disponible	Linear MCP para lectura en entorno local

La automatización mediante triage en Linear es útil para resolver incidencias menores o reportes de fallos estructurados de forma automática, permitiendo a los desarrolladores concentrarse en la revisión de los PR propuestos por el sistema.

💡 Resumen en una frase: La integración con Linear permite delegar incidencias asignándolas a Codex o comentando con @Codex en el ticket; admite la automatización mediante reglas de triage y se complementa con la opción Linear MCP para permitir a su agente local consultar incidencias de Linear.

---

04 Codex SDK: Integrar Codex en aplicaciones mediante código

El Codex SDK es el conjunto de librerías oficiales que permiten interactuar y controlar el motor de ejecución de Codex desde sus aplicaciones, superando las limitaciones de análisis de texto del comando codex exec.

El SDK le permite gestionar hilos de conversación de forma lógica, recuperar respuestas estructuradas y controlar los privilegios del sandbox desde el código de su aplicación.

La documentación oficial recomienda el uso del SDK en los siguientes escenarios:

• Pipelines y flujos de automatización de CI/CD complejos.
• Construcción de agentes de desarrollo especializados.
• Integración de Codex en herramientas internas de desarrollo corporativas.
• Incorporación de capacidades de asistencia de IA en sus propios productos de software.

Analogía: Controlar un motor mediante un sistema electrónico integrado en lugar de un interruptor manual. El comando codex exec funciona como un interruptor: inicia y detiene el proceso en un solo ciclo. El SDK actúa como una computadora de a bordo que monitorea el estado del motor, inicia hilos de conversación, evalúa resultados intermedios y ajusta el comportamiento del agente dinámicamente según la lógica de su aplicación.

Implementación en TypeScript y Python

El SDK oficial se distribuye para los dos entornos principales de desarrollo:

Característica	TypeScript	Python
Instalación	npm install @openai/codex-sdk	pip install openai-codex
Requisitos	Node.js v18 o superior (Entorno de servidor)	Python v3.10 o superior
Ejecución	Lógica en el servidor de la aplicación	Controla el App Server de Codex local
Estado	Estable	Beta (Usa protocolo JSON-RPC en la capa inferior)

Recomendaciones de instalación:

El SDK de TypeScript está diseñado exclusivamente para ejecución en el servidor de su aplicación; no lo implemente en flujos del lado del cliente en el navegador.

El paquete de Python se distribuye bajo el nombre openai-codex. En fases beta, para asegurar la obtención de las últimas características, use el modificador de pre-lanzamientos: pip install --pre openai-codex.

Ejemplos de código mínimos

Ejemplo en TypeScript: inicialización del cliente, apertura de hilo y ejecución de consulta.

import { Codex } from "@openai/codex-sdk";

const codex = new Codex();
const thread = codex.startThread();
const result = await thread.run(
  "Make a plan to diagnose and fix the CI failures"
);

console.log(result);

Para continuar la conversación en el mismo contexto, realice peticiones consecutivas sobre la instancia del hilo:

// Continuar la conversación en el mismo hilo
const result = await thread.run("Implement the plan");
console.log(result);

// Retomar una conversación previa usando su identificador único
const threadId = "<thread-id>";
const thread2 = codex.resumeThread(threadId);
const result2 = await thread2.run("Pick up where you left off");
console.log(result2);

Ejemplo en Python: implementación síncrona gestionando el ciclo del cliente.

from openai_codex import Codex, Sandbox

with Codex() as codex:
    thread = codex.thread_start(
        model="gpt-5.4",
        sandbox=Sandbox.workspace_write,
    )
    result = thread.run("Make a plan to diagnose and fix the CI failures")
    print(result.final_response)

Implementación asíncrona usando AsyncCodex en Python:

import asyncio
from openai_codex import AsyncCodex

async def main() -> None:
    async with AsyncCodex() as codex:
        thread = await codex.thread_start(model="gpt-5.4")
        result = await thread.run("Implement the plan")
        print(result.final_response)

asyncio.run(main())

Configuración del Sandbox en el SDK

En el SDK de Python, los privilegios de acceso a archivos se configuran mediante el enum Sandbox, pudiendo definirse al iniciar la conversación o modificarse en llamadas individuales:

from openai_codex import Codex, Sandbox

with Codex() as codex:
    thread = codex.thread_start(sandbox=Sandbox.workspace_write)
    thread.run("Make the requested change.")
    # Reducir privilegios a solo lectura para la fase de revisión
    review = thread.run("Review the diff only.", sandbox=Sandbox.read_only)

Niveles de sandbox disponibles:

• Sandbox.read_only: restringe el acceso únicamente a lectura de archivos.
• Sandbox.workspace_write: permite lectura y escritura limitada al área de trabajo del proyecto y directorios autorizados.
• Sandbox.full_access: otorga acceso completo al sistema de archivos local sin restricciones.

Si no se especifica el nivel del sandbox al iniciar el hilo, Codex adoptará el nivel configurado por defecto en la aplicación del App Server local. Las modificaciones de sandbox aplicadas en un paso run() se mantendrán para las interacciones subsiguientes en ese hilo.

Comparativa de flujos de control

Criterio	codex exec (CLI)	Codex SDK
Interfaz	Consola de comandos / Shell	API de programación (Librería)
Integración	Invocación de subprocesos en scripts	Importación directa en código de aplicación
Continuidad	Requiere el subcomando resume	Objeto thread persistente en memoria
Estructuración	Captura de texto o análisis JSONL	Retorno de objetos estructurados nativos
Control de permisos	Argumentos de comando en CLI	Argumentos de sandbox en código por llamada
Caso óptimo	Tareas directas de un solo ciclo en scripts	Lógica compleja, desarrollo de agentes y extensiones

💡 Resumen en una frase: El Codex SDK permite controlar a Codex de forma programática mediante la gestión de objetos thread y niveles de sandbox dinámicos; disponible para TypeScript (@openai/codex-sdk) y Python (openai-codex), siendo la opción recomendada para construir agentes y lógicas complejas de desarrollo.

---

05 App Server: Integración de bajo nivel para clientes interactivos

El App Server de Codex es la infraestructura subyacente que expone los servicios del motor a través del protocolo JSON-RPC, sirviendo como canal de comunicación para clientes enriquecidos como la extensión oficial de VS Code.

Provee servicios de autenticación, control de historial de conversaciones, gestión de notificaciones de aprobación de comandos y transmisión de eventos en tiempo real.

Analogía: Acceder a los puertos físicos de control en lugar de usar un módulo de mandos preensamblado. El SDK actúa como un módulo de mandos listo para conectar; el App Server le brinda acceso a las conexiones del protocolo JSON-RPC de bajo nivel (comunicaciones stdio en formato JSON-RPC 2.0), permitiéndole diseñar una interfaz de usuario a la medida de su aplicación con un control granular de los estados.

Para inicializar el servidor local, ejecute:

codex app-server

La arquitectura del App Server gestiona los estados de la sesión estructurándolos en:

• Thread (Hilo): representa la sesión general de conversación del usuario.
• Turn (Ciclo): representa una iteración de solicitud del usuario y el procesamiento del agente, transmitiendo los eventos de estado de forma incremental.
• Item (Elemento): unidades de entrada/salida como llamadas a herramientas externas, comandos ejecutados o mensajes de estado.

La lógica de comunicación requiere inicializar la conexión, gestionar la creación de los hilos de conversación, y procesar la bitácora de mensajes de eventos JSON-RPC para controlar el estado del agente.

Criterio de selección de herramientas

La documentación oficial limita claramente el alcance de uso del App Server:

Si está diseñando tareas de automatización o ejecutando flujos en la CI, implemente el Codex SDK en su lugar.

Directrices de selección:

• Codex SDK: recomendado para scripts, automatizaciones de desarrollo, tareas en pipelines de CI y construcción de agentes.
• App Server: recomendado únicamente para el desarrollo de extensiones de IDE personalizadas, clientes GUI alternativos o integraciones profundas que requieran interactuar con interfaces gráficas y confirmaciones de usuario.

Para la mayoría de flujos de desarrollo, se aconseja implementar el SDK para evitar la complejidad en la gestión del protocolo de comunicación JSON-RPC del App Server. El código fuente del App Server se encuentra disponible en su repositorio oficial de GitHub como referencia para arquitectos de software.

💡 Resumen en una frase: El App Server expone las capacidades de Codex mediante JSON-RPC sobre stdio para el desarrollo de clientes interactivos (como extensiones de IDE); se recomienda omitir su uso en tareas de automatización y CI en favor del Codex SDK.

---

06 Ejercicio práctico: Implementar un script con el SDK de TypeScript

Estructuraremos un programa de pruebas mínimo utilizando el SDK de TypeScript para validar la inicialización del cliente, la creación de hilos y la captura de resultados en un entorno Node.js.

Requisitos: Node.js versión 18 o superior en su sistema de desarrollo y tener configurado su acceso de terminal a Codex (ver artículo 03).

Paso 1: Crear e inicializar el directorio del proyecto

mkdir codex-sdk-demo
cd codex-sdk-demo
npm init -y

Paso 2: Instalar el paquete de Codex SDK

npm install @openai/codex-sdk

Resultado esperado: el gestor de paquetes de npm descarga el SDK y lo registra en el archivo package.json.

Paso 3: Crear un archivo de datos local

Cree un archivo de texto llamado hello.txt e ingrese una línea de contenido:

This project is a tiny demo for the Codex SDK.

Paso 4: Desarrollar el script de análisis

Cree el archivo run.mjs (el uso de la extensión .mjs habilita el soporte de módulos ES y await en la raíz del archivo) e inserte el siguiente código:

import { Codex } from "@openai/codex-sdk";

const codex = new Codex();
const thread = codex.startThread();
const result = await thread.run(
  "Read hello.txt in the current directory and summarize it in one sentence."
);

console.log(result);

Este script replica el flujo básico: inicializa el cliente new Codex(), crea la conversación con startThread(), y solicita el análisis de hello.txt imprimiendo el resultado en la consola.

Paso 5: Ejecutar el script

Ejecute el programa en su terminal:

node run.mjs

Resultado esperado: la ejecución procesa la solicitud en segundo plano y devuelve en la consola la síntesis del contenido del archivo hello.txt. La correcta impresión de la síntesis confirma que la comunicación con el SDK se realiza con éxito.

Si experimenta problemas de autenticación, valide que su sesión local esté activa ejecutando codex login en su terminal de desarrollo.

Este flujo de TypeScript constituye la base para estructurar análisis de código más complejos, flujos multi-hilo o integraciones personalizadas en sus herramientas internas.

💡 Resumen en una frase: La validación del SDK requiere: inicializar un proyecto Node.js → instalar @openai/codex-sdk → proveer un archivo de prueba → escribir un script mínimo con startThread() y run() → ejecutar con node para validar el retorno estructurado.

---

07 Guía de selección de componentes de integración

Para optimizar su flujo de desarrollo y evitar complejidades innecesarias, aplique los siguientes criterios de selección según su requerimiento de integración:

Requerimiento	Componente recomendado	Razón
Integrar la interacción de desarrollo en los canales de comunicación de su equipo	Slack Connector	Integración sin código; menciones @Codex directas en hilos de chat
Incorporar tareas en los flujos de gestión de proyectos y control de incidencias	Linear Connector	Integración sin código; soporte de asignaciones y asignación automática por triage
Permitir que su agente local lea incidencias de Linear	Linear MCP	MCP local; expone Linear como origen de datos para tareas locales
Automatizar tareas directas de un solo ciclo en scripts de terminal o pipelines de CI	codex exec (CLI)	Estructura ligera; invocación por comandos shell y salida opcional en JSONL
Construir agentes estructurados o integrar Codex en herramientas lógicas internas	Codex SDK	Control programático; soporte para múltiples interacciones por hilo y sandbox dinámico
Diseñar extensiones de IDE alternativas o clientes interactivos con interfaces gráficas	App Server	Protocolo JSON-RPC de bajo nivel; control de bitácoras de eventos y flujos stdio

Recomendaciones prácticas:

• No desarrolle scripts complejos usando el SDK si codex exec es suficiente. Si el requerimiento consiste únicamente en analizar archivos y retornar textos en la CI, un comando shell estructurado con codex exec y --json es más limpio y fácil de mantener.
• Evite implementar el App Server en tareas de automatización o CI. Use el SDK para flujos que no requieran interfaces de usuario interactivas, reduciendo la complejidad del código.
• Combine el uso de herramientas. Puede implementar el conector de Slack para consultas rápidas del equipo y utilizar simultáneamente el SDK de TypeScript para sus pipelines de control de calidad.

Asignar la herramienta adecuada según la complejidad del flujo asegura la estabilidad del sistema y simplifica la estructura de su infraestructura de desarrollo.

💡 Resumen en una frase: Use conectores (Slack/Linear) para flujos sin código, use Linear MCP para lectura local, prefiera codex exec en scripts de consola simples, use el SDK para flujos lógicos estructurados y reserve el App Server únicamente para el desarrollo de extensiones de IDE y clientes interactivos.

---

08 Resumen

Este artículo ha analizado las integraciones de Codex, detallando el uso de conectores corporativos y herramientas de programación para extender el alcance de la asistencia en su flujo de trabajo.

Repasemos los aspectos clave:

Integración	Método de uso	Puntos clave
Conector de Slack	Mención @Codex en hilos de chat	Requiere entorno en la nube, ejecuta tareas en contenedores de OpenAI
Conector de Linear	Asignación de issues y comentarios @	Admite reglas de triage para asignaciones automáticas bajo la cuenta del creador
Linear MCP	codex mcp add linear	Permite al agente local consultar incidencias de Linear en su máquina
Codex SDK	Librería de programación	TS (@openai/codex-sdk) y Python (openai-codex), permite hilos multi-turno
Control del Sandbox	Parámetros del SDK	Permite ajustar niveles de sandbox (read_only, workspace_write) por llamada
App Server	Protocolo JSON-RPC	Interfaz stdio de bajo nivel para clientes gráficos y extensiones de IDE

Llevar a Codex a los entornos compartidos del equipo e integrarlo de forma programática en sus herramientas de software expande las posibilidades de automatización, facilitando la colaboración en el desarrollo de sus proyectos.

---

El siguiente artículo 30 · Cómo elegir el modelo: analizaremos detalladamente los modelos de lenguaje disponibles en Codex, comparando el rendimiento y consumo de recursos entre modelos de alta velocidad frente a modelos de razonamiento avanzado, y cómo configurar estas opciones para optimizar sus flujos de trabajo.

---

Lecturas recomendadas

• Uso de MCP para integrar utilidades y APIs locales
• Revisiones de código asistidas en GitHub Actions
• Estructura del archivo de configuración config.toml