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

Lokale Umgebungen

Konfiguriere häufig verwendete Aktionen und Setup-Skripte für Worktrees

In einer lokalen Umgebung legst du fest, wie Codex Worktrees einrichtet und welche Aktionen dir für häufige Aufgaben im Projekt zur Verfügung stehen.

Lokale Umgebungen sind nur in Codex in der ChatGPT-Desktop-App verfügbar. Wähle Codex aus, bevor du eine lokale Umgebung konfigurierst oder verwendest.

Du konfigurierst deine lokalen Umgebungen in den Einstellungen der ChatGPT-Desktop-App. Damit andere die Konfiguration nutzen können, kannst du die generierte Datei in das Git-Repository deines Projekts einchecken.

Codex speichert diese Konfiguration im Ordner .codex im Stammverzeichnis deines Projekts. Wenn dein Repository mehrere Projekte enthält, öffne das Projektverzeichnis mit dem gemeinsamen Ordner .codex.

Setup-Skripte

Worktrees verwenden andere Verzeichnisse als deine lokalen Chats. Deshalb ist dein Projekt im Worktree möglicherweise noch nicht vollständig eingerichtet. Es können Abhängigkeiten fehlen oder Dateien, die du nicht in dein Repository eingecheckt hast. Setup-Skripte werden automatisch ausgeführt, wenn Codex zu Beginn eines neuen Chats einen neuen Worktree erstellt.

Mit einem Setup-Skript kannst du alle Befehle ausführen, die du zum Einrichten deiner Umgebung brauchst. So kannst du etwa Abhängigkeiten installieren oder einen Build starten.

Für ein TypeScript-Projekt kannst du beispielsweise mit diesem Setup-Skript die Abhängigkeiten installieren und einen ersten Build ausführen:

npm install
npm run build

Wenn das Setup vom Betriebssystem abhängt, kannst du für macOS, Windows oder Linux ein eigenes Setup-Skript definieren. Es ersetzt auf der jeweiligen Plattform das Standardskript.

Aktionen

Lege Aktionen für häufige Aufgaben fest, etwa um den Entwicklungsserver deiner App zu starten oder deine Testsuite auszuführen. Über die obere Leiste der ChatGPT-Desktop-App kannst du schnell auf diese Aktionen zugreifen. Sie werden im integrierten Terminal der App ausgeführt.

Mit Aktionen sparst du dir die wiederholte Eingabe derselben Befehle, etwa wenn du einen Build für dein Projekt auslöst oder einen Entwicklungsserver startest. Wenn du nur kurz einen Fehler untersuchen möchtest, kannst du das integrierte Terminal direkt verwenden.

Für ein Node.js-Projekt kannst du beispielsweise eine Aktion namens „Ausführen“ mit folgendem Skript erstellen:

npm start

Wenn deine Aktion je nach Betriebssystem unterschiedliche Befehle benötigt, definiere separate Skripte für macOS, Windows und Linux.

Wähle für jede Aktion ein passendes Symbol, damit du sie leicht erkennst.

Integrierte Git-Werkzeuge verwenden

In Codex findest du in der ChatGPT-Desktop-App neben jedem lokalen Projekt und jedem Worktree die gängigen Git-Funktionen. Der Diff-Bereich zeigt die Änderungen in deiner aktuellen Arbeitskopie. Dort kannst du einzelne Codezeilen kommentieren, damit Codex deine Anmerkungen aufgreift. Du kannst einzelne Änderungsblöcke oder ganze Dateien für den Commit vormerken oder die jeweiligen Änderungen rückgängig machen. Direkt in der App kannst du auch Änderungen committen, einen Branch pushen und einen Pull Request erstellen.

Verwende das integrierte Terminal für Git-Operationen, die in der App nicht direkt verfügbar sind. Wenn du parallele Änderungen von deiner lokalen Arbeitskopie trennen möchtest, starte die Aufgabe in einem Worktree.