Authentifizierung
Anmeldemethoden für ChatGPT im Web und Codex-Clients
- ChatGPT-Desktop-App Projekte, Dateien und längere Aufgaben auf dem Desktop.
- ChatGPT im Web Chats, Projekte und Work in Ihrem Browser.
- Codex CLI Codex in Ihrem Terminal.
- Codex-IDE-Erweiterung Codex in Ihrem Editor.
Wie Sie einen lokalen Client mit oder ohne ChatGPT-Anmeldung mit dem Gateway Ihrer Organisation verbinden, erfahren Sie unter Mit einem Gateway verbinden. Der direkte Zugriff auf Bedrock verwendet die Authentifizierungsoptionen für Amazon Bedrock.
OpenAI-Authentifizierung
Codex unterstützt zwei Möglichkeiten, wie sich eine Person bei der Verwendung von OpenAI-Modellen anmelden kann:
- Mit ChatGPT anmelden, um Zugriff über ein Abonnement zu erhalten
- Mit einem API key anmelden, um nutzungsbasierten Zugriff zu erhalten
Die ChatGPT-Desktop-App, Codex CLI und die IDE-Erweiterung unterstützen beide Anmeldeverfahren für die lokale Arbeit. Codex cloud erfordert die Anmeldung mit ChatGPT.
Ihre Anmeldemethode bestimmt außerdem, welche administrativen Kontrollen und Richtlinien für die Datenverarbeitung gelten.
- Wenn Sie sich mit ChatGPT anmelden, gelten für die Codex-Nutzung die Berechtigungen Ihres ChatGPT-Arbeitsbereichs, die rollenbasierte Zugriffskontrolle (RBAC) sowie die Einstellungen von ChatGPT Enterprise für Aufbewahrung und Datenresidenz.
- Bei Verwendung eines API key gelten stattdessen die Einstellungen Ihrer API-Organisation für Aufbewahrung und Datenfreigabe.
Bei verwalteten Arbeitsbereichen ist die Authentifizierung nur eine Ebene der Zugriffssteuerung. Die Mitgliedschaft im Arbeitsbereich und die Bereitstellung bestimmen, wer sich anmelden kann, während Lizenzplätze und Arbeitsbereichsrollen bestimmen, welche Produktoberflächen und Funktionen verwendet werden können. Bei der lokalen Arbeit in der ChatGPT-Desktop-App, Codex CLI oder der IDE-Erweiterung schränken Berechtigungsprofile ein, was der Agent auf dem Gerät tun kann. Weitere Informationen zur Planung dieser Kontrollen finden Sie unter Gruppen und Bereitstellung und Rollen und Arbeitsbereichsberechtigungen.
Mit ChatGPT anmelden
So nutzen Sie den Zugriff auf lokale Computer mit Work Cloud auf dem Desktop, auf Mobilgeräten und im Web:
Melden Sie sich mit ChatGPT bei einem berechtigten Arbeitsbereich an.
Bitten Sie einen Arbeitsbereichsinhaber, Work Cloud zu aktivieren und anschließend unter Work Cloud Allow local computer access einzuschalten. Use Codex locally on the ChatGPT desktop app ist keine Voraussetzung.
API keys und Codex-Zugriffstokens ermöglichen keinen Zugriff auf lokale Computer mit Work Cloud. Informationen zu den Voraussetzungen finden Sie unter Rollen und Arbeitsbereichsberechtigungen und in den Work-FAQ für Administratoren. Hinweise zur Einrichtung finden Sie unter Zugriff auf lokale Computer für Work Cloud und dots.
Wenn Sie sich über die ChatGPT-Desktop-App, Codex CLI oder die IDE-Erweiterung mit ChatGPT anmelden, öffnet der Anmeldevorgang ein Browserfenster. Nach Ihrer Anmeldung übermittelt der Browser Ihre Anmeldedaten an Codex.
ChatGPT im Web
Öffnen Sie ChatGPT, melden Sie sich an und wählen Sie den Arbeitsbereich, in dem Sie arbeiten möchten. ChatGPT im Web speichert die authentifizierte Sitzung in Ihrem Browser.
ChatGPT-Desktop-App
Wählen Sie auf dem Bildschirm im abgemeldeten Zustand Continue to sign in aus und schließen Sie anschließend den Vorgang im Browser ab.
Codex CLI
Führen Sie codex login aus und schließen Sie anschließend den Vorgang im Browser ab. Dies ist der standardmäßige
Authentifizierungsweg, wenn keine gültige Sitzung verfügbar ist.
IDE-Erweiterung
Wählen Sie auf dem Bildschirm im abgemeldeten Zustand Sign in with ChatGPT und schließen Sie anschließend den Vorgang im Browser ab.
Mit einem API key anmelden
Sie können sich auch mit einem API key bei der ChatGPT-Desktop-App, Codex CLI oder der IDE-Erweiterung anmelden. Ihren API key erhalten Sie im OpenAI-Dashboard.
ChatGPT-Desktop-App
Wählen Sie auf dem Bildschirm im abgemeldeten Zustand Sign in another way aus, geben Sie Ihren Schlüssel ein und wählen Sie anschließend Continue aus.
Codex CLI
Übergeben Sie den Schlüssel per Pipe über stdin an codex login:
printenv OPENAI_API_KEY | codex login --with-api-keyIDE-Erweiterung
Wählen Sie auf dem Bildschirm im abgemeldeten Zustand Use API Key, geben Sie Ihren Schlüssel ein und wählen Sie anschließend OK.
OpenAI rechnet die Nutzung mit einem API key über Ihr OpenAI Platform-Konto zu den standardmäßigen API-Tarifen ab. Weitere Informationen finden Sie auf der Seite mit den API-Preisen.
Die Authentifizierung mit einem API key unterstützt lokale Codex-Workflows, einige Funktionen, die Zugriff auf den ChatGPT-Arbeitsbereich oder Cloud-Dienste voraussetzen, sind jedoch eingeschränkt oder nicht verfügbar. Vergleichen Sie die Unterstützung nach Tarif unter Funktionsverfügbarkeit.
In Codex CLI und Codex in der ChatGPT-Desktop-App umfasst die Authentifizierung per API key auch den Zugriff auf unterstützte, von OpenAI kuratierte Plugins. Einige Plugins sind nicht verfügbar, da ihre Verbindungsabläufe nicht unterstützte OAuth-Funktionen erfordern. Siehe Plugins verwenden.
Wenn Sie sich mit einem API key anmelden, verwendet Codex die standardmäßigen API-Preise anstelle der in Ihrem ChatGPT-Tarif enthaltenen Guthaben.
Verwenden Sie die Authentifizierung mit einem API key für programmatische Codex CLI-Workflows, beispielsweise CI/CD-Aufträge. Stellen Sie die Ausführung von Codex nicht in nicht vertrauenswürdigen oder öffentlichen Umgebungen bereit.
Authentifizierung prüfen oder abmelden
Öffnen Sie das Profilmenü, um das aktive Konto und den Arbeitsbereich zu überprüfen. Um die ChatGPT-Websitzung in diesem Browser zu beenden, wählen Sie Log out.
Öffnen Sie das Profilmenü, um das aktive Konto oder den Status des API key anzuzeigen. Wählen Sie Abmelden, um die aktuellen Zugangsdaten zu löschen.
Führen Sie codex login status aus, um die aktive Authentifizierungsmethode anzuzeigen. Bei gespeicherter
Authentifizierung führen Sie codex logout aus, um die aktuellen Zugangsdaten zu löschen. Wenn
der Prozess die Workload-Identität auswählt, lehnt Codex codex login und
codex logout ab, da die Prozessumgebung die Authentifizierung steuert.
Öffnen Sie das Profilmenü, um das aktive Konto oder den Status des API key anzuzeigen. Wählen Sie Abmelden, um die aktuellen Zugangsdaten zu löschen.
Codex-Zugriffstoken für die Unternehmensautomatisierung verwenden
In ChatGPT Enterprise-Arbeitsbereichen können Administratoren die Berechtigung für Zugriffstoken erteilen, sodass berechtigte Mitglieder Codex-Zugriffstoken für vertrauenswürdige, nicht interaktive lokale Codex-Workflows erstellen können. Verwenden Sie ein Zugriffstoken, wenn die Automatisierung Zugriff auf den ChatGPT-Arbeitsbereich, von ChatGPT verwaltete Codex-Berechtigungen oder Kontrollen des Unternehmensarbeitsbereichs ohne Anmeldung über einen Browser benötigt.
Zugriffstoken sind für vertrauenswürdige Skripte, Zeitplaner und private CI-Runner vorgesehen. Verwenden Sie für allgemeine OpenAI API-Aufrufe weiterhin Platform API keys.
Informationen zur Einrichtung, zu Berechtigungen, Rotation und Widerruf finden Sie unter Zugriffstoken.
Wenn Ihre Umgebung bereits ein Codex-Zugriffstoken bereitstellt, übergeben Sie es per Pipe an die CLI:
printenv CODEX_ACCESS_TOKEN | codex login --with-access-tokenIhr Codex cloud-Konto schützen
Codex cloud interagiert direkt mit Ihrer Codebasis und benötigt daher stärkere Sicherheitsmaßnahmen als viele andere ChatGPT-Funktionen. Aktivieren Sie die Multi-Faktor-Authentifizierung (MFA).
Wenn Sie einen Anbieter für die Anmeldung über ein soziales Konto verwenden (Google, Microsoft, Apple), müssen Sie MFA für Ihr ChatGPT-Konto nicht aktivieren, können sie jedoch bei Ihrem Anbieter für die soziale Anmeldung einrichten.
Anleitungen zur Einrichtung finden Sie hier:
Wenn Sie über Single Sign-On (SSO) auf ChatGPT zugreifen, sollte der SSO-Administrator Ihrer Organisation MFA für alle Benutzer erzwingen.
Wenn Sie sich mit einer E-Mail-Adresse und einem Passwort anmelden, müssen Sie MFA für Ihr Konto einrichten, bevor Sie auf Codex cloud zugreifen können.
Wenn Ihr Konto mehrere Anmeldemethoden unterstützt und eine davon E-Mail-Adresse und Passwort ist, müssen Sie MFA einrichten, bevor Sie auf Codex zugreifen können, auch wenn Sie sich auf andere Weise anmelden.
Zwischenspeicherung der Anmeldung
Wenn Sie sich bei der ChatGPT-Desktop-App, Codex CLI oder der IDE-Erweiterung mit ChatGPT oder einem API key anmelden, werden Ihre Anmeldedaten zwischengespeichert und wiederverwendet. CLI und Erweiterung verwenden dieselben zwischengespeicherten Anmeldedaten. Wenn Sie sich bei einer der beiden Komponenten abmelden, müssen Sie sich beim nächsten Start von CLI oder Erweiterung erneut anmelden.
Codex speichert Anmeldedaten lokal in einer Klartextdatei unter ~/.codex/auth.json oder im betriebssystemspezifischen Anmeldedatenspeicher.
Bei Sitzungen, für die Sie sich mit ChatGPT anmelden, aktualisiert Codex die Token während der Nutzung automatisch, bevor sie ablaufen. Aktive Sitzungen werden daher in der Regel fortgesetzt, ohne dass eine erneute Anmeldung über den Browser erforderlich ist.
Speicherung von Anmeldedaten
Mit cli_auth_credentials_store steuern Sie, wo Codex CLI zwischengespeicherte Anmeldedaten ablegt:
# file | keyring | auto | ephemeral
cli_auth_credentials_store = "keyring"filespeichert Anmeldedaten inauth.jsonunterCODEX_HOME(standardmäßig~/.codex).keyringspeichert Anmeldedaten im Anmeldedatenspeicher Ihres Betriebssystems und schlägt fehl, wenn dieser nicht verfügbar ist.autoverwendet den Anmeldedatenspeicher des Betriebssystems, sofern verfügbar, und greift andernfalls aufauth.jsonzurück.ephemeralhält Anmeldedaten ausschließlich für den aktuellen Prozess im Arbeitsspeicher.
Das vollständige Schema für
config.toml finden Sie in der Konfigurationsreferenz.
Administratoren können cli_auth_credentials_store und chatgpt_base_url über
lokale Authentifizierungsanforderungen erzwingen.
Benutzer können diese Anforderungen weder über config.toml noch über CLI-Überschreibungen außer Kraft setzen.
Anmeldemethode oder Arbeitsbereich erzwingen
In verwalteten Umgebungen können Administratoren einschränken, wie sich Benutzer authentifizieren 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"Wenn die aktiven Anmeldedaten nicht den konfigurierten Einschränkungen entsprechen, meldet Codex den Benutzer ab und wird beendet.
Diese Einstellungen können auch über die ältere verwaltete Konfiguration bereitgestellt werden. Informationen zu von Administratoren erzwungenen Anmeldebeschränkungen finden Sie unter Authentifizierung lokal verwalten.
Anmeldediagnose
Direkte Aufrufe von codex login schreiben eine eigene Datei namens codex-login.log in
Ihr konfiguriertes Protokollverzeichnis. Verwenden Sie diese Datei zur Fehleranalyse bei der Browser-Anmeldung oder beim
Gerätecode-Verfahren oder wenn der Support anmeldespezifische Protokolle anfordert.
Benutzerdefinierte CA bundle
Wenn Ihr Netzwerk einen unternehmenseigenen TLS-Proxy oder eine private Stammzertifizierungsstelle verwendet, setzen Sie
CODEX_CA_CERTIFICATE vor der Anmeldung auf ein PEM bundle. Wenn
CODEX_CA_CERTIFICATE nicht gesetzt ist, greift Codex auf SSL_CERT_FILE zurück. Dieselben
benutzerdefinierten CA-Einstellungen gelten für die Anmeldung, normale 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 Sie sich über die Codex CLI bei ChatGPT anmelden, funktioniert die browserbasierte Anmeldeoberfläche in bestimmten Situationen möglicherweise nicht:
- Sie führen die CLI in einer Remote-Umgebung oder einer Umgebung ohne grafische Oberfläche aus.
- Ihre lokale Netzwerkkonfiguration blockiert den localhost-Callback, mit dem Codex das OAuth-Token nach der Anmeldung an die CLI zurückgibt.
Verwenden Sie in diesen Situationen vorzugsweise die Authentifizierung per Gerätecode (Beta). Wählen Sie in der interaktiven Anmeldeoberfläche Sign in with Device Code aus oder führen Sie codex login --device-auth direkt aus. Wenn die Authentifizierung per Gerätecode in Ihrer Umgebung nicht funktioniert, verwenden Sie eine der alternativen Methoden.
Bevorzugt: Authentifizierung per Gerätecode (Beta)
- Aktivieren Sie die Anmeldung per Gerätecode in Ihren ChatGPT-Sicherheitseinstellungen (persönliches Konto) oder in den ChatGPT-Workspace-Berechtigungen (als Workspace-Administrator).
- Wählen Sie im Terminal, in dem Sie Codex ausführen, eine dieser Optionen:
- Wählen Sie in der interaktiven Anmeldeoberfläche Sign in with Device Code aus.
- Führen Sie
codex login --device-authaus.
- Öffnen Sie den Link in Ihrem Browser, melden Sie sich an und geben Sie anschließend den Einmalcode ein.
Wenn die Anmeldung per Gerätecode in Ihrer Umgebung nicht verfügbar ist, verwenden Sie eine der folgenden alternativen Methoden.
Alternative: Lokal authentifizieren und den Authentifizierungscache kopieren
Wenn Sie den Anmeldevorgang auf einem Rechner mit Browser abschließen können, können Sie Ihre zwischengespeicherten Anmeldedaten auf den Rechner ohne grafische Oberfläche kopieren.
- Führen Sie auf einem Rechner, auf dem Sie den browserbasierten Anmeldevorgang nutzen können,
codex loginaus. - Vergewissern Sie sich, dass der Anmeldecache unter
~/.codex/auth.jsonvorhanden ist. - Kopieren Sie
~/.codex/auth.jsonnach~/.codex/auth.jsonauf dem Rechner ohne grafische Oberfläche.
Behandeln Sie ~/.codex/auth.json wie ein Passwort: Die Datei enthält Zugriffstoken. Nehmen Sie sie nicht in Commits auf, fügen Sie sie nicht in Tickets ein und teilen Sie sie nicht im Chat.
Wenn Ihr Betriebssystem Anmeldedaten in einem Anmeldedatenspeicher statt in ~/.codex/auth.json speichert, ist diese Methode möglicherweise nicht anwendbar. Unter
Speicherung von Anmeldedaten erfahren Sie, wie Sie die dateibasierte Speicherung konfigurieren.
Über SSH auf einen Remote-Rechner kopieren:
ssh user@remote 'mkdir -p ~/.codex'
scp ~/.codex/auth.json user@remote:~/.codex/auth.jsonOder verwenden Sie einen Einzeiler, der ohne scp auskommt:
ssh user@remote 'mkdir -p ~/.codex && cat > ~/.codex/auth.json' < ~/.codex/auth.jsonIn einen Docker-Container kopieren:
# 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 Vorgehens für vertrauenswürdige CI/CD-Runner finden Sie unter
Codex-Kontoauthentifizierung in CI/CD aufrechterhalten (für Fortgeschrittene).
Diese Anleitung erläutert, wie Sie Codex die Datei auth.json während normaler Ausführungen aktualisieren lassen und
anschließend die aktualisierte Datei für den nächsten Job aufbewahren. API keys bleiben die empfohlene
Standardoption für die Automatisierung.
Alternative: Den localhost-Callback über SSH weiterleiten
Wenn Sie Ports zwischen Ihrem lokalen Rechner und dem Remote-Host weiterleiten können, können Sie den standardmäßigen browserbasierten Ablauf nutzen, indem Sie den lokalen Callback-Server von Codex (standardmäßig localhost:1455) tunneln.
- Starten Sie die Portweiterleitung von Ihrem lokalen Rechner aus:
ssh -L 1455:localhost:1455 user@remote- Führen Sie in dieser SSH-Sitzung
codex loginaus und öffnen Sie die ausgegebene Adresse auf Ihrem lokalen Rechner.
Alternative Modellanbieter
Wenn Sie in Ihrer Konfigurationsdatei einen benutzerdefinierten Modellanbieter definieren, können Sie eine der folgenden Authentifizierungsmethoden auswählen:
- OpenAI-Authentifizierung: Legen Sie
requires_openai_auth = truefest, um die OpenAI-Authentifizierung zu verwenden. Anschließend können Sie sich mit ChatGPT oder einem API key anmelden. Dies ist hilfreich, wenn Sie über einen LLM-Proxyserver auf OpenAI-Modelle zugreifen. Wennrequires_openai_auth = true, ignoriert Codexenv_key. - Authentifizierung über Umgebungsvariablen: Legen Sie
env_key = "<ENV_VARIABLE_NAME>"fest, um einen anbieterspezifischen API key aus der lokalen Umgebungsvariablen namens<ENV_VARIABLE_NAME>zu verwenden. - Natives Gateway-OAuth: Konfigurieren Sie
[model_providers.<id>.gateway_oauth]für die Browseranmeldung über den Identitätsanbieter Ihrer Organisation. Dies funktioniert mit oder ohne ChatGPT-Anmeldung. Die Gateway-Anforderungen und die Konfiguration finden Sie unter Natives Gateway-OAuth. - Befehlsbasierte Authentifizierung: Konfigurieren Sie
[model_providers.<id>.auth], um ein Token von einem installierten Hilfsprogramm für Anmeldedaten abzurufen. - Keine Authentifizierung: Lassen Sie für ein lokales Modell, das keine Anmeldedaten benötigt,
requires_openai_authungesetzt oder auffalseund lassen Sie Einstellungen für Anmeldedaten weg, einschließlichenv_key,experimental_bearer_token,authundgateway_oauth.