Codex in VS Code verwenden: Gültigkeitsbereich, Wiederherstellungspunkte und Lösungen für häufige Abstürze
Codex in VS Code ohne die üblichen Verzögerungen: Installation und Anmeldung, eine erste begrenzte Agentenaufgabe, Cloud gegenüber CLI, gemeinsame Konfiguration sowie Fixes für WSL und Genehmigungen.
Quellen: How to Use Codex in VS Code: From First Task to Reliable Agent Workflow
Um Codex in VS Code zum Laufen zu bringen, sind ein paar Minuten nötig: Installieren Sie die offizielle openai.chatgpt-Erweiterung, melden Sie sich an, öffnen Sie einen Projektordner, wechseln Sie in den Agent-Modus und geben Sie ihm eine eng gefasste Aufgabe, bei der die beteiligten Dateien benannt werden. Jede Änderung im Arbeitsbereich sowie jedes Testergebnis benötigt vor der Speicherung eine menschliche Überprüfung. Längere Aufgaben eignen sich besser für die Delegation in die Cloud, und die Probleme, die die meisten Nutzer aufhalten – insbesondere wiederholte Genehmigungen, das Fernanmelden sowie ein Absturz beim Laden von Windows WSL – haben jeweils eine spezifische Lösung, die weiter unten beschrieben wird.
Der Fokus liegt hier ausschließlich auf der Oberfläche von VS Code: zunächst eine begrenzte Aufgabe, anschließend die Steuerelemente, die dafür sorgen, dass der Agent vorhersehbar bleibt. Die Installation im Terminal, das Cursor-Plugin, Nutzungs-Dashboards sowie Vergleiche mit anderen Tools sind separate Themen.
Von Vorschlägen zu einem Agenten, der Dateien verschiebt
Viele Entwickler sind an sogenannten „Ghost-Texten“ gewöhnt: Während man Text eintippt, erscheint ein Vorschlag, der entweder beibehalten oder ignoriert wird, und ansonsten passiert im Projektbaum nichts. Der Agent-Modus in Codex ist etwas ganz anderes. Während der Benutzer Kaffee holt, liest ein Seitensymbolleisten Dateien ein, bearbeitet den Projektbaum und führt Überprüfungen durch. Wer die beiden verwechselt, hat das Gefühl, es handele sich um einen Einbruch, obwohl es sich dabei einfach um eine andere Art der Arbeit handelt.
Eine Analogie hilft. Ein Passagier, der auf ein Verkehrszeichen zeigt, lässt die Hände des Fahrers weiterhin am Lenkrad, und das Auto bewegt sich nur, weil der Fahrer es bewegt. Die Schlüssel zu übergeben, ist etwas anderes: Man kommt aus der Küche zurück und das Auto steht in einer neuen Parklücke, mit umgeräumtem Kofferraum und mehr gefahrenen Kilometern – und niemand hat nach der Route gefragt. Die inline Autocomplete-Funktion ist wie der Passagier, der zeigt. Der Agent-Modus entspricht dem Satz an Schlüsseln. Ein Wiederherstellungspunkt zu überspringen bedeutet, Schreibzugriff auf ein Repository zu gewähren, das noch ungespeicherte Arbeit vom Nachmittag enthält.
Was die aktuelle Erweiterung tatsächlich ist
Die heutige Codex IDE-Erweiterung fungiert als asynchrone Programmieragentin. Es handelt sich dabei um einen Hintergrundprozess, der das Recht hat, das Repository zu lesen, Dateien auf der Festplatte umzuschreiben und Terminalbefehle auszuführen – während die Autocomplete-Funktion lediglich den nächsten Token vorschlägt. Sie hat nichts mit der Codex-Completion-API von 2021 oder dem „Ghost Text“ von Copilot zu tun, und alle Tutorials, die sie als bessere Alternative zur Tab-Taste beschreiben, beziehen sich auf etwas anderes.
Im Agentenmodus wird die Arbeit auf das Repository und das Terminal verteilt, weshalb Umfang und Wiederherstellung wichtiger sind als je zuvor bei der Autocomplete-Funktion. Ein einzeiliger Vorschlag bleibt im Editor, bis er angenommen wird. Eine Agentenaufgabe kann bereits in src/ landen, während der erste Abschnitt ihres Plans noch gelesen wird.
Der Chat-Modus, sofern der Komponist ihn anbietet, dient ausschließlich der Diskussion – es sind weder Dateiänderungen noch Befehle möglich. Er eignet sich zum Erörtern des Problems. Agent ist die Wahl, wenn die Struktur tatsächlich geändert werden soll.
Umfang, Beweise und Rückweg
OpenAIs eigene IDE-Dokumentation sowie praktische Beschreibungen stimmen in Bezug auf die Schnittstelle in einem Punkt überein: Im lokalen Agent-Modus werden Änderungen direkt im Arbeitsverzeichnis vorgenommen. Die Erweiterung zeigt nicht wie einige andere Editor eine inline-Anzeige von Änderungen zum Akzeptieren oder Ablehnen. Git fungiert als „Umbuchen“-Funktion, und ohne initialisiertes Repository gibt es keinen sauberen Rückweg.
Drei Dinge sollten vor der ersten Anfrage erledigt werden:
- Öffnen Sie ein echtes Projektverzeichnis und nicht nur eine einzelne Datei.
- Speichern Sie alles, was nicht verloren gehen darf, ab –
git stash push -u -m „pre-codex“reicht aus.
Eine ordentliche Anweisung in einem unkommitierten Baum ist riskanter als eine unvollständige Anweisung in einer sauberen Branch.
Wenn etwas schiefgeht, wirken die Schäden in der Regel banal: eine kleine Umbenennung, ein Hilfsprogramm, das in die falsche Datei eingebunden wird, Tests, die nie ausgeführt wurden. Es ist nichts Exotisches dabei. Es handelt sich einfach darum, was ein Agent tut, sobald er einen funktionierenden Baum hat und der Benutzer ein Vorschlagsfeld vorgestellt hat. Das Öffnen keiner Ordner, das Nichtverwenden von Git oder das Verlangen, den „Codebase zu verbessern“, ohne Dateien zu benennen, hindert die Erweiterung nicht daran, zu laufen – und das ist die Gefahr.
Installierung der echten Erweiterung
Der einfache Weg ist kurz. Die Identitätsprüfung wird in den meisten Installationsvideos übersprungen.
Bestätigen Sie Verlag und Identifikator
Das richtige Paket ist die offizielle Codex-Erweiterung vom Marketplace, nicht eine ähnlich benannte Community-Wrapper-Version. Es ist als Codex - OpenAI's Coding Agent aufgeführt, von OpenAI veröffentlicht, und weist die eindeutige Identifikationsnummer openai.chatgpt auf. Genau diese Identifikationsnummer unterscheidet das echte Produkt von einem fremden Autocomplete-Plugin.
Um schnell auf Codex zuzugreifen, verwendet man auf macOS Cmd+P und auf Windows sowie Linux Ctrl+P. Kopieren Sie diesen Befehl und drücken Sie Enter:
ext install openai.chatgpt
Auch der Ansicht „Erweiterungen“ funktioniert: Suchen Sie nach dem genauen Titel und vergleichen Sie Verlag sowie Identifikator, bevor Sie auf „Installieren“ klicken. Anzahl der Installationen, Sternbewertungen und Versionen sind kein Beweis, da sie ständig ändern.
Die Seite des Visual Studio Marketplaces für openai.chatgpt sowie die Dokumentation zur Codex IDE-Erweiterung von OpenAI sind zum Anheften wert. Der hier beschriebene Arbeitsablauf baut auf diesen auf, ersetzt sie aber nicht.
Sobald die Erweiterung installiert ist, kann das Codex-Symbol in die rechte Aktivitätsleiste verschoben werden, sodass der Code links und der Agent rechts bleiben – eine Anordnung, die die meisten Menschen bevorzugen. Ein verschwundenes Symbol nach einem Update erfordert keine Neuinstallation. Die unten beschriebene Wiederherstellung über die Seitenleiste kümmert sich darum.
Anmelden mit einem ChatGPT-Konto
Öffnen Sie das Codex-Fenster und wählen Sie „Mit ChatGPT einloggen“. Führen Sie die Umleitung im Browser auf dem Konto durch, das tatsächlich den Plan besitzt. Die Einträge im Marketplace tragen die Namen Plus, Pro, Business, Edu und Enterprise.
GitHub Copilot Pro+ und Copilot Max verfügen über einen separaten Insiders-Weg mit der Option „Mit Copilot einloggen“ sowie einem Ansichtsfeld für Agent-Sessions. Beide Anmeldeverfahren sind gültig und sollten nicht miteinander verwechselt werden, da es sich um unterschiedliche Schaltflächen handelt.
Einige Karussells bei der ersten Nutzung enthalten einen Schritt zur Einrichtung einer Sandbox. Ein häufig angesehenes Installationsvideo durchläuft die Begrüßungsbildschirme und wählt anschließend die Option „Sandbox als Backup“, damit der lokale Container gestartet werden kann. Wenn diese Steuerung angezeigt wird, wird die isolierte Umgebung initialisiert, die der Agent verwenden wird – es wird kein zweites Produkt installiert.
Der Zugriff über ChatGPT ist an ein Abonnement gebunden. Nachrichtenbudgets, Modellauswähler sowie Preisangaben ändern sich, weshalb alle in einer Übersicht Mitte 2026 genannten spezifischen Plus- oder Pro-Vorteile als veraltet angesehen werden sollten. Der aktuelle Nutzungsbildschirm des Kontos ist die zuverlässige Quelle vor der Planung einer langen Sitzung.
Wann eine API-Schlüssel sinnvoll ist
„Bring-your-own-key“ bedeutet, sich mit einem OpenAI API-Schlüssel und nicht mit einem ChatGPT-Anmeldedaten zu authentifizieren. Die Anmeldeseite zeigt einen Button „API-Schlüssel verwenden“. Dieser Weg ist nützlich, wenn die ChatGPT-Quoten aufgebraucht sind oder ein Team bereits über die API abgerechnet wird.
Er ersetzt kein Plus-Abo. Laut Preisübersichten aus 2026 entfallen bei Abrechnung über einen API-Schlüssel in Erweiterungen und der CLI die Cloud-Delegation sowie die GitHub-Code-Review-Funktionen, weshalb alle, die diese benötigen, weiterhin ein ChatGPT-Abo beibehalten müssen.
Wenn der Button nicht ausreicht, kann die gemeinsame Konfiguration explizit festgelegt werden:
preferred_auth_method = "apikey"
Eine Datei mit nur Platzhaltern als Schlüsseldaten wird anschließend in ~/.codex/auth.json abgelegt:
{"OPENAI_API_KEY": "YOUR_API_KEY_HERE"}
Falls das Panel weiterhin nach ChatGPT verlangt, exportieren Sie den Schlüssel in derselben Shell, die den Editor startet, und öffnen Sie anschließend den Ordner von dort aus:
export OPENAI_API_KEY="your-api-key-here"
code .
PowerShell unter Windows verwendet $env:OPENAI_API_KEY="Ihre-API-Schlüssel-hier" gefolgt von code .. Echte Schlüssel dürfen nicht in Screenshots, Tickets oder Kommentaren erscheinen. Der angezeigte JSON-Text ist nur ein Muster.
Berichte aus der Community beschreiben außerdem einen auf WSL spezifischen Fehler mit der Schaltfläche „API-Schlüssel verwenden“. Im Windows Subsystem for Linux bedeutet eine nicht funktionierende Schaltfläche, dass man auf config.toml zusammen mit der Umgebungsvariable zurückgreifen muss oder den Editor von einer Shell aus starten muss, die bereits den Schlüssel enthält.
Die erste kontrollierte Aufgabe
Die erste Aufgabe dient nicht dazu, jemanden zu beeindrucken. Ihr Zweck ist es zu beweisen, dass Codex in VS Code die genannten Dateien berührt, die angegebene Überprüfung durchführt und einen lesbaren Diff hinterlässt.
Öffnen Sie den Ordner und geben Sie ein überprüfbares Ergebnis an
Wählen Sie „Datei“ > „Ordner öffnen“ und wählen Sie den Projektwurzelordner aus – also den Ordner, der das Lockfile, pyproject.toml oder die tatsächlich kompilierte Lösungsdatei enthält. Initialisieren Sie Git, falls es noch nicht vorhanden ist, öffnen Sie das Codex-Fenster und stellen Sie den Composer auf Agent ein.
Formulieren Sie das Ziel so, dass ein müder Kollege es bereits um sechs Uhr abends überprüfen kann. Dafür sind folgende Elemente erforderlich:
- Eine Verhaltensänderung.
- Eine Dateifamilie.
- Ein Befehl oder eine Test, die dies nachweisen.
Ein Eingabefeld für die erste Sitzung kann wie dieses Lehrbeispiel aussehen:
Update token expiry handling in @src/auth.ts. Run the existing tests and summarize changed files.
Der Satz enthält eine Datei, ein Ergebnis und den Beweis. „Make auth better“ enthält keines davon.
Ein verstecktes Panel wird über die Befehlspalette mit Codex: Open Codex Sidebar erreichbar. Das Durchsuchen der linken Aktivitätsleiste ist zeitaufwändig, da Updates das Icon bereits mehrfach in die obere rechte Werkzeugleiste verschoben haben.
Weisen Sie dem Agenten die richtigen Dateien zu
Durch Eingabe von @filename wird dem Agenten eine einzelne Datei übergeben, ohne dass der Kontext mit dem gesamten Dateisystem überflutet wird. Fügen Sie nur das Wichtige hinzu und geben Sie an, welche Dateien unzugänglich sind. Konventionen können für spätere Sitzungen in ein AGENTS.md am Wurzelverzeichnis des Repositoriums aufgenommen werden, doch für die erste Aufgabe reicht bereits die Anweisung selbst aus.
Beschränken Sie sich bei der ersten Aufgabe auf ein einziges Anliegen – beispielsweise die Handhabung von Ablaufdaten, einen fehlgeschlagenen Test, eine Zeile im Protokoll oder eine Typkorrektur. Größere Refaktorisierungen mehrerer Dateien kommen später, oft als Cloud-Arbeit. Der lokale Agent-Modus kann gerne mit einer solchen Aufgabe beginnen, während die Geduld des Überprüfers nicht mithalten wird.
Überprüfung von Änderungen und Testergebnissen
Sobald der Ausführungsvorgang abgeschlossen ist, sollten drei Dinge in dieser Reihenfolge überprüft werden:
- Geänderte Dateien: Ob der Agent sich innerhalb des angegebenen Pfads aufgehalten hat.
- Tests: Ob sie überhaupt ausgeführt wurden und ob sie bestanden haben.
- Git:
git diffundgit statusdienen als Überprüfungsgrundlage, da die Erweiterung bereits auf die Festplatte geschrieben hat.
Auch wenn eine Ergebniskarte „Bestanden“ anzeigt und src/auth.ts als einzige geänderte Datei aufgeführt wird, muss der Diff dennoch gelesen werden. Grüne Testergebnisse sagen nichts darüber aus, ob ein hinzugefügter Kommentar in einer öffentlichen API Platz hat.
Das Ergebnis all dessen ist ein authentifiziertes Panel, ein eingeschränkt ausgeführter Agent sowie eine im Git sichtbare Änderung. Bei einem sauberen Repository dauert die gesamte Abfolge etwa acht Minuten. Danach folgt die Entscheidung, die Änderung beizubehalten oder zurückzusetzen, gefolgt von einem Stoppen. Eine weitere Aufgabe besteht darin herauszufinden, wie Menschen versehentlich zu einer erneuten Überarbeitung gelangen.
Lokal, Cloud oder CLI
Drei Ansätze teilen den Namen „Codex“ in VS Code, weisen jedoch nicht denselben Einflussbereich auf. Die praktische Frage ist, welcher Ansatz für die heutige Aufgabe benötigt wird.
Der lokale Agent
Der lokale Agent-Modus ist hier der Standardansatz. Die Arbeit findet im Arbeitsbereich statt, wobei die Überprüfung über geänderte Dateien, Tests und Git erfolgt. Seine Hauptbeschränkung wurde bereits erwähnt: Änderungen landen direkt im Arbeitsbaum. Er eignet sich für begrenzte Änderungen, die überwacht werden können.
Delegation in die Cloud
Die Cloud-Delegation sendet eine längere Aufgabe in eine isolierte Cloud-Umgebung, wobei der Editor entweder frei bleibt oder sogar geschlossen wird. Der Marketplace bezeichnet dies als „Delegate to Codex in the cloud“. Anleitungen aus dem Jahr 2026 beschreiben das Verknüpfen eines Repositoriums unter chatgpt.com/codex/settings/environments, die Auswahl dieser Umgebung im Seitenbereich sowie die Auswahl von „Run in the cloud“ gegenüber einer Basis-Branch wie main oder der aktuellen Branch.
Dies eignet sich für große, langsame Aufgaben oder solche, bei denen ein Diff besser geeignet ist als Live-Änderungen. Es wird ein Cloud-Zugang auf der ChatGPT-Seite benötigt, weshalb eine Einrichtung, die nur auf einen API-Schlüssel beschränkt ist, für diese Funktion die falsche Authentifizierungsart darstellt.
Die integrierte Terminal- und CLI-Funktion
Der Codex CLI ist der terminalbasierte Agent aus derselben Modellfamilie, wird jedoch über eine Shell gesteuert und nicht über die Seitenleiste. Er kann im integrierten Terminal von VS Code ausgeführt werden. Installationen auf der Plattform, Updates sowie Sandbox-Einstellungen finden sich in einer CLI-Installationsanleitung und werden hier nicht wiederholt.
Entscheidend ist hier die Funktionalität. Der CLI eignet sich für eine kontrollierte Nutzung über das Terminal, in Fällen, in denen die Seitenleiste nicht richtig funktioniert, sowie für lange /review-Abläufe, die in der Erweiterung immer wieder abbrechen. Berichte aus dem Jahr 2026 zeigen, dass das einfache codex eine interaktive Sitzung öffnet, während eine an codex exec übergebene Anweisung ohne Interaktion einmal ausgeführt wird – beispielsweise um alle Linting-Fehler in src/ zu beheben. Installieren Sie den CLI nur, wenn er fehlt.
Die Frage, welches Tool insgesamt bevorzugt werden sollte, steht in keinem Zusammenhang mit der Funktionsweise des VS Code Agents, und ein Vergleich von Claude Code und Codex beantwortet sie.
Eine Konfigurationsebene für beide
Eine architektonische Tatsache, die auf den Marketplace-Seiten selten erwähnt wird: Die VS Code-Erweiterung ist Closed Source, und die Betreiber beschreiben sie als eine Benutzeroberflächenschale um die Open-Source-Codex-CLI. Das erklärt, warum ein einziger Ordner das Verhalten in beiden Anwendungen steuern kann.
Der gemeinsame ~/.codex/-Ordner
Auf macOS und Linux ist der gemeinsame Ordner ~/.codex/; dort enthält config.toml die Standardwerte und auth.json die Anmeldeinformationen. Sowohl die Erweiterung als auch die CLI lesen diesen Ordner, sodass eine Änderung in beiden Anwendungen wirksam wird.
Das Äquivalent unter Windows befindet sich im Benutzerprofil. Bei Remote- und Code-Server-Einstellungen werden weitere Kopien von auth.json im Erweiterungsordner hinzugefügt, was zwar Workarounds darstellt, aber keine zweite Quelle der Wahrheit ist. ~/.codex/ ist immer dann der bessere Ort, wenn es möglich ist. Texte lassen sich leichter richtig einstellen als Screenshots dieses Ordners.
Standardwerte, die durch die Quelle gestützt werden
Ein globales Beispiel findet sich in den 2026er-Leitfäden für den Editor:
# ~/.codex/config.toml
model = "gpt-5.3-codex"
approval_mode = "agent"
Betrachten Sie den Modellstring als verderblich. Die Namen in den Tutorials haben sich bereits von GPT-5.1 über GPT-5.3-Codex bis zu späteren GPT-5.x-Versionen geändert. Wenn das Panel den Wert unexpected status 400 Bad Request: {"detail":"Unsupported model"} ausgibt, bezieht sich das auf einen Namen, den diese Version nicht liefern kann. Wählen Sie zunächst ein unterstütztes Modell in der Benutzeroberfläche aus; falls dennoch ein Standardwert gewünscht ist, geben Sie den tatsächlich ausgewählten Namen ein.
Die Einstellung approval_mode = „agent“ ist die Standardvariante: Lesen und Bearbeiten erfolgen im Arbeitsbereich, Befehle werden im Arbeitsverzeichnis sowie in einem eingeschränkten Netzwerk ausgeführt. Im Chat findet nur Kommunikation statt. „Agent Full Access“ erweitert die lokalen Ausführungsmöglichkeiten und erlaubt Internetabfragen. Der Modus sollte zur Aufgabe passen – „Full Access“ sollte nicht einfach deshalb aktiv bleiben, weil eine npm-Installation letzte Woche das Netzwerk benötigte.
Die API-Schlüssel-Einstellung aus dem vorherigen Abschnitt befindet sich im selben Datei. Durch die Zusammenführung der Authentifizierungs- und Genehmigungsrichtlinien kann der gesamte Vertrag in zwanzig Sekunden gelesen werden.
Genehmigungszyklen und der Windows-Spinner
Das sind die Probleme, die in den Einrichtungshilfen übergangen werden und nach denen gesucht wird, sobald Codex in VS Code nicht mehr funktioniert. Beide ähneln Produkttreibern, und manchmal sind sie das auch. Manchmal warnt der Sandbox davor, dass der Agent etwas tun will, was niemand beobachtet. Flüssiger bedeutet nicht sicherer.
Genehmigungsprozesse vereinfachen, ohne Grenzen aufzugeben
Windows-Nutzer beschreiben insbesondere einen Berechtigungszyklus, bei dem bei jedem Lesen oder Schreiben einer Datei eine Pause für einen Klick erforderlich ist. Der Composer bietet Chat, Agent sowie Agent Full Access an. Letzterer schweigt die meisten Anfragen, da er umfassendere lokalen Aktionen sowie Netzwerknutzung erlaubt. Das ist der eigentliche Kompromiss – und genau dadurch kann eine Anfrage zur Umbenennung einer Funktion zu einem unerwarteten Paketdownload führen.
Eine in verschiedenen Beschreibungen wiederkehrende Workaround-Lösung der Community ist diese Konfigurationszeile:
approval_mode = "auto"
Einige Threads schlagen eine mittlere Einstellung namens workspace-write sowie eine extremere Variante namens danger-full-access vor. Beide Namen stammen aus Beiträgen der Community, und keiner davon ist ein Grund, den Agenten auf ein Heimverzeichnis auszurichten.
Ein Automatikmodus oder ein umfassenderer Composer-Modus ist nur dann sinnvoll, wenn alle folgenden Bedingungen erfüllt sind:
- Git zeigt einen sauberen Baum an, oder die Änderungen wurden gespeichert.
- Im Arbeitsverzeichnis befinden sich keine Geheimnisse, oder Git ignoriert sie.
- Der Dateibereich lässt sich in einem Satz beschreiben.
git diffwird vor dem Push ausgeführt.
Falls eine der Bedingungen nicht erfüllt ist, sollten die Nachfragen beibehalten werden. Der Kreislauf ist zwar lästig, aber ein stilles Schreiben in .env ist noch schlimmer.
Die Erfahrung zeigt die Grenzen der simplen Lösung. Der Umstieg auf Vollzugriff als „Einfach aufhören zu fragen“-Lösung beendete zwar die Störungen, doch die Sitzung erhielt außerdem einen Zugang zum Netzwerk, den eine lokale Umbenennung niemals benötigt hätte. Die Konfigurationszeile wirkt wie ein Skalpell, während Vollzugriff eher wie ein Eimer fungiert.
Der Fall des Ladevorgangs von Windows 11 WSL
In einem dokumentierten Fall von Windows 11 bleibt das Panel beim Ladevorgang stecken. Im openai/codex-Problem #7082 beschränkten die Nutzer das Problem auf die WSL-Integrationseinstellung. Frühe Antworten der Betreuer schoben die Ursache auf einen regionalen Ausfall, während spätere Antworten die bis heute verwendete Lösung vorschlugen.
In den Einstellungen suchen Sie nach Codex WSL, finden Sie „Codex im Windows Subsystem for Linux ausführen“ und deaktivieren Sie es, anschließend öffnen Sie das Panel im tatsächlich gewünschten Laufzeitumfeld. Es handelt sich dabei um eine Änderung in den Einstellungen und nicht um ein CLI-Flag, weshalb ein Schalter wie codex --no-wsl nicht erfunden werden sollte, da in keiner Quelle darauf Bezug genommen wird.
Jeder, der Codex wirklich in WSL2 haben möchte, sollte das Projekt auf dem Linux-Dateisystem sowie die Tools in dieser Umgebung belassen. Ein Repository mit Windows-Pfad in Kombination mit einem Linux-Agenten führt zu Fehlern bezüglich Dateilimits und Berechtigungen, wodurch das Panel wie verhext erscheint.
Nach der Änderung prüfen Sie, ob die CLI weiterhin im vertrauenswürdigen Terminal gestartet wird. Eine funktionierende CLI zusammen mit einem defekten Panel deutet auf einen Fehler in der WebView oder einer Erweiterung und nicht auf Authentifizierungsprobleme hin. Wenn beides nicht funktioniert, liegt das Problem in der Authentifizierung.
Trennung von Laufzeiten und Historien
Die Chat-Historien von Codex sind zwischen dem Windows- und dem WSL-Dateisystem isoliert. Das Wechseln der Modi zeigt unterschiedliche Threads an. Das ist kein Synchronisierungsfehler, sondern zwei getrennte Speicherorte.
Ein Laufzeitkontext pro Repository, der eine Woche lang aufbewahrt wird, vermeidet Verwirrung. Wenn ein Wechsel unvermeidlich ist, gehen Sie davon aus, dass die weitere Kommunikation nicht stattfinden wird. Dauerhafte Anweisungen gehören in AGENTS.md im Repository und nicht in einen Seitenleisten-Thread, der bis Dienstag verloren geht.
Symptom mit der Reparatur abgleichen
Beginnen Sie mit dem Symptom. Die Anwendung der WSL-Lösung für ein verstecktes Icon dauert zwanzig Minuten. Ein fehlendes Panel, ein abgelehnter Modellname, eine fehlerhafte Überprüfung sowie ein Remote-Login, der nicht zurückkehrt, sind vier verschiedene Reparaturen, die nacheinander ausprobiert und niemals kombiniert werden.
Versteckte Seitenleiste oder nicht unterstütztes Modell
Falls das Icon aus der linken Leiste verschwunden ist, schauen Sie vor der Neuinstallation in die obere rechte Ecke. In Issue #14586 wird berichtet, dass Updates den Zugriff über eine Open Codex Sidebar-Kontrolle in der dortigen Werkzeugleiste ermöglichen, und die Command Palette bietet außerdem Codex: Open Codex Sidebar an.
Falls sich das Panel öffnet und sofort mit unexpected status 400 Bad Request: {"detail":"Unsupported model"} fehlschlägt, ist das ausgewählte Modell für die installierte Version ungültig. Der Auswahlfeld unten im Panel listet die unterstützten Modelle auf. Nach der Auswahl muss ~/.codex/config.toml aktualisiert werden, damit eine veraltete model = „...“-Zeile nicht wieder zum gleichen Fehler führt.
Leere Panels sowie Anmeldezyklen treten auf einer unteren Ebene auf – im WebView, in Cookies oder aufgrund eines ungültigen Tokens. Die einfache Lösung besteht darin, sich auszuloggen, die ChatGPT-Sitzung im Browser zu löschen und erneut anzumelden. Ein Neustart unter Verwendung eines ungültigen Tokens führt lediglich dazu, dass ein neues Icon über dem gleichen Authentifizierungsfile angezeigt wird.
Lange Bewertungen gehören in die CLI
Der Befehl /review der Erweiterung weist laut Berichten eine Zeitüberschreitung von etwa fünf Minuten auf. In großen Repositorien kann der Vorgang damit enden, dass der Agent mitteilt, bereits viele Korrekturen vorgenommen zu haben und keine Zeit mehr zu haben, die genauen Probleme zu ermitteln.
Fünf Minuten gelten für die Seitenleiste, während für dieselbe Überprüfung in der CLI keine entsprechende Zeitbegrenzung angegeben wird. Jeder, der eine Überprüfung durchführen lässt und beobachtet, wie das Panel abstürzt, sollte den Vorgang über die Codex CLI im integrierten Terminal ausführen und das Ergebnis in Git überprüfen. Ein erneuter Versuch mit /review in der Seitenleiste ändert die Zeitbegrenzung nicht. Ein detaillierterer Überprüfungsworkflow, der auch die Anfrage um eine Überprüfung ohne Auslösung einer Neuverfassung beinhaltet, verdient eigene Anleitungen.
Remote SSH und headless Maschinen
Browser-basiertes OAuth versagt vorhersehbar bei entfernten SSH-Systemen, Docker-Instanzen, vscode-server sowie anderen headless-Maschinen, da die Anmeldeseite nicht zum Host zurückkehren kann, der das Token benötigt. In der GitHub-Diskussion #4650 werden Erfahrungen der Community zusammengefasst.
Die am offiziellsten wirkende Workaround-Lösung ist das Port-Forwarding in VS Code: Wählen Sie im PORTS-Bereich „Port forwarden“ aus, geben Sie 1455 ein, stellen Sie sicher, dass die Adresse localhost:1455 anzeigt, und führen Sie anschließend aus:
codex login
Der Browser-Schritt wird auf dem Gerät ausgeführt, das einen Browser öffnen kann, und der umgeleitete Port überträgt die Rückruf-Funktion zur entfernten Sitzung.
Das Kopieren der Anmeldeinformationen ist die aufwendigere Methode. Melden Sie sich auf einem Laptop an, auf dem OAuth funktioniert, und verschieben Sie anschließend ~/.codex/auth.json in den Pfad der entfernten Erweiterung. Bei Code-server liegt das Ziel im Verzeichnis ~/.local/share/code-server/extensions/openai.chatgpt-[version]/. Unter Windows befindet sich das entsprechende Verzeichnis im Benutzerprofil unter .vscode\extensions. In beiden Fällen steht [version] für das Suffix, das das installierte Verzeichnis trägt, und die Datei wird dort als auth.json abgelegt. Die Datei wird nicht in Commits oder Chat-Protokollen aufgeführt, da sie sich wie eine Sitzungskonfiguration verhält. Zuerst wird umgeleitet, das Kopieren erfolgt nur, wenn eine Umleitung nicht möglich ist.
Ob VS Code der richtige Editor ist
Alte Seiten können Leser dazu verleiten, nach einem nicht mehr verfügbaren Plugin zu suchen, daher hilft eine aktuelle Grenzziehung.
JetBrains und VS Code
VS Code setzt auf die offizielle Codex IDE-Erweiterung mit dem Identifikator openai.chatgpt. Die JetBrains IDEs bilden eine eigene Plattform. Ältere Beiträge zu PyCharm behaupteten, es gäbe dort keine native Codex-Unterstützung, was veraltet ist: JetBrains kündigte die native Unterstützung für die IDE-Version 2025.3 im Januar 2026 an, die IntelliJ IDEA, PyCharm, WebStorm und Rider umfasst. Suchanfragen nach IntelliJ- oder PyCharm-Codex führen auf diesen nativen Weg und nicht zum Marketplace-Identifikator. JetBrains-Nutzer sollten die eigenen Dokumentationen zu AI Assistant und Codex befolgen.
Cursor-Nutzer müssen erneut installieren und ein Panel nutzen. Der Marketplace-Flow für VS Code sollte nicht in Cursors Erweiterungs-Host gezwungen werden, da Cursor seinen eigenen Plugin-Weg hat.
Visual Studio Community 2022
Visual Studio Community 2022 erscheint nicht in der Liste der unterstützten GPT-5.1-Codex-Clienten. In einer Diskussion in der GitHub-Community werden für diese Vorschau vier Tools genannt: VS Code, JetBrains, Xcode und Eclipse. C#-Entwickler, die weiterhin in Visual Studio arbeiten, behalten dieses oft zum Kompilieren bei und nutzen zusätzlich VS Code für Erweiterungen an denselben Dateien – was unpraktisch ist und derzeit auch die dokumentierte Lösung darstellt.
Eine begrenzte Aufgabe heute
Ein guter Ausgangspunkt ist ein bereits verständliches Repository. Beruhigen Sie den Arbeitsbaum mit einem Commit oder Stash, bis git status nichts anzeigt, installieren Sie die fehlende Erweiterung, melden Sie sich an und öffnen Sie den Ordner. Senden Sie anschließend eine Agent-Aufgabe, die eine Datei sowie einen Test angibt und auf einem einzigen Diff-Bildschirm dargestellt werden kann.
Beobachten Sie, wie sich die Dateien ändern, lesen Sie den Diff und entscheiden Sie, ob Sie ihn beibehalten oder zurücksetzen. Dieser Kreislauf bedeutet das Verwenden von Codex in VS Code – im Gegensatz zur einfachen Installation.
Die Editor werden weiterhin neue Schaltflächen hinzufügen, die Cloud-Delegation wird reibungsloser werden und die Modellnamen werden erneut wechseln. Was weiterhin teuer bleibt, ist die Gewährung von Schreibzugriff auf einen Baum, den man nicht rückgängig machen kann. Sobald dieser Teil langweilig wird, kann der Rest des Agents interessant werden.
Es gibt eine Gewohnheit, die es wert ist, übernommen zu werden. Beim nächsten Mal, wenn das Panel eine Genehmigung für eine Dateiänderung anfordert, sagen Sie laut den Git-Befehl aus, mit dem diese Änderung rückgängig gemacht werden könnte. Wenn der Satz nicht vollendet werden kann, speichern Sie zunächst ab und fragen Sie erneut – denn diese Pause ist die gesamte Überprüfung.
Verwandte Artikel
- LLMOps für einen Aufgabenhilfsagenten: MLflow Traces, Evals und ein CI Gate — Erstellen Sie einen PydanticAI-Aufgabenhilfsagenten mit FastAPI, verfolgen Sie dessen Abläufe mit MLflow, bewerten Sie ihn mit GenAI-Evaluatoren und verhindern Sie Regressionen in GitHub Actions – alles mit lokalen Modellen.
- Ein Produktions-Harness für Claude Code: Sechs Schichten von Slack bis zur integrierten Code-Übernahme — Wie ein sechsschichtiger Harness Slack-Tickets in integrierten Code umwandelt: Eingang von Ereignissen, geschützte Agentenschleifen, dauerhafter Zustand, Selbstheilung, Überwachbarkeit und Steuerung durch den Operator.