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

Codex-Konfiguration für dein Team selbst hosten

Stelle Standardwerte und verbindliche Einstellungen für Codex über einen eigenen HTTPS-Endpunkt bereit.

Wir empfehlen deinem Team, sich mit ChatGPT bei Codex anzumelden. Wenn dein Plan die verwaltete Konfiguration unterstützt, kannst du in der Admin-Konsole unter Agent security Standardwerte festlegen und Vorgaben durchsetzen, ohne einen eigenen Server zu betreiben.

Wenn die Mitglieder deines Teams ChatGPT nicht zur Anmeldung bei Codex verwenden, kannst du die Konfiguration für Codex CLI und die Desktop-App über einen eigenen HTTPS-Server verteilen. Codex lädt deine Einstellungen beim Start, unabhängig davon, ob die Teammitglieder die Verbindung zu ihrem Modellanbieter direkt oder über ein Gateway herstellen.

Einschränkungen der Clients

Die Desktop-App kann dich nicht zur Anmeldung beim Konfigurationsserver auffordern. Wenn dein Server eine erneute Anmeldung verlangt, führe codex login in einem Terminal auf demselben Computer aus und öffne die App anschließend erneut. Kann die App die erforderlichen Einstellungen nicht laden, pausiert der Startvorgang.

Codex für die Nutzung des Servers konfigurieren

Erstelle oder aktualisiere auf einem Testrechner die systemweite Datei requirements.toml. Füge eine Tabelle [config_server] mit der Basis-URL deines Konfigurationsservers hinzu. Verwende unter Linux und macOS den Pfad /etc/codex/requirements.toml und unter Windows den Pfad %ProgramData%\OpenAI\Codex\requirements.toml. Unter macOS kannst du die Tabelle auch über verwaltete Einstellungen verteilen.

[config_server]
base_url = "https://codex-config.example.com/team"

Der Server lässt sich ausschließlich über lokale Vorgaben festlegen, die von der Systemadministration verwaltet werden. Belasse diese Tabelle auf dem Computer, wenn du den Rest deiner Richtlinie über den Endpunkt bereitstellst.

Anmeldung beim Konfigurationsserver einrichten (optional)

Standardmäßig versucht Codex, die Konfiguration ohne Anmeldedaten abzurufen. Wenn dein Server eine Anmeldung verlangt, ergänze [config_server.oauth] in derselben Datei requirements.toml. Codex verwendet den OAuth Authorization Code Flow mit Proof Key for Code Exchange (PKCE).

[config_server.oauth]
authorization_url = "https://login.example.com/oauth/authorize"
token_url = "https://login.example.com/oauth/token"
client_id = "codex-policy"
redirect_port = 43127

Die Weiterleitungs-URI lautet in diesem Beispiel http://127.0.0.1:43127/callback. Du kannst redirect_port weglassen, wenn dein Anbieter einen Loopback-Callback auf einem beliebigen freien Port akzeptiert. Codex sendet das Zugriffstoken im Header Authorization. Dein Server muss das Token prüfen, bevor er das Konfigurationspaket zurückgibt.

Codex-Konfiguration bereitstellen

Stelle deine verwaltete Konfiguration über einen HTTPS-Endpunkt bereit. Beim Abruf des Pakets sendet Codex CLI eine GET-Anfrage mit der Basis-URL aus der lokalen Datei requirements.toml:

GET {config_server.base_url}/codex/config/bundle

Mit der base_url aus dem obigen Beispiel für die Erstkonfiguration sendet Codex folgende Anfrage:

GET https://codex-config.example.com/team/codex/config/bundle

Antworte mit dem Status 200 OK und einem Konfigurationspaket im JSON-Format im Antworttext.

Format des Konfigurationspakets

Das Paket fasst TOML-Einträge in zwei Arrays zusammen:

Jeder Array-Eintrag hat drei Zeichenkettenfelder: id, name (der Anzeigename) und contents. Verwende für eine Kategorie, die du nicht benötigst, ein leeres Array.

Dieses Beispiel setzt den Standardwert für die Websuche auf disabled und erzwingt diesen Wert mit allowed_web_search_modes.

{
  "config_toml": {
    "enterprise_managed": [
      {
        "id": "search-default",
        "name": "Default web search",
        "contents": "web_search = 'disabled'"
      }
    ]
  },
  "requirements_toml": {
    "enterprise_managed": [
      {
        "id": "search-policy",
        "name": "Allowed web search modes",
        "contents": "allowed_web_search_modes = ['disabled']"
      }
    ]
  }
}

Konfiguration in Codex überprüfen

  1. Öffne auf einem Testrechner ein Terminal in deinem Projektverzeichnis und führe codex aus. Melde dich mit deinem Unternehmenskonto an, wenn du dazu aufgefordert wirst.
  2. Gib an der interaktiven Eingabeaufforderung von Codex CLI /debug-config ein und drücke die Eingabetaste.
  3. Wenn du Standardwerte bereitstellst, suche unter Config layer stack nach ihren Namen und IDs. Wenn du das obige Beispiel verwendest, suche nach enterprise-managed (Default web search, search-default) (enabled).
  4. Wenn du Vorgaben bereitstellst, suche unter Requirements nach einer Einstellung, die du erzwingst, und prüfe die daneben angegebene Richtlinienquelle.

Codex kann mit zwischengespeicherten Einstellungen starten und sie im Hintergrund aktualisieren. Wenn du eine Richtlinie auf dem Server änderst, warte, bis Codex die aktualisierte Richtlinie abgerufen hat. Starte dann eine neue Sitzung und wiederhole die Prüfung, bevor du die Richtlinie auf weitere Rechner ausrollst.