Codex Worktrees: verwaltete Git Worktrees, Schritt für Schritt
Aktiviere das Worktrees-Feature, führe einen Chat in einem verwalteten Git Worktree aus, mach mit Work here daraus einen Branch und starte codex --worktree direkt aus dem Terminal — 10 Schritte aus einer sauberen Bildschirmaufnahme.
TL;DR
- Ein Git Worktree ist ein zweiter Checkout desselben Repos — jeder Worktree hat eigene Dateien, teilt sich aber den .git-Ordner, sodass parallele Codex-Chats sich nie gegenseitig überschreiben.
- Worktrees liegen hinter einem Feature-Flag: Führe codex features enable worktrees in einem Terminal aus, starte die App neu, und die Option New local worktree erscheint im Composer.
- Aus einem fertigen Worktree wird in zwei Klicks ein Branch — Create branch nennt ihn codex/your-branch, dann pusht das Commit-Sheet, und du öffnest die PR, ohne den Worktree zu verlassen.
- Verwaltete Worktrees liegen in $CODEX_HOME/worktrees als Ordner mit Hash-Namen. Codex behält die 15 jüngsten, sichert vor dem Aufräumen einen Snapshot und kann ihn aus dem Chat wiederherstellen. Die Create-/List-Tools kamen mit Codex 0.162.0.
Codex Worktrees: The Best Feature Most Developers Ignore
Kanal:Software Engineer Meets AI4:56
Worktrees — official Codex documentation
Doku:developers.openai.com/codex
Die Frames stammen aus einer sauberen Bildschirmaufnahme; Befehle und UI-Labels wurden mit der offiziellen Codex-Worktrees-Doku abgeglichen. Die Tools für verwaltete Worktrees kamen in Codex 0.162.0 (Oktober 2026): "Add tools for creating and listing managed Git worktrees from trusted local projects when the worktrees feature is enabled."
Das Video bleibt Eigentum seines Creators und ist zum Zweck der Quellenangabe verlinkt. Produktnamen und Interface-Elemente gehören OpenAI.
Wie Codex Worktrees funktionieren, Schritt für Schritt
Worktrees aktivieren und einen starten
- 1
Weiß, was ein Worktree ist, bevor du irgendwas aktivierst
Ein Git Worktree ist ein vollständiger zweiter Checkout deines Repos in seinem eigenen Ordner — jeder Worktree hat von jeder Datei seine eigene Kopie, aber alle teilen dieselben .git-Metadaten. Deshalb können mehrere parallele Codex-Chats je in ihrem eigenen Ordner arbeiten, ohne über die uncommitteten Änderungen des anderen zu stolpern. Worktrees sind ein ganz gewöhnliches Git-Feature; Codex automatisiert nur die Eskimotage drumherum.
Die Aufnahme eröffnet mit der Ein-Satz-Definition: mehrere Branches eines Repos, gleichzeitig in verschiedene Ordner gecheckoutet.Bei 0:28 ansehen - 2
Das Worktrees-Feature einmalig aktivieren
Worktrees sind in Codex noch hinter einem Gate, also passiert der erste Schritt im Terminal. Wie in der Aufnahme gezeigt, öffnet der Presenter das eingebaute Terminal der App und führt codex features enable worktrees aus, was den Flag in config.toml umlegt — danach startet er die Anwendung neu. Nach dem Neustart erscheint die Option New local worktree im Composer.
Die Codex-App mit geöffnetem Terminal-Panel unter dem Composer — genau dort läuft der Aktivierungsbefehl vor dem Neustart.Bei 1:58 ansehen - 3
Einen Chat auf einem New local worktree starten
In einem neuen Chat lauten die Composer-Chips: Projektname, New local worktree, No environment, main — der Worktree-Modus und der Branch, von dem der Worktree startet. Lass New local worktree ausgewählt und main als Start-Branch, tippe deine Aufgabe (in der Aufnahme "change the background color to be blue") und sende ab.
Der Composer mit ausgewähltem New local worktree und main, während der Prompt getippt wird.Bei 3:00 ansehen - 4
Den Agenten in seinem Worktree arbeiten lassen
Codex antwortet "Worktree created" und arbeitet im isolierten Kopie — im Thread sieht man, wie es npm run type-check && git diff --check laufen lässt, während du die App weiter für andere Chats nutzt. Dein Haupt-Checkout bleibt unangetastet, und der Changes-Zähler (+2 -2 in der Aufnahme) verfolgt, was der Agent im Worktree editiert.
Der Thread-Header zeigt Worktree created, während der Agent type-check und diff im Worktree laufen lässt.Bei 3:17 ansehen
Aus dem Worktree Branch und PR machen
- 5
Finde heraus, wo Codex die Worktrees aufbewahrt
Verwaltete Worktrees werden nicht neben dein Projekt geworfen. Die offizielle Doku verortet sie in $CODEX_HOME/worktrees, und die Aufnahme bestätigt es: Nach cd in .codex/worktrees druckt ls einen Hash-Ordner pro Worktree (09bd, 09ec, 7b3a, d021, dd4e). Das Root verlegst du in Settings > Worktrees über die Einstellung Worktree root.
Terminal in .codex/worktrees listet fünf Worktree-Ordner mit Hash-Namen.Bei 3:41 ansehen - 6
Das Thread-Menü öffnen und einen Branch erstellen
Ein neuer Worktree startet detached — Codex erstellt ihn ohne angehängten Branch. Um die Arbeit zu behalten, öffne das Environment-Menü am Thread: Changes (+2 -2), Worktree, Create branch, Commit or push und Create pull request. Create branch ist die Aktion, die aus diesem Ordner einen echten, benannten Branch macht.
Das Environment-Menü des Threads mit Changes, Worktree, Create branch, Commit or push und Create pull request.Bei 3:25 ansehen - 7
Den Branch im Work-here-Dialog bestätigen
Create branch öffnet den Work-here-Dialog: "Create a branch to commit changes, push, and create a PR from this worktree." Das Feld Branch name ist mit dem Präfix codex/ vorbelegt — codex/change-background-color in der Aufnahme — klicke auf Create, und der Branch hängt sich an den Worktree. Git erlaubt einen Branch nur in genau einem Worktree gleichzeitig, und genau deshalb führt Codex dieses Paar für dich mit.
Work-here-Dialog mit dem vorbelegten Branchnamen codex/change-background-color und dem Create-Button.Bei 3:52 ansehen - 8
Aus dem Worktree committen und pushen
Zurück im Thread öffnet Commit or push ein Commit-Sheet auf dem Branch codex/change-background-color: Tippe eine Nachricht, lasse Include unstaged changes angehakt (+2 -2) und wähle Commit, Commit and push oder Push. Danach erstellt die Aufnahme den Pull Request Richtung main — der ganze Flow hat den Worktree-Ordner nie verlassen.
Commit-Sheet auf dem Branch codex/change-background-color mit Include unstaged changes und der Option Commit and push.Bei 4:04 ansehen
Der CLI-Weg und die Regeln, die beißen
- 9
App überspringen: Worktree aus dem CLI starten
Dasselbe Feature läuft auch headless. In der Aufnahme tippt der Presenter am zsh-Prompt im Repo codex --worktree "Implement the new feature" — Codex erstellt einen verwalteten Worktree für diesen Chat und lässt die Aufgabe dort laufen, so wie die App es tut. Diese Create-/List-Tools kamen in Codex 0.162.0 für vertrauenswürdige lokale Projekte.
Terminal am main-Branch des Repos führt codex --worktree "Implement the new feature" aus.Bei 4:38 ansehen - 10
Kenne die Aufräumregeln und die Ein-Branch-Grenze
Codex behält deine 15 jüngsten verwalteten Worktrees und schneidet ältere weg, sobald neue dazukommen — nie einen gepinnten Chat, einen laufenden Chat oder einen permanenten Worktree, und immer erst nach dem Sichern eines Snapshots, den du aus dem Chat wiederherstellen kannst. Zwei harte Kanten aus der Doku: Ein Branch kann nur in einem Worktree gleichzeitig ausgecheckt sein (nimm Handoff statt eines zweiten Checkouts), und ignorierte Dateien wie .env wandern nicht in Worktrees, solange du sie nicht in einer .worktreeinclude-Datei auflistest.
Offizielle Worktrees-Dokumentation: was ein Worktree ist, Terminologie und Aufräumverhalten.Bei 4:47 ansehen
Codex-Worktree funktioniert nicht? Prüfe zuerst das hier
Die meisten Worktree-Fehlschläge sind Setup, nicht Git. Aufnahme und offizielle Doku zeigen auf dieselbe kurze Liste — geh sie von oben nach unten durch, bevor du .git von Hand anfasst.
- 1Feature-Flag aus. Worktrees liegen hinter einem Gate: Führe codex features enable worktrees in einem Terminal aus und starte die Codex-App dann vollständig neu. Eine fehlende New-local-worktree-Option im Composer heißt fast immer, dass dieser Schritt — oder der Neustart — nie stattfand.
- 2Das Projekt ist kein Git-Repository. Worktrees funktionieren nur in Projekten, die Teil eines Git-Repositorys sind, und die 0.162.0-Release-Notes begrenzen die Tools auf "trusted local projects" — ein simpler Ordner oder ein nicht vertrautes neues Repo bietet die Worktree-Option nicht an.
- 3Der Start-Branch ist woanders schon ausgecheckt. Git erlaubt einen Worktree pro Branch, ein belegter Branch scheitert also mit fatal: 'branch' is already used by worktree at .... Starte von main oder einem anderen freien Branch, oder ziehe den Chat mit Handoff um.
- 4Deine Env-Dateien tauchen nicht im Worktree auf. Git verfolgt .env & Co. nicht, also werden sie nicht kopiert. Liste sie in einer .worktreeinclude-Datei im Repo-Root (ein Pfad pro Zeile), und Codex kopiert sie in neue Worktrees.
- 5Eine veraltete App. Die Aufnahme beginnt mit "make sure you update yours to the latest version" — die Tools für verwaltete Worktrees gibt es nur in neueren Builds (0.162.0 oder neuer für die CLI-Create-/List-Tools). Aktualisieren, Flag aktivieren, Neustart, nochmal versuchen.
Ist ein Worktree schon weg, die Arbeit aber wichtig war, öffne zuerst seinen Chat — Codex sichert vor dem Aufräumen einen Snapshot und kann ihn wiederherstellen. Und wirkt dir das ganze Modell zu schwer, funktioniert der simple git worktree add weiterhin: Codex automatisiert nur dieselbe Git-Funktion im Untergrund.