Wie du einen lokalen Client mit oder ohne ChatGPT-Anmeldung mit dem Gateway deiner Organisation verbindest, erfährst du in der Anleitung Mit einem Gateway verbinden. Für den direkten Zugriff auf Bedrock stehen dir die Authentifizierungsoptionen für Amazon Bedrock zur Verfügung.
OpenAI-Authentifizierung
Wenn du OpenAI-Modelle in Codex nutzt, kannst du dich auf zwei Arten anmelden:
- Mit ChatGPT für den Zugriff über dein Abonnement
- Mit einem API-Schlüssel für den Zugriff mit nutzungsabhängiger Abrechnung
Für die lokale Nutzung unterstützen die ChatGPT-Desktop-App, die Codex CLI und die IDE-Erweiterung beide Anmeldemethoden. Für Codex Cloud musst du dich mit ChatGPT anmelden.
Deine Anmeldemethode bestimmt auch, welche administrativen Vorgaben und Richtlinien für den Umgang mit Daten gelten.
- Wenn du dich mit ChatGPT anmeldest, gelten für die Nutzung von Codex die Berechtigungen deines ChatGPT-Workspaces, die rollenbasierte Zugriffskontrolle (RBAC) sowie die Einstellungen für Datenaufbewahrung und Datenresidenz in ChatGPT Enterprise.
- Bei der Anmeldung mit einem API-Schlüssel gelten die Einstellungen deiner API-Organisation für Datenaufbewahrung und Datenfreigabe.
In verwalteten Workspaces ist die Authentifizierung nur ein Teil der Zugriffskontrolle. Wer sich anmelden kann, hängt von der Workspace-Mitgliedschaft und der Bereitstellung der Konten ab. Zugewiesene Lizenzen und Workspace-Rollen bestimmen, welche Produktoberflächen und Funktionen den Mitgliedern zur Verfügung stehen. Bei der lokalen Nutzung der ChatGPT-Desktop-App, der Codex CLI oder der IDE-Erweiterung begrenzen Berechtigungsprofile, was der Agent auf dem Gerät tun kann. Hinweise zur Planung findest du unter Gruppen und Bereitstellung und Rollen und Workspace-Berechtigungen.
Mit ChatGPT anmelden
So greifst du mit Work Cloud vom Desktop, von Mobilgeräten und aus dem Web auf deinen lokalen Computer zu:
-
Melde dich mit ChatGPT bei einem Workspace an, der diese Funktion unterstützt.
-
Bitte eine Person mit Eigentümerrechten für den Workspace, Work Cloud zu aktivieren. Aktiviere anschließend unter Work Cloud die Option „Zugriff auf den lokalen Computer erlauben“. Die Option „Codex lokal in der ChatGPT-Desktop-App verwenden“ muss dafür nicht aktiviert sein.
API-Schlüssel und Codex-Zugriffstoken ermöglichen keinen Zugriff auf den lokalen Computer mit Work Cloud. Die Voraussetzungen findest du unter Rollen und Workspace-Berechtigungen und in den FAQ zur Verwaltung von Work. Die Einrichtung ist unter Zugriff auf den lokalen Computer für Work Cloud und dots beschrieben.
Wenn du dich in der ChatGPT-Desktop-App, der Codex CLI oder der IDE-Erweiterung mit ChatGPT anmeldest, öffnet sich ein Browserfenster. Nach der Anmeldung übermittelt der Browser deine Anmeldedaten an Codex.
ChatGPT im Web
Öffne ChatGPT, melde dich an und wähle den Workspace, in dem du arbeiten möchtest. Bei ChatGPT im Web bleibt die authentifizierte Sitzung in deinem Browser.
ChatGPT-Desktop-App
Wähle auf dem Anmeldebildschirm „Weiter zur Anmeldung“ und schließe die Anmeldung im Browser ab.
Codex CLI
Führe codex login aus und schließe die Anmeldung im Browser ab. Dies ist die standardmäßige Anmeldemethode, wenn keine gültige Sitzung vorliegt.
IDE-Erweiterung
Wähle auf dem Anmeldebildschirm „Mit ChatGPT anmelden“ und schließe die Anmeldung im Browser ab.
Mit einem API-Schlüssel anmelden
Du kannst dich in der ChatGPT-Desktop-App, der Codex CLI oder der IDE-Erweiterung auch mit einem API-Schlüssel anmelden. Deinen API-Schlüssel erhältst du im OpenAI-Dashboard.
ChatGPT-Desktop-App
Wähle auf dem Anmeldebildschirm „Andere Anmeldemethode verwenden“, gib deinen Schlüssel ein und wähle „Weiter“.
Codex CLI
Übergib den Schlüssel über stdin an codex login:
printenv OPENAI_API_KEY | codex login --with-api-key IDE-Erweiterung
Wähle auf dem Anmeldebildschirm „API-Schlüssel verwenden“, gib deinen Schlüssel ein und wähle „OK“.
Wenn du einen API-Schlüssel verwendest, rechnet OpenAI die Nutzung über dein Konto auf der OpenAI Platform zu den regulären API-Preisen ab. Weitere Informationen findest du in der Preisübersicht für die API.
Die Authentifizierung mit einem API-Schlüssel unterstützt lokale Codex-Workflows. Einige Funktionen, die Zugriff auf einen ChatGPT-Workspace oder auf Cloud-Dienste benötigen, sind jedoch nur eingeschränkt oder gar nicht verfügbar. Welche Funktionen die einzelnen Pläne unterstützen, erfährst du unter Verfügbarkeit von Funktionen.
Wenn du dich in der Codex CLI oder in Codex in der ChatGPT-Desktop-App mit einem API-Schlüssel anmeldest, hast du Zugriff auf unterstützte Plug-ins, die OpenAI ausgewählt hat. Einige Plug-ins sind nicht verfügbar, weil sie für den Verbindungsaufbau OAuth-Funktionen benötigen, die bei dieser Anmeldemethode nicht unterstützt werden. Weitere Informationen findest du unter Plug-ins verwenden.
Wenn du dich mit einem API-Schlüssel anmeldest, gelten für Codex die regulären API-Preise. Die in deinem ChatGPT-Plan enthaltenen Credits kommen dabei nicht zum Einsatz.
Verwende für programmgesteuerte Workflows mit der Codex CLI, etwa für CI/CD-Jobs, die Authentifizierung mit einem API-Schlüssel. Stelle in öffentlichen oder nicht vertrauenswürdigen Umgebungen keine Möglichkeit bereit, Codex auszuführen.
Authentifizierung prüfen oder abmelden
Öffne das Profilmenü und prüfe, welches Konto und welcher Workspace aktiv sind. Um die ChatGPT-Sitzung in diesem Browser zu beenden, wähle „Abmelden“.
Im Profilmenü siehst du das aktive Konto oder den Status des API-Schlüssels. Wähle „Abmelden“, um die aktuellen Anmeldedaten zu löschen.
Führe codex login status aus, um die aktive Authentifizierungsmethode anzuzeigen. Wenn du gespeicherte Anmeldedaten verwendest, kannst du sie mit codex logout löschen. Wählt der Prozess die Authentifizierung über eine Workload-Identität, lehnt Codex codex login und codex logout ab, da in diesem Fall die Prozessumgebung die Authentifizierung steuert.
Im Profilmenü siehst du das aktive Konto oder den Status des API-Schlüssels. Wähle „Abmelden“, um die aktuellen Anmeldedaten zu löschen.
Codex-Zugriffstoken für die Automatisierung im Unternehmen verwenden
In Workspaces von ChatGPT Enterprise kann die Workspace-Administration Mitgliedern die Berechtigung erteilen, Codex-Zugriffstoken zu erstellen. Berechtigte Mitglieder können damit vertrauenswürdige, nicht interaktive Codex-Workflows lokal ausführen. Verwende ein Zugriffstoken, wenn eine Automatisierung ohne Browseranmeldung auf einen ChatGPT-Workspace zugreifen, von ChatGPT verwaltete Codex-Nutzungsrechte in Anspruch nehmen oder den Zugriffsvorgaben eines Enterprise-Workspaces unterliegen soll.
Zugriffstoken sind für vertrauenswürdige Skripte, Aufgabenplaner und private CI-Runner vorgesehen. Verwende für allgemeine Aufrufe der OpenAI-API weiterhin API-Schlüssel der OpenAI Platform.
Die Anleitung Zugriffstoken beschreibt die Einrichtung, die erforderlichen Berechtigungen sowie die Rotation und den Widerruf von Token.
Wenn deine Umgebung bereits ein Codex-Zugriffstoken bereitstellt, übergib es per Pipe an die CLI:
printenv CODEX_ACCESS_TOKEN | codex login --with-access-token Dein Konto für Codex Cloud schützen
Codex Cloud greift direkt auf deine Codebasis zu und benötigt deshalb stärkere Schutzmaßnahmen als viele andere ChatGPT-Funktionen. Aktiviere die Multi-Faktor-Authentifizierung (MFA).
Wenn du dich über Google, Microsoft oder Apple anmeldest, musst du MFA für dein ChatGPT-Konto nicht aktivieren. Du kannst MFA bei deinem Anmeldeanbieter einrichten.
Hier findest du die Anleitungen der Anbieter:
Wenn du über Single Sign-on (SSO) auf ChatGPT zugreifst, sollte die SSO-Administration deiner Organisation MFA für alle Konten verbindlich vorschreiben.
Wenn du dich mit E-Mail-Adresse und Passwort anmeldest, musst du MFA für dein Konto einrichten, bevor du auf Codex Cloud zugreifst.
Wenn dein Konto mehrere Anmeldemethoden unterstützt und die Anmeldung mit E-Mail-Adresse und Passwort dazugehört, musst du MFA einrichten, bevor du auf Codex zugreifst. Das gilt auch, wenn du dich auf andere Weise anmeldest.
Anmeldedaten zwischenspeichern
Wenn du dich in der ChatGPT-Desktop-App, der Codex CLI oder der IDE-Erweiterung mit ChatGPT oder einem API-Schlüssel anmeldest, speichert Codex deine Anmeldedaten für die weitere Nutzung zwischen. Die CLI und die Erweiterung greifen auf dieselben zwischengespeicherten Anmeldedaten zu. Meldest du dich in einer der beiden ab, musst du dich beim nächsten Start der CLI oder der Erweiterung erneut anmelden.
Codex speichert deine Anmeldedaten lokal im Klartext in der Datei ~/.codex/auth.json oder im Anmeldedatenspeicher deines Betriebssystems.
Bei Sitzungen mit ChatGPT-Anmeldung erneuert Codex die Token während der Nutzung automatisch, bevor sie ablaufen. Aktive Sitzungen laufen daher in der Regel ohne erneute Anmeldung im Browser weiter.
Speicherort für Anmeldedaten
Mit cli_auth_credentials_store legst du fest, wo die Codex CLI Anmeldedaten zwischenspeichert:
# file | keyring | auto | ephemeral
cli_auth_credentials_store = "keyring"filespeichert die Anmeldedaten in der Dateiauth.jsonim VerzeichnisCODEX_HOME(standardmäßig~/.codex).keyringspeichert die Anmeldedaten im Anmeldedatenspeicher deines Betriebssystems. Ist dieser nicht verfügbar, schlägt der Vorgang fehl.autoverwendet den Anmeldedatenspeicher des Betriebssystems, sofern er verfügbar ist, und greift andernfalls aufauth.jsonzurück.ephemeralhält die Anmeldedaten ausschließlich für den aktuellen Prozess im Arbeitsspeicher.
Die Konfigurationsreferenz enthält das vollständige Schema für config.toml.
Die Administration kann cli_auth_credentials_store und chatgpt_base_url über lokale Authentifizierungsvorgaben verbindlich festlegen. Diese Vorgaben lassen sich weder über config.toml noch über die CLI überschreiben.
Wenn du Anmeldedaten in einer Datei speicherst, behandle ~/.codex/auth.json wie ein Passwort. Die Datei enthält Zugriffstoken. Nimm sie nicht in einen Commit auf, füge ihren Inhalt nicht in Tickets ein und teile sie nicht im Chat.
Anmeldemethode oder Workspace verbindlich vorgeben
In verwalteten Umgebungen kann die Administration einschränken, wie sich Personen anmelden dürfen:
# Only allow ChatGPT login or only allow API key login.
forced_login_method = "chatgpt" # or "api"
# When using ChatGPT login, restrict users to a specific workspace.
forced_chatgpt_workspace_id = "00000000-0000-0000-0000-000000000000"Entsprechen die aktiven Anmeldedaten nicht den konfigurierten Vorgaben, meldet Codex die betreffende Person ab und beendet sich.
Diese Einstellungen lassen sich auch über die ältere verwaltete Konfiguration vorgeben. Wie die Administration Anmeldebeschränkungen durchsetzt, erfährst du unter Authentifizierung lokal verwalten.
Anmeldeprobleme diagnostizieren
Wenn du codex login direkt ausführst, schreibt der Befehl eine eigene Protokolldatei namens codex-login.log in dein konfiguriertes Protokollverzeichnis. Verwende die Datei, um Fehler bei der Anmeldung über den Browser oder mit Gerätecode zu untersuchen oder wenn der Support Protokolle zur Anmeldung anfordert.
Eigene CA-Zertifikatsbündel
Wenn dein Netzwerk einen TLS-Proxy des Unternehmens oder eine private Stammzertifizierungsstelle verwendet, gib vor der Anmeldung in CODEX_CA_CERTIFICATE den Pfad zu einem PEM-Zertifikatsbündel an. Ist CODEX_CA_CERTIFICATE nicht gesetzt, greift Codex auf SSL_CERT_FILE zurück. Diese CA-Einstellungen gelten für die Anmeldung, reguläre HTTPS-Anfragen und sichere WebSocket-Verbindungen.
export CODEX_CA_CERTIFICATE=/path/to/corporate-root-ca.pem
codex loginAnmeldung auf Geräten ohne grafische Oberfläche
Wenn du dich über die Codex CLI bei ChatGPT anmeldest, funktioniert die Anmeldung im Browser unter Umständen nicht:
- Du führst die CLI in einer Remote-Umgebung oder einer Umgebung ohne grafische Oberfläche aus.
- Deine lokale Netzwerkkonfiguration blockiert den localhost-Callback, über den Codex das OAuth-Token nach der Anmeldung an die CLI zurückgibt.
Verwende in diesen Fällen vorzugsweise die Authentifizierung mit Gerätecode (Beta). Wähle in der interaktiven Anmeldeoberfläche „Mit Gerätecode anmelden“ oder führe direkt codex login --device-auth aus. Falls die Authentifizierung mit Gerätecode in deiner Umgebung nicht funktioniert, nutze eine der alternativen Methoden.
Empfohlen: Authentifizierung mit Gerätecode (Beta)
- Aktiviere die Anmeldung mit Gerätecode in den ChatGPT-Sicherheitseinstellungen deines persönlichen Kontos oder, wenn du den Workspace verwaltest, in den Berechtigungen des ChatGPT-Workspaces.
- Wähle im Terminal, in dem du Codex ausführst, eine der folgenden Möglichkeiten:
- Wähle in der interaktiven Anmeldeoberfläche „Mit Gerätecode anmelden“.
- Führe
codex login --device-authaus.
- Öffne den Link im Browser, melde dich an und gib dann den Einmalcode ein.
Wenn die Anmeldung mit Gerätecode in deiner Umgebung nicht verfügbar ist, nutze eine der folgenden Alternativen.
Alternative: Lokal anmelden und zwischengespeicherte Anmeldedaten kopieren
Wenn du die Anmeldung auf einem Rechner mit Browser abschließen kannst, kannst du die zwischengespeicherten Anmeldedaten auf den Rechner ohne grafische Oberfläche kopieren.
- Führe auf einem Rechner, auf dem du dich im Browser anmelden kannst,
codex loginaus. - Prüfe, ob die Datei mit den zwischengespeicherten Anmeldedaten unter
~/.codex/auth.jsonvorhanden ist. - Kopiere
~/.codex/auth.jsonauf den Rechner ohne grafische Oberfläche und lege die Datei dort unter~/.codex/auth.jsonab.
Behandle ~/.codex/auth.json wie ein Passwort. Die Datei enthält Zugriffstoken. Nimm sie nicht in einen Commit auf, füge ihren Inhalt nicht in Tickets ein und teile sie nicht im Chat.
Wenn dein Betriebssystem die Anmeldedaten im eigenen Anmeldedatenspeicher statt in ~/.codex/auth.json ablegt, eignet sich diese Methode möglicherweise nicht. Wie du die dateibasierte Speicherung konfigurierst, erfährst du unter Speicherort für Anmeldedaten.
So kopierst du die Datei per SSH auf einen entfernten Rechner:
ssh user@remote 'mkdir -p ~/.codex'
scp ~/.codex/auth.json user@remote:~/.codex/auth.jsonAlternativ kannst du die Datei ohne scp mit einem einzigen Befehl kopieren:
ssh user@remote 'mkdir -p ~/.codex && cat > ~/.codex/auth.json' < ~/.codex/auth.jsonSo kopierst du die Datei in einen Docker-Container:
# Replace MY_CONTAINER with the name or ID of your container.
CONTAINER_HOME=$(docker exec MY_CONTAINER printenv HOME)
docker exec MY_CONTAINER mkdir -p "$CONTAINER_HOME/.codex"
docker cp ~/.codex/auth.json MY_CONTAINER:"$CONTAINER_HOME/.codex/auth.json"Eine erweiterte Variante dieses Verfahrens für vertrauenswürdige CI/CD-Runner findest du unter Codex-Kontoanmeldung in CI/CD aufrechterhalten (für Fortgeschrittene). Die Anleitung erklärt, wie du Codex die Datei auth.json bei regulären Ausführungen aktualisieren lässt und sie für den nächsten Job aufbewahrst. Für die Automatisierung sind API-Schlüssel weiterhin die empfohlene Standardmethode.
Alternative: Den localhost-Callback über SSH weiterleiten
Wenn du Ports zwischen deinem lokalen Rechner und dem Remote-Host weiterleiten kannst, kannst du die reguläre Anmeldung im Browser verwenden. Richte dazu einen SSH-Tunnel zum lokalen Callback-Server von Codex ein (standardmäßig localhost:1455).
- Starte die Portweiterleitung auf deinem lokalen Rechner:
ssh -L 1455:localhost:1455 user@remote- Führe in dieser SSH-Sitzung
codex loginaus und öffne die ausgegebene Adresse auf deinem lokalen Rechner.
Alternative Modellanbieter
Wenn du in deiner Konfigurationsdatei einen eigenen Modellanbieter definierst, kannst du eine der folgenden Authentifizierungsmethoden wählen:
- OpenAI-Authentifizierung: Setze
requires_openai_auth = true, um die OpenAI-Authentifizierung zu verwenden. Anschließend kannst du dich mit ChatGPT oder einem API-Schlüssel anmelden. Das ist nützlich, wenn du über einen LLM-Proxyserver auf OpenAI-Modelle zugreifst. Beirequires_openai_auth = trueignoriert Codexenv_key. - Authentifizierung über eine Umgebungsvariable: Setze
env_key = "<ENV_VARIABLE_NAME>", um einen anbieterspezifischen API-Schlüssel aus der lokalen Umgebungsvariablen mit dem Namen<ENV_VARIABLE_NAME>zu verwenden. - Natives Gateway-OAuth: Konfiguriere
[model_providers.<id>.gateway_oauth]für die Browseranmeldung über den Identitätsanbieter deiner Organisation. Das funktioniert mit und ohne ChatGPT-Anmeldung. Die Anforderungen an das Gateway und Hinweise zur Konfiguration findest du unter Natives Gateway-OAuth. - Authentifizierung per Befehl: Konfiguriere
[model_providers.<id>.auth], um ein Token von einem installierten Hilfsprogramm für Anmeldedaten abzurufen. - Keine Authentifizierung: Bei einem lokalen Modell, das keine Anmeldedaten benötigt, kannst du
requires_openai_authungesetzt lassen oder auffalsesetzen. Lass alle Einstellungen für Anmeldedaten weg, darunterenv_key,experimental_bearer_token,authundgateway_oauth.