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
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
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ètre | Description |
|---|---|
exec "任务" | Exécuter la tâche spécifiée |
--stdin | Lecture des tâches depuis l'entrée standard |
--model, -m | Spécifier le modèle |
--no-auto-approve | Désactiver la confirmation automatique |
--output, -o | Sortie vers un fichier |
Exemple complet
Exemple complet de paramètres
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
[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
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
# 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
# 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
# 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
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
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
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
- Utilisation
gpt-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