Automatisation et CI/CD de Codex

Codex propose plusieurs méthodes d'automatisation qui peuvent être utilisées dans des scripts, des pipelines et côté serveur.


Mode non interactif (exec)

La commande exec est utilisée pour les scénarios de script et d'automatisation, sans avoir besoin d'ouvrir la TUI.

Utilisation de base

commande exec

# Exécuter une tâche ponctuelle
codex exec "Examiner le code et produire un rapport"

# Sortie vers un fichier
codex exec -o review.md "Examiner src/auth.py"

# Utiliser un modèle spécifique
codex exec -m gpt-5.4-mini "Analyser la structure du projet"

# Exécution entièrement automatique
codex exec --full-auto "Exécuter les tests et corriger les échecs"

Paramètres communs

ParamètreDescription
-mSpécifier le modèle
-oÉcrire le résultat dans un fichier
--full-autoExécution entièrement automatique
--ephemeralNe pas enregistrer les fichiers de session
--jsonFormat de sortie JSON Lines
--output-schemaSortie selon le format JSON Schema
--sandboxDéfinir le mode bac à sable

Lire depuis l'entrée standard

Entrée stdin

# Lire depuis un pipe
echo "Explique cette erreur" | codex exec -

# Lire depuis un fichier
codex exec - < task.txt

# Tâche multiligne
cat <<EOF | codex exec -
Analyser le répertoire/src
Trouver des bogues potentiels
Afficher des suggestions de correction
EOF

Reprendre la session

Reprendre l'exécution

# Reprendre la session la plus récente
codex exec resume --last "Continuer à corriger les bogues"

# Reprendre une session spécifiée
codex exec resume --session abc123 "Tâche suivante"

Par défaut, exec s'exécute dans un bac à sable en lecture seule et ne modifie pas les fichiers.


SDK Codex

Le SDK Codex fournit une interface de programmation pour invoquer les capacités d'Agent dans le code.

Installer le SDK

Installer le SDK

npm install @openai/codex-sdk

Exemples d’utilisation

Utilisation de base du SDK

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

// Créer Codex
const codex = new Codex({
  apiKey: process.env.OPENAI_API_KEY
});

// Exécuter la tâche
const thread = await codex.run({
  prompt: 'Examiner le fichier src/auth.py',
  model: 'gpt-5.4'
});

// Obtenir le résultat
console.log(thread.messages);

// Continuer la tâche
const followUp = await codex.run({
  threadId: thread.id,
  prompt: 'Fix the discovered bugs'
});

Scénarios d'application du SDK

  • Intégrer dans les pipelines CI/CD
  • Créer des applications Agent personnalisées
  • Automatiser les outils internes
  • Tâches de traitement par lots

GitHub Action

L'action GitHub officielle Codex permet de déclencher des tâches dans les pipelines CI.

Workflow de base

Exemple d'action GitHub

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

on
: [pull_request]

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

      - name
: Exécuter la revue Codex
        uses
: openai/codex-action@v1
        with
:
          prompt-file
: '.github/codex-review.md'
          model
: 'gpt-5.4'
          sandbox
: 'workspace-write'
          output-file
: 'review.md'

      - name
: Publier la revue
        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.repo.repo,
              body: review,
              event: 'COMMENT'
            });

Paramètres de l'action

ParametersDescription
promptSpécifier directement la description de la tâche
prompt-fileSpécifier le chemin du fichier de tâche
modelModèle utilisé
sandboxMode bac à sable
output-fileChemin du fichier de sortie
codex-argsParamètres CLI supplémentaires

Configuration de sécurité

Paramètres de sécurité

span style="color: green;">
- name: Exécuter Codex
  uses
: openai/codex-action@v1
  with
:
    prompt
: 'Examiner les modifications'
    safety-strategy
: 'drop-sudo'
    unprivileged-user
: 'codex-runner'
    allow-users
: ['maintainers']

Lors de l'utilisation de GitHub Action, assurez-vous que la clé API est stockée en tant que Secrets, ne la codez pas en dur.


Serveur d'application

Le serveur d'application expose les capacités de Codex sous forme d'API côté serveur.

Démarrer le serveur d'application

Démarrer le service

# Démarrer le serveur d'application
codex app-server

# Spécifier le port
codex app-server --port 3000

# Accès distant
codex --remote ws://server:3000

Scénarios applicables

  • Partage en équipe des capacités de Codex
  • Invocation CI/CD à distance
  • Intégration dans des plateformes internes

Serveur MCP

Fournir Codex en tant qu'outil MCP que d'autres Agents peuvent appeler.

Configurer Codex MCP

Configuration du serveur MCP

# Dans la configuration d'autres Agents
[mcp_servers.codex]
command = "codex"
args = ["mcp-server"]

Bonnes pratiques

Sécurité

  • Utiliser le mode sandbox en lecture seule
  • Stocker la clé API en tant que Secrets
  • Limiter les conditions de déclenchement (uniquement des événements spécifiques)
  • Vérifier la sortie avant d’appliquer les modifications

Fiabilité

  • Définir un délai d’attente raisonnable
  • Utiliser --ephemeral pour éviter les résidus d’état
  • Vérifier la réussite de la tâche avant de continuer
  • Gérer le rollback en cas d’échec

Questions fréquentes

Q : Quelle est la différence entre le mode exec et le mode interactif ?

exec se termine après une seule exécution, adapté à l’automatisation ; le mode interactif poursuit la conversation.

Q : Comment s’authentifier dans CI/CD ?

Utiliser la variable d’environnement CODEX_API_KEY, stockée dans les Secrets.

Q : GitHub Action peut-il modifier des fichiers ?

Oui, définissez sandbox: workspace-write.

Q : Comment l'utiliser dans Docker ?

Installez Codex dans l'image, configurez l'authentification, puis appelez-le.

Autres extensions