Fehlerbehebung bei Codex
Der Schwerpunkt bei der Fehlerbehebung von Codex liegt auf der OpenAI-kompatiblen Schnittstelle. Gehen Sie bei der Fehlerbehebung im Allgemeinen in dieser Reihenfolge vor: Base-URL, Key, Modellname und ob der aktuelle Provider aktiv ist.
Was sollte zuerst überprüft werden?
| Prüfpunkte | Wo zu finden | Warum |
|---|---|---|
| Der Provider unterstützt OpenAI-kompatible Schnittstellen | Im Backend werden API-Adresse, Base-URL, OpenAI-Kompatibilität und weitere Anweisungen angezeigt | Codex muss die kompatible Schnittstelle anfragen können |
| Base-URL | Kopieren Sie den vom Provider bereitgestellten API-Link | Ob /v1 benötigt wird: Orientieren Sie sich am Beispiel im Backend, raten Sie nicht |
| Key-Status | Key ist weder deaktiviert noch abgelaufen, und das Kontoguthaben ist ausreichend | Bei 401 meist zuerst den Key prüfen |
| Modellname | Entsprechend der Modellliste im Backend kopieren | Ist der Modellname, die Groß-/Kleinschreibung, ein Bindestrich oder die Versionsnummer falsch angegeben, schlägt die Anfrage fehl |
Häufige Fehler
| Symptom | Vorrangig prüfen | Lösungen |
|---|---|---|
| 401 / Unauthorized | API-Key | Generieren Sie den Key neu oder kopieren Sie ihn erneut, und stellen Sie sicher, dass der Key nicht deaktiviert oder abgelaufen ist und das Kontoguthaben ausreicht. |
| 404 / model not found | Modellname | Geben Sie Modellnamen nicht aus dem Gedächtnis ein; kopieren Sie sie aus der Modellliste im Backend des Providers. Wenn das Abrufen der Modellliste unterstützt wird, rufen Sie zuerst die Liste ab; schlägt dies fehl, tragen Sie ihn manuell ein. |
| Fehler im Zusammenhang mit der Base-URL | Ist der API-Link vollständig | Die Base-URL ist der vom Provider bereitgestellte API-Link. Ob /v1 erforderlich ist: Folgen Sie dem Beispiel im Backend, raten Sie nicht. |
| Anfrage geht nicht durch, obwohl der Key gültig ist | Stimmt das Protokoll überein | Vergewissern Sie sich, dass der aktuelle Provider eine OpenAI-kompatible Schnittstelle anbietet – nicht Claude, Gemini oder eine Schnittstelle, die nur Web-Chat unterstützt. |
| Keine Auswirkung nach Verwendung von CC-Switch | Zielwerkzeug-Auswahl | Stellen Sie sicher, dass der Provider auf Codex und nicht auf Claude Code angewendet wird; starten Sie das Terminal oder den Client neu, bevor Sie es erneut testen. |
Minimaler Test
Testen Sie zuerst mit einer möglichst kurzen Anfrage, um zu bestätigen, dass die Verbindung funktioniert, bevor Sie an einem echten Projekt arbeiten.
Minimaler Codex-Test
codex "Please reply only: Codex configuration test successful"Feedback-Vorlage
So formulieren Sie das Feedback an den Provider
Tool: Codex System version: Provider dashboard Base URL: Model ID / model name: Exact error: I have checked: no spaces in the Key / balance is sufficient / model name copied exactly / Base URL copied from the dashboard / terminal reopened