Häufige Codex-Fehler und Lösungen

1. Fortschritt sichern, ein verfügbares Modell wählen oder später erneut versuchen. OpenAI-Dienststatus prüfen.
2. Scheitert nur der alte Thread, mit Übergabe neu starten. Scheitern alle Modelle dauerhaft, Zeit, Version und Fehlertyp per /feedback melden.

/model

1. Aktives Konto, Workspace und Rücksetzzeiten der 5-Stunden-/Wochenfenster auf der Nutzungsseite prüfen.
2. Wird noch Kontingent angezeigt, Fortschritt sichern und am richtigen Konto neu anmelden. Bei anhaltender Abweichung bereinigten Screenshot und Zeitpunkt aufbewahren.

API-Keys nutzen OpenAI-Platform-Abrechnung und -Limits, nicht das Codex-Kontingent des ChatGPT-Plans. Eigene Provider können andere Regeln haben.

codex login status

codex logout
codex login

1. Anmeldeart prüfen. ChatGPT-Nutzer sollten sich zuerst neu authentifizieren; dummy allein erfordert keinen neuen API-Key.
2. Bei eigenem Provider oder API-Key die Anbieter-Authentifizierung prüfen; dummy kann auch ein lokaler Platzhalter sein.

codex login status

codex logout
codex login

1. Anmeldestatus und Ziel-Provider prüfen. ChatGPT-Anmeldung und API-Key unterscheiden.
2. ChatGPT-Nutzer können den Fortschritt sichern und sich neu anmelden. Bei API-Keys Status, Organisation und Endpunkt prüfen.

API-Keys nutzen OpenAI-Platform-Abrechnung und -Limits, nicht das Codex-Kontingent des ChatGPT-Plans. Eigene Provider können andere Regeln haben.

codex login status

codex logout
codex login

1. Doctor ausführen; VPN, Proxy, DNS, Firewall und eigene CAs prüfen. Mit einem Handy-Hotspot vergleichen.
2. CLI und Desktop mit gleichem Konto und Netzwerk vergleichen. Scheitern beide, Dienststatus und eigene Provider prüfen.

codex doctor --summary

1. Doctor ausführen und mit anderem Netzwerk vergleichen. Prüfen, ob Proxy oder Firewall WSS zulassen.
2. Scheitert nur dieses Netzwerk, DNS, Zertifikate und IPv4-/IPv6-Routing prüfen. IPv6 nicht standardmäßig dauerhaft deaktivieren.

codex doctor --summary

1. In der aktiven Benutzerkonfiguration openai_base_url, model_provider und die base_url des Providers prüfen.
2. Endpunkt und Listener auf Bedarf prüfen. Konfiguration sichern, veraltete Overrides korrigieren und neu starten. Vor dem Teilen Schlüssel und private URLs entfernen.

printenv CODEX_HOME

$env:CODEX_HOME

1. Mit gespeicherter Übergabe einen neuen Thread starten. Vor dem Fortsetzen den Repository-Zustand prüfen.
2. An Meilensteinen docs/codex-handoff.md aktualisieren, Tool-Ausgaben begrenzen und dauerhafte Regeln in AGENTS.md speichern.

1. Im selben Logabschnitt nach server_overloaded, context_window_exceeded oder Verbindungsfehlern suchen und entsprechend prüfen.
2. Client aktualisieren. Bleibt der alte Thread hängen, aus Repository und Übergabe in einem neuen Thread fortsetzen, statt /compact zu wiederholen.

1. /permissions und Arbeitsverzeichnis prüfen. Die Zieldatei muss im erlaubten Schreibbereich liegen.
2. Funktioniert der Chat, aber Installation oder curl scheitert, network_access für Befehle prüfen. Nur benötigte Rechte anpassen.

/permissions

1. Repository-Wurzel, Worktrees und Git-Status prüfen. Gehört der betroffene Pfad zu Git-Metadaten?
2. Nach Bearbeitung und Tests die konkrete Git-Aktion freigeben lassen oder im eigenen Terminal committen. Eine Locksperre zu löschen behebt keine Rechtefehler.

git rev-parse --show-toplevel
git status --short
git worktree list

1. IDEs, Git-Clients und Terminals auf laufende Git-Aktionen prüfen und deren Abschluss abwarten.
2. Nur nach bestätigtem Prozessende und nachweislich veralteter Sperre die konkrete Lockdatei manuell behandeln. Niemals das gesamte .git löschen.

git rev-parse --show-toplevel
git status --short
git worktree list

1. Aktivierung, Tool-Liste und Auth-Status des MCP-Servers prüfen. Bei OAuth-Servern mcp login erneut versuchen.
2. Bei weiterem Fehler Umgebungsvariablen, Prozesse und Serverlogs prüfen, danach das Protokoll. Codex-Kontoanmeldung und MCP-Anmeldung sind getrennt.

codex mcp list

codex mcp login SERVER_NAME

1. /status, CODEX_HOME, CLI-Parameter und gewähltes Profil prüfen. Projektkonfiguration wird nur in vertrauenswürdigen Projekten geladen.
2. CLI → Projekt → Profil → Benutzer → verwaltet/System → Standard prüfen. Prüfen, ob Provider- und Auth-Einstellungen im Projekt überschrieben werden dürfen.

printenv CODEX_HOME

$env:CODEX_HOME

1. Globale Anweisungen sowie AGENTS.md / AGENTS.override.md entlang des Arbeitspfads prüfen. Das Standardlimit beträgt insgesamt 32 KiB.
2. Nach Änderungen eine neue Sitzung starten und geladene Regeln zusammenfassen lassen. Arbeitsverzeichnis und CODEX_HOME prüfen.

printenv CODEX_HOME

$env:CODEX_HOME

1. Version und alle Befehlspfade vergleichen. Parallele npm-, Homebrew- und Standalone-Installationen prüfen.
2. Hauptinstallation bestimmen und diese aktualisieren. Bei npm EACCES Verzeichniseigentümer prüfen, nicht blind mit sudo neu installieren.

codex --version
command -v codex
type -a codex

codex --version
Get-Command codex -All
where.exe codex

1. Betroffenen Client vollständig beenden und neu öffnen. Aktualisieren und mit neuem Thread testen.
2. CLI-Vergleich, Client-Version und Zeitpunkt festhalten. Bei nicht reagierender Windows-Erweiterung native Laufzeitbibliotheken prüfen.

codex doctor --summary

1. Bei Sandbox-Startfehlern Codex neu starten und elevated/unelevated-Modi sowie .sandbox/sandbox.log nach offizieller Anleitung prüfen.
2. Bei nicht reagierender Erweiterung oder fehlender DLL C++ Build Tools und x64 Redistributable prüfen. .sandbox-secrets nicht teilen.

codex doctor --summary

1. Setup darf Abhängigkeiten aus dem Internet laden. Agent-Internetzugriff ist standardmäßig aus; bei Bedarf in den Umgebungseinstellungen aktivieren.
2. Secrets stehen nur im Setup bereit. Normales export bleibt nicht über Shell-Grenzen erhalten. Nicht sensible Variablen in der Umgebung setzen; Secrets nie im Repository speichern.