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

# Einfache Aufgaben ausführen
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

# Aus einer Pipe lesen
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

ParameterBeschreibung
exec "任务"Führe die angegebene Aufgabe aus
--stdinAufgaben aus der Standardeingabe lesen
--model, -mModell angeben
--no-auto-approveAutomatische Bestätigung deaktivieren
--output, -oAusgabe in Datei

Vollständiges Beispiel

Vollständiges Parameterbeispiel

# Modell angeben
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

# Standardeinstellungen für den nicht-interaktiven Modus
[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

# Strategie „ask“ verwenden
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

#!/bin/bash

# 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

#!/bin/bash

# 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

#!/bin/bash

# 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

span style="color: green;">
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

span style="color: #0053A6;">
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

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

  • Nutzunggpt-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