Codex nicht-interaktiver Modus
Der nicht-interaktive Modus ermöglicht die Verwendung von Codex in Skripten, CI/CD-Pipelines oder Headless-Umgebungen. Dieser Abschnitt beschreibt, wie der nicht-interaktive Modus konfiguriert und verwendet wird.
Grundlegende Verwendung
Eine einzelne Aufgabe ausführen
Grundlegender exec-Befehl
codex exec "Liste Python-Dateien im aktuellen Verzeichnis auf"
# Doppelte Anführungszeichen für komplexe Befehle verwenden
codex exec "Analysiere die Codestruktur des Verzeichnisses src/"
Von der Standardeingabe lesen
stdin-Eingabe
echo "Erkläre diesen Code" | codex exec --stdin
# Aus einer Datei lesen
codex exec --stdin < task.txt
# Mehrzeilige Eingabe
cat <<EOF | codex exec --stdin
Erstelle eine Funktion zur Berechnung der Fakultät
Teste diese Funktion
EOF
Der nicht-interaktive Modus ist ideal für automatisierte Aufgaben und Skriptintegration.
Kommandozeilenargumente
Häufige Parameter
| Parameter | Beschreibung |
|---|---|
exec "任务" | Führe die angegebene Aufgabe aus |
--stdin | Aufgaben aus der Standardeingabe lesen |
--model, -m | Modell angeben |
--no-auto-approve | Automatische Bestätigung deaktivieren |
--output, -o | Ausgabe in Datei |
Vollständiges Beispiel
Vollständiges Parameterbeispiel
codex exec -m gpt-5.4-mini "Code überprüfen"
# In Datei ausgeben
codex exec "README erstellen" -o README.md
# Automatische Bestätigung deaktivieren
codex exec --no-auto-approve "Tests ausführen"
# Kombinierte Verwendung
codex exec -m gpt-5.4 "PR überprüfen" --output review.md
Konfiguration
Einstellungen der Konfigurationsdatei
Nicht-interaktiven Modus konfigurieren
[exec]
# Standardmodell
default_model = "gpt-5.4"
# Schwellenwert für automatische Genehmigung
auto_approve_threshold = "medium"
# Timeout (Sekunden)
timeout = 300
Ausführungsstrategie
Im nicht-interaktiven Modus ist die Standardrichtlinie normalerweisedeny(Ablehnung von Operationen, die Seiteneffekte haben können):
Ausführungsrichtlinie festlegen
codex exec --approval ask "Datei erstellen"
# Strategie „approve“ verwenden (mit Vorsicht verwenden)
codex exec --approval approve "Tests ausführen"
# Deny-Strategie verwenden (schreibgeschützt)
codex exec --approval deny "Code analysieren"
Aus Sicherheitsgründen sind Vorgänge, die Seiteneffekte haben können, im nicht-interaktiven Modus standardmäßig deaktiviert.
Shell-Skript-Integration
Einfaches Skript
Shell-Skript-Beispiel
# Codex für Code-Review verwenden
codex exec Code im Verzeichnis src/ überprüfen --output review.md
if [ $? -eq 0 ]; then
echo Überprüfung abgeschlossen, Ergebnisse in review.md gespeichert
else
echo Überprüfung fehlgeschlagen
fi
Stapelverarbeitung
Stapelverarbeitungsskript
# Mehrere Dateien im Stapel überprüfen
for file in $(find src -name "*.py"); do
echo Überprüfung:$file"
codex exec Review$fileFile --output "review_$(basename $file).md"
done
Bedingte Ausführung
Bedingte Ausführung
# Entscheide anhand der Anzahl der Dateien, ob Codex verwendet werden soll
FILE_COUNT=$(find src -name "*.py" | wc -l)
if [ $FILE_COUNT -gt 10 ]; then
echo Es gibt viele Dateien, verwenden Sie Codex für die Batch-Überprüfung
codex exec Alle Python-Dateien überprüfen --output full_review.md
else
echo Es gibt nur wenige Dateien, überprüfen Sie sie einzeln
for file in $(find src -name "*.py"); do
codex exec Einfache Überprüfung$file"
done
fi
CI/CD-Integration
GitHub Actions
GitHub Actions Workflow
name: Code-Überprüfung
on: [pull_request]
jobs:
codex-review:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4
- name: Codex einrichten
uses: openai/codex-action@v1
- name: Code-Überprüfung ausführen
run: |
codex exec "Codeänderungen in diesem PR überprüfen" \
--output review.md
- name: Review hochladen
uses: actions/upload-artifact@v4
with:
name: code-review
path: review.md
GitLab CI
GitLab-CI-Konfiguration
codex_review:
image: node:20
before_script:
- npm install -g @openai/codex
script:
- codex exec "Änderungen in diesem Merge Request überprüfen" --output review.md
artifacts:
paths:
- review.md
Jenkins
Jenkins-Pipeline
agent any
stages {
stage('Code Review') {
steps {
sh 'codex exec "Geänderte Dateien überprüfen" --output review.md'
}
}
}
post {
always {
archiveArtifacts 'review.md'
}
}
}
Die Integration von Codex in CI/CD-Workflows ermöglicht automatisierte Code-Reviews und Qualitätsprüfungen.
Best Practices
Ausgabeverarbeitung
- Nutzung
--outputErgebnisse in eine Datei speichern - Rückgabecode prüfen, um festzustellen, ob die Ausführung erfolgreich war
- Mögliche Fehlerfälle behandeln
Leistungsoptimierung
- Nutzung
gpt-5.4-miniKosten senken - Stapelverarbeitung mehrerer Aufgaben
- Ein angemessenes Timeout festlegen
Sicherheit
- Nicht verwenden
--approval approve - Verwendung des schreibgeschützten Modus in CI/CD
- API-Schlüssel schützen
Achten Sie bei der Verwendung des nicht-interaktiven Modus in Produktionsumgebungen besonders auf Sicherheitsaspekte.
FAQ
F: Unterstützt der nicht-interaktive Modus alle Funktionen?
Die meisten Funktionen werden unterstützt, aber einige Funktionen, die eine interaktive Bestätigung erfordern, sind möglicherweise nicht verfügbar.
F: Wie werden Vorgänge behandelt, die eine Bestätigung erfordern?
Nutzung--no-auto-approveParameter oder legen Sie die Ausführungsrichtlinie in der Konfigurationsdatei fest.
F: Kann das Ausgabeformat angepasst werden?
Derzeit werden Klartextausgabe und Markdown-Ausgabe unterstützt.
F: Wie verwendet man es in Docker?
Installieren Sie Codex in einem Docker-Image und rufen Sie es dann im CI/CD-Workflow auf.
Weitere Erweiterungen