Codex Automatización y CI/CD

Codex ofrece múltiples formas de automatización que se pueden usar en scripts, canalizaciones y en el lado del servidor.


Modo no interactivo (exec)

El comando exec se usa para scripts y escenarios de automatización, sin necesidad de abrir la TUI.

Uso básico

Comando exec

# Ejecutar una tarea única
codex exec "Revisar el código y generar un informe"

# Salida a archivo
codex exec -o review.md "Revisar src/auth.py"

# Usar un modelo específico
codex exec -m gpt-5.4-mini "Analizar la estructura del proyecto"

# Ejecución totalmente automática
codex exec --full-auto "Ejecutar pruebas y corregir fallos"

Parámetros comunes

ParámetroDescripción
-mEspecificar modelo
-oEnviar resultado a archivo
--full-autoEjecución totalmente automática
--ephemeralNo guardar archivos de sesión
--jsonFormato de salida JSON Lines
--output-schemaSalida según formato JSON Schema
--sandboxEstablecer modo sandbox

Leer desde la entrada estándar

Entrada stdin

# Leer desde una tubería (pipe)
echo "Explicar este error" | codex exec -

# Leer desde un archivo
codex exec - < task.txt

# Tarea multilínea
cat <<EOF | codex exec -
Analizar src/directorio
Encontrar posibles errores (bugs)
Enviar sugerencias de corrección
EOF

Reanudar sesión

Reanudar ejecución

# Reanudar la sesión más reciente
codex exec resume --last "Continuar corrigiendo errores"

# Reanudar una sesión específica
codex exec resume --session abc123 "Siguiente tarea"

De forma predeterminada, exec se ejecuta en un sandbox de solo lectura y no modifica archivos.


Codex SDK

El SDK de Codex proporciona una interfaz de programación que permite invocar las capacidades del Agente desde el código.

Instalar el SDK

Instalar el SDK

npm install @openai/codex-sdk

Ejemplo de uso

Uso básico del SDK

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

// Crear el cliente de Codex
const codex = new Codex({
  apiKey: process.env.OPENAI_API_KEY
});

// Ejecutar la tarea
const thread = await codex.run({
  prompt: 'Revisar el archivo src/auth.py',
  model: 'gpt-5.4'
});

// Obtener el resultado
console.log(thread.messages);

// Continuar la tarea
const followUp = await codex.run({
  threadId: thread.id,
  prompt: 'Corregir los errores encontrados'
});

Casos de uso del SDK

  • Integración en canalizaciones de CI/CD
  • Crear aplicaciones de Agente personalizadas
  • Automatizar herramientas internas
  • Procesamiento de tareas por lotes

GitHub Action

Oficialmente se proporciona Codex GitHub Action, que permite desencadenar tareas en la canalización de CI.

Flujo de trabajo básico

Ejemplo de GitHub Action

span style="color: green;">
name: Codex Review

on
: [pull_request]

jobs
:
  codex-review
:
    runs-on
: ubuntu-latest
    steps
:
      - uses
: actions/checkout@v4
        with
:
          fetch-depth
: 0

      - name
: Run Codex Review
        uses
: openai/codex-action@v1
        with
:
          prompt-file
: '.github/codex-review.md'
          model
: 'gpt-5.4'
          sandbox
: 'workspace-write'
          output-file
: 'review.md'

      - name
: Post Review
        uses
: actions/github-script@v7
        with
:
          script
: |
           const fs = require('fs');
            const review = fs.readFileSync('review.md', 'utf8');
            github.rest.pulls.createReview({
              owner: context.repo.owner,
              repo: context.repo.repo,
              pull_number: context.issue.number,
              body: review,
              event: 'COMMENT'
            });

Parámetros de Action

ParámetroDescripción
promptEspecificar directamente la descripción de la tarea
prompt-fileEspecificar la ruta del archivo de tarea
modelModelo utilizado
sandboxModo sandbox
output-fileRuta del archivo de salida
codex-argsParámetros CLI adicionales

Configuración de seguridad

Ajustes de seguridad

span style="color: green;">
- name: Run Codex
  uses
: openai/codex-action@v1
  with
:
    prompt
: 'Revisar cambios'
    safety-strategy
: 'drop-sudo'
    unprivileged-user
: 'codex-runner'
    allow-users
: ['maintainers']

Al usar GitHub Action, asegúrese de almacenar la API Key como Secrets y no la codifique directamente.


App Server

App Server expone las capacidades de Codex como una API de servidor.

Iniciar App Server

Iniciar el servicio

# Iniciar App Server
codex app-server

# Especificar el puerto
codex app-server --port 3000

# Acceso remoto
codex --remote ws://server:3000

Casos de uso

  • Capacidades de Codex compartidas por el equipo
  • Llamadas remotas de CI/CD
  • Integración en plataformas internas

MCP Server

Proporcionar Codex como herramienta MCP para que otros Agentes la invoquen.

Configurar Codex MCP

Configuración del servidor MCP

# En la configuración de otros Agentes
[mcp_servers.codex]
command = "codex"
args = ["mcp-server"]

Mejores prácticas

Seguridad

  • Usar el modo sandbox de solo lectura
  • Almacenar la API Key como Secrets
  • Limitar las condiciones de activación (solo eventos específicos)
  • Revisar la salida antes de aplicar los cambios

Fiabilidad

  • Establecer un tiempo de espera razonable
  • Usar --ephemeral para evitar estado residual
  • Verificar que la tarea se haya completado correctamente antes de continuar
  • Manejar la reversión en caso de fallo

Preguntas frecuentes

P: ¿Diferencia entre exec y el modo interactivo?

exec se ejecuta una sola vez y sale, adecuado para automatización; el modo interactivo mantiene una conversación continua.

P: ¿Cómo autenticarse en CI/CD?

Usar la variable de entorno CODEX_API_KEY, almacenada como Secrets.

P: ¿Puede GitHub Action modificar archivos?

Sí, configurando sandbox: workspace-write.

P: ¿Cómo usarlo en Docker?

Instale Codex en la imagen, configure la autenticación y luego invóquelo.

Otras extensiones