Den vollständigen Index der Dokumentation findest du in llms.txt. Die Markdown-Version einer Dokumentationsseite erhältst du, indem du .md an die URL der Seite anhängst.
Hauptnavigation
Design

Codex Cloud (Legacy)

Konfiguriere Legacy-Umgebungen für Code Review und die Integrationen mit Linear und GitHub

Codex Cloud (Legacy) unterstützt weiterhin Umgebungen für Code Review und die Integrationen mit Linear und GitHub.

Wie du Cloud-Umgebungen in der aktuellen Version im Web, auf Mobilgeräten und auf dem Desktop verwendest, erfährst du im Leitfaden zu Cloud-Umgebungen.

Mit Umgebungen legst du fest, was Codex während eines Cloud-Chats installiert und ausführt. Du kannst zum Beispiel Abhängigkeiten hinzufügen, Tools wie Linter und Formatierer installieren und Umgebungsvariablen setzen.

Konfiguriere deine Umgebungen in den Codex-Einstellungen.

So laufen Cloud-Chats in Codex ab

Wenn du eine Aufgabe einreichst, läuft sie wie folgt ab:

  1. Codex erstellt einen Container und checkt in deinem Repository den ausgewählten Branch oder den durch den SHA-Hash angegebenen Commit aus.
  2. Codex führt dein Setup-Skript aus. Wenn Codex einen zwischengespeicherten Container wieder aufnimmt, führt es außerdem das optionale Wartungsskript aus.
  3. Codex wendet deine Einstellungen für den Internetzugriff an. Setup-Skripte laufen mit Internetzugriff. Für den Agenten ist der Internetzugriff standardmäßig deaktiviert. Bei Bedarf kannst du ihm eingeschränkten oder uneingeschränkten Zugriff gewähren. Mehr dazu erfährst du im Abschnitt Internetzugriff für den Agenten.
  4. Der Agent führt in einer Schleife Terminalbefehle aus. Er bearbeitet Code, führt Prüfungen aus und versucht, seine Änderungen zu validieren. Enthält dein Repository die Datei AGENTS.md, sucht der Agent darin nach projektspezifischen Befehlen für Linting und Tests.
  5. Sobald der Agent fertig ist, zeigt er seine Antwort und ein Diff aller Dateien an, die er geändert hat. Du kannst einen Pull Request öffnen oder Rückfragen stellen.

Das Standard-Image universal

Der Codex-Agent läuft standardmäßig in einem Container-Image namens universal. Darin sind gängige Programmiersprachen, Pakete und Tools bereits installiert.

Wähle in den Umgebungseinstellungen Paketversionen festlegen, um die Versionen von Python, Node.js und anderen Laufzeitumgebungen festzuschreiben.

Unter openai/codex-universal findest du Details zu den vorinstallierten Komponenten, ein Dockerfile als Referenz und ein Image, das du lokal herunterladen und testen kannst.

In codex-universal sind Programmiersprachen vorinstalliert, damit du schnell und unkompliziert loslegen kannst. Mit Setup-Skripten kannst du weitere Pakete im Container installieren.

Umgebungsvariablen und Secrets

Umgebungsvariablen gelten für die gesamte Dauer des Chats, also auch während der Ausführung der Setup-Skripte und in der Agentenphase.

Secrets ähneln Umgebungsvariablen, unterscheiden sich aber in zwei Punkten:

  • Eine zusätzliche Verschlüsselung schützt sie bei der Speicherung. Sie werden nur zur Ausführung der Aufgabe entschlüsselt.
  • Nur Setup-Skripte haben Zugriff darauf. Aus Sicherheitsgründen entfernt Codex die Secrets vor Beginn der Agentenphase.

Automatisches Setup

Wenn dein Projekt einen gängigen Paketmanager verwendet (npm, yarn, pnpm, pip, pipenv oder poetry), kann Codex Abhängigkeiten und Tools automatisch installieren.

Manuelles Setup

Wenn deine Entwicklungsumgebung ein aufwendigeres Setup erfordert, kannst du ein eigenes Setup-Skript angeben. Zum Beispiel:

# Install type checker
pip install pyright

# Install dependencies
poetry install --with test
pnpm install

Setup-Skripte laufen in einer eigenen Bash-Sitzung. Deshalb wirken sich Befehle wie export nicht auf die spätere Agentenphase aus. Damit Umgebungsvariablen auch dann verfügbar sind, füge sie zu ~/.bashrc hinzu oder konfiguriere sie in den Umgebungseinstellungen.

Container im Cache speichern

Codex speichert den Zustand eines Containers bis zu 12 Stunden im Cache. So können neue Chats und Folgeanfragen schneller starten.

Wenn Codex eine Umgebung im Cache speichert, geschieht Folgendes:

  • Codex klont das Repository und checkt den Standard-Branch aus.
  • Codex führt das Setup-Skript aus und speichert den daraus resultierenden Containerzustand im Cache.

Wenn Codex einen Container aus dem Cache wieder aufnimmt, geschieht Folgendes:

  • Codex checkt den für den Chat angegebenen Branch aus.
  • Codex führt das Wartungsskript aus, sofern du eines angegeben hast. Das ist hilfreich, wenn das Setup-Skript auf einem älteren Commit lief und Abhängigkeiten aktualisiert werden müssen.

Wenn du das Setup-Skript, das Wartungsskript, die Umgebungsvariablen oder die Secrets änderst, erklärt Codex den Cache automatisch für ungültig. Wenn Änderungen in deinem Repository mit dem zwischengespeicherten Zustand inkompatibel sind, wähle auf der Umgebungsseite Cache zurücksetzen.

Bei Business und Enterprise teilen sich alle, die Zugriff auf eine Umgebung haben, deren Cache. Wenn du den Cache für ungültig erklärst, betrifft das alle in deinem Workspace, die diese Umgebung nutzen.

Internetzugriff und Netzwerkproxy

Während der Ausführung des Setup-Skripts ist der Internetzugriff verfügbar, damit das Skript Abhängigkeiten installieren kann. In der Agentenphase ist der Internetzugriff standardmäßig deaktiviert. Du kannst jedoch eingeschränkten oder uneingeschränkten Zugriff konfigurieren. Mehr dazu erfährst du im Abschnitt Internetzugriff für den Agenten.

Aus Sicherheitsgründen und zum Schutz vor Missbrauch laufen die Umgebungen hinter einem HTTP/HTTPS-Netzwerkproxy. Der gesamte ausgehende Internetverkehr läuft über diesen Proxy.

Vorgaben von Agent Security für den Netzwerkzugriff von Befehlen

Wenn dein Workspace den Netzwerkzugriff von Befehlen über Agent Security verwaltet, prüfe sowohl die Interneteinstellungen der Umgebung als auch die verwaltete Richtlinie. Wie sich diese Vorgaben auf Befehle auswirken, erfährst du im Abschnitt Netzwerkisolation.