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
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ámetro | Descripción |
|---|---|
-m | Especificar modelo |
-o | Enviar resultado a archivo |
--full-auto | Ejecución totalmente automática |
--ephemeral | No guardar archivos de sesión |
--json | Formato de salida JSON Lines |
--output-schema | Salida según formato JSON Schema |
--sandbox | Establecer modo sandbox |
Leer desde la entrada estándar
Entrada stdin
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
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
Ejemplo de uso
Uso básico del 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
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ámetro | Descripción |
|---|---|
prompt | Especificar directamente la descripción de la tarea |
prompt-file | Especificar la ruta del archivo de tarea |
model | Modelo utilizado |
sandbox | Modo sandbox |
output-file | Ruta del archivo de salida |
codex-args | Parámetros CLI adicionales |
Configuración de seguridad
Ajustes de seguridad
- 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
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
[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