Den vollständigen Index der Dokumentation findest du in llms.txt. Die Markdown-Version einer Dokumentationsseite erhältst du, indem du .md an die URL der Seite anhängst.
Hauptnavigation
Design

Zusammenarbeiten und teilen

Authentifizierung

Anmeldemethoden für ChatGPT im Web und Codex-Clients

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:

  1. Melde dich mit ChatGPT bei einem Workspace an, der diese Funktion unterstützt.

  2. 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-Desktop-App

Wähle auf dem Anmeldebildschirm „Weiter zur Anmeldung“ 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“.

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

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.

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"
  • file speichert die Anmeldedaten in der Datei auth.json im Verzeichnis CODEX_HOME (standardmäßig ~/.codex).
  • keyring speichert die Anmeldedaten im Anmeldedatenspeicher deines Betriebssystems. Ist dieser nicht verfügbar, schlägt der Vorgang fehl.
  • auto verwendet den Anmeldedatenspeicher des Betriebssystems, sofern er verfügbar ist, und greift andernfalls auf auth.json zurück.
  • ephemeral hä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.

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. Bei requires_openai_auth = true ignoriert Codex env_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_auth ungesetzt lassen oder auf false setzen. Lass alle Einstellungen für Anmeldedaten weg, darunter env_key, experimental_bearer_token, auth und gateway_oauth.