Codex-Anleitung
Einrichtung der config.toml, env_key vs. experimental_bearer_token und Modell-IDs pro Tarif.
In der Konsole läuft dein eigenes Modell über config.toml sofort, doch in Codex Desktop steht nur Custom und das Dropdown bleibt leer. Geht man der Sache nach, liegt das Problem nicht am Gateway, sondern am UI-Filter der Desktop-App.
Nach der Einrichtung eines Drittanbieter-Gateways in ~/.codex/config.toml läuft codex -m claude-sonnet-5-5 im Terminal sofort. Öffnet man danach Codex Desktop, steht in der Modellleiste jedoch nur Custom (oder Custom High), und im Dropdown taucht keines der eigenen Modelle auf.
Der erste Verdacht lautet meist, dass die Desktop-App config.toml ignoriert oder ein Syntaxfehler vorliegt. Geht man die Ursache Schritt für Schritt durch, trennen sich zwei Ebenen: zwei lokale Konfigurationsfallen beim Laden und ein clientseitiger UI-Filter, der die Einträge auch bei perfekter Config ausblendet.
Wenn in Codex Desktop Custom steht, ist deine Konfiguration nicht kaputt. Solange model ganz oben in config.toml steht, sendet Desktop die Anfragen trotzdem exakt an diese Modell-ID.
Bevor man der App die Schuld gibt, lohnt der Blick auf zwei häufige Fehler:
model und model_provider stehen unter einer [Tabelle]In TOML gehören Schlüssel nur dann zur obersten Ebene, wenn sie vor der ersten [model_providers.xxx]-Überschrift stehen. Landet model = "claude-sonnet-5-5" am Dateiende, gehört es zur Provider-Tabelle statt zum globalen Standardwert.
Codex Desktop liest config.toml nur beim Start. Wer unter macOS nur das Fenster schließt, lässt den Prozess im Hintergrund weiterlaufen. Nach jeder Änderung ist ein vollständiges Beenden (Cmd + Q bzw. unter Windows über das Tray-Icon) nötig.
Custom?Liegen die Felder ganz oben und die App wurde per Cmd + Q neu gestartet, zeigt eine Testnachricht schnell die Wahrheit: Die Anfrage geht durch und landet bei claude-sonnet-5-5, nur die UI zeigt weiter Custom.
Dieselbe config.toml funktioniert in der codex CLI ohne Einschränkung. Der Grund liegt im Aufbau der Desktop-App: Der lokale app-server liest config.toml und model_catalog_json per model/list korrekt aus, doch der Electron-Renderer davor filtert die Liste auf UI-Ebene:
use_hidden_models, available_models, default_model) und entfernt Modelle außerhalb der Liste (vgl. openai/codex#19694).| Ansatz | Wann sinnvoll | Nachteil |
|---|---|---|
model oben in config.toml festlegen | Du nutzt in Desktop meist ein festes Modell | UI zeigt Custom; Wechsel erfordert Datei-Edit + Cmd + Q |
| ChatGPT-Sitzung aktiv lassen | Du willst das API-Key-UI-Gating umgehen | Erfordert Login mit einem OpenAI-Konto (Free/Go reicht) |
codex CLI (-m / --profile) nutzen | Du wechselst häufig zwischen Modellen | Terminal-TUI statt Desktop-Oberfläche |
Community-Patches für app.asar | Du brauchst eigene Einträge direkt im Desktop-Dropdown | Inoffiziell; jedes Desktop-Update überschreibt den Patch |
model oben eintragen und Custom ignorierenWenn du in Desktop meist bei einem Modell bleibst – etwa claude-sonnet-5-5 oder gpt-6-2-sol über CodingPass –, setze model_provider und model ganz an den Anfang von ~/.codex/config.toml:
model_provider = "codingpass"model = "claude-sonnet-5-5" [model_providers.codingpass]name = "CodingPass"base_url = "https://codingpass.ai/v1"env_key = "CODINGPASS_API_KEY"wire_api = "responses"App per Cmd + Q neu starten und das Custom-Badge einfach ignorieren.
Um die API-Key-Sperre zu umgehen, kannst du ein reguläres ChatGPT-Konto in der App angemeldet lassen, während dein Custom Provider in config.toml steht. Die Sitzung erfüllt die UI-Prüfung, der Traffic läuft über deinen Provider.
-m oder --profile wechselnDie codex CLI filtert nichts weg. Ab Codex 0.134.0 liegt jedes Profil in einer eigenen Datei, z. B. ~/.codex/cp.config.toml:
codex --profile cp -m claude-sonnet-5-5app.asar (Notlösung)Tools wie CodexUse patchen in app.asar Flags wie use_hidden_models. Da jedes App-Update den Patch überschreibt, lohnt sich dieser Weg nur übergangsweise.
Die vollständige Einrichtung mit CodingPass findest du in der Codex-Anleitung und unter Kontingente und Limits.
Nutze CodingPass in Codex CLI und Desktop mit derselben config.toml. Setze base_url auf codingpass.ai/v1 für nutzungsbasierten Zugriff auf Claude, GPT und Open-Weight-Modelle.