Mode non interactif de Codex

Le mode non interactif vous permet d'utiliser Codex dans des scripts, des pipelines CI/CD ou des environnements sans interface graphique. Cette section détaille comment configurer et utiliser le mode non interactif.


Utilisation de base

Exécuter une tâche unique

Commande exec de base

# Exécuter des tâches simples
codex exec "Lister les fichiers Python dans le répertoire courant"

# Utiliser des guillemets doubles pour les commandes complexes
codex exec "Analyser la structure du code du répertoire src/"

Lire depuis l'entrée standard

Entrée stdin

# Lire depuis un pipe
echo "Expliquez ce code" | codex exec --stdin

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

# Entrée multiligne
cat <<EOF | codex exec --stdin
Créez une fonction pour calculer la factorielle
Testez cette fonction
EOF
Le mode non interactif est idéal pour les tâches automatisées et l'intégration de scripts.

Arguments de ligne de commande

Paramètres courants

ParamètreDescription
exec "任务"Exécuter la tâche spécifiée
--stdinLecture des tâches depuis l'entrée standard
--model, -mSpécifier le modèle
--no-auto-approveDésactiver la confirmation automatique
--output, -oSortie vers un fichier

Exemple complet

Exemple complet de paramètres

# Spécifier le modèle
codex exec -m gpt-5.4-mini "Revoir le code"

# Sortie vers un fichier
codex exec "Créer README" -o README.md

# Désactiver la confirmation automatique
codex exec --no-auto-approve "Lancer les tests"

# Utilisation combinée
codex exec -m gpt-5.4 "Revoir la PR" --output review.md

Configuration

Paramètres du fichier de configuration

Configurer le mode non interactif

# Paramètres par défaut du mode non interactif
[exec]
# Modèle par défaut
default_model = "gpt-5.4"

# Seuil d'approbation automatique
auto_approve_threshold = "medium"

# Délai d'attente (secondes)
timeout = 300

Stratégie d'exécution

En mode non interactif, la politique par défaut est généralementdeny(rejetant les opérations pouvant avoir des effets de bord) :

Définir la politique d'exécution

# Utiliser la stratégie ask
codex exec --approval ask "Créer un fichier"

# Utiliser la stratégie approve (à utiliser avec prudence)
codex exec --approval approve "Exécuter les tests"

# Utiliser la stratégie deny (lecture seule)
codex exec --approval deny "Analyser le code"
Pour des raisons de sécurité, les opérations susceptibles d'avoir des effets de bord sont désactivées par défaut en mode non interactif.

Intégration de scripts shell

Script de base

Exemple de script shell

#!/bin/bash

# Utilisation de Codex pour la revue de code
codex exec Examiner le code dans le répertoire src/ --output review.md

if [ $? -eq 0 ]; then
    echo Revue terminée, résultats enregistrés dans review.md
else
    echo Échec de la revue
fi

Traitement par lots

Script de traitement par lots

#!/bin/bash

# Examiner plusieurs fichiers par lots
for file in $(find src -name "*.py"); do
    echo Revue :$file"
    codex exec Revue$fileFichier --output "review_$(basename $file).md"
done

Exécution conditionnelle

Exécution conditionnelle

#!/bin/bash

# Décider d'utiliser Codex en fonction du nombre de fichiers
FILE_COUNT=$(find src -name "*.py" | wc -l)

if [ $FILE_COUNT -gt 10 ]; then
    echo Il y a beaucoup de fichiers, utilisez Codex pour une revue par lots
    codex exec Passer en revue tous les fichiers Python --output full_review.md
else
    echo Il y a peu de fichiers, passez-les en revue un par un
    for file in $(find src -name "*.py"); do
        codex exec Revue simple$file"
    done
fi

Intégration CI/CD

GitHub Actions

Flux de travail GitHub Actions

span style="color: green;">
name: Revue de code

on
: [pull_request]

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

      - name
: Configurer Codex
        uses
: openai/codex-action@v1

      - name
: Lancer la revue de code
        run
: |
         codex exec "Passez en revue les modifications de code dans cette PR" \
            --output review.md

      - name
: Téléverser la revue
        uses
: actions/upload-artifact@v4
        with
:
          name
: code-review
          path
: review.md

GitLab CI

Configuration GitLab CI

span style="color: #0053A6;">
codex_review:
  image
: node:20
  before_script
:
   - npm install -g @openai/codex
  script
:
   - codex exec "Examiner les modifications dans cette demande de fusion" --output review.md
  artefacts
:
    chemins
:
     - review.md

Jenkins

Pipeline Jenkins

pipeline {
    agent any

    stages {
        stage('Revue de code') {
            steps {
                sh 'codex exec "Examiner les fichiers modifiés" --output review.md'
            }
        }
    }

    post {
        toujours {
            archiveArtifacts 'review.md'
        }
    }
}
L'intégration de Codex dans les workflows CI/CD permet une revue de code automatisée et des contrôles qualité.

Bonnes pratiques

Traitement de la sortie

  • Utilisation--outputEnregistrer les résultats dans un fichier
  • Vérifier le code de retour pour déterminer si l'exécution a réussi
  • Gérer les cas d'erreur possibles

Optimisation des performances

  • Utilisationgpt-5.4-miniRéduire les coûts
  • Traitement par lots de plusieurs tâches
  • Définir un délai d’attente raisonnable

Sécurité

  • Éviter d'utiliser--approval approve
  • Utiliser le mode lecture seule dans CI/CD
  • Protéger les clés API
Lorsque vous utilisez le mode non interactif dans des environnements de production, prêtez une attention particulière aux problèmes de sécurité.

FAQ

Q : Le mode non interactif prend-il en charge toutes les fonctionnalités ?

La plupart des fonctionnalités sont prises en charge, mais certaines fonctionnalités nécessitant une confirmation interactive peuvent ne pas être disponibles.

Q : Comment sont gérées les opérations qui nécessitent une confirmation ?

Utilisation--no-auto-approveparamètre, ou définissez la politique d'exécution dans le fichier de configuration.

Q : Le format de sortie peut-il être personnalisé ?

La sortie en texte brut et la sortie Markdown sont actuellement prises en charge.

Q : Comment l'utiliser dans Docker ?

Installez Codex dans une image Docker, puis invoquez-le dans le workflow CI/CD.

autres extensions