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

Windows-App und Codex CLI bereitstellen

Stelle die Windows-Desktop-App und Codex CLI mit Intune, SCCM oder einem anderen Verwaltungstool für Unternehmen bereit.

Auf verwalteten Windows-Geräten kannst du die Windows-Desktop-App, Codex CLI oder beides bereitstellen. Wähle die App für den Zugriff über den Desktop oder die CLI für den Zugriff über das Terminal.

Die Desktop-App und die eigenständige CLI verwenden unterschiedliche Installationskontexte. Lege vor der Bereitstellung der CLI fest, unter welchem Konto das Installationsprogramm laufen soll, und teste die Installation mit diesem Konto.

Dein Ziel Einstieg
Die Desktop-App verteilen Windows-App bereitstellen
Mitarbeitenden unabhängig von der App Zugriff über das Terminal ermöglichen Codex CLI unter Windows bereitstellen
Vorgaben für Codex unter Windows durchsetzen Verwaltete Vorgaben konfigurieren
Windows für die Ausführung von Befehlen vorbereiten Windows-Sandbox konfigurieren

Windows-App bereitstellen

Wähle die Methode passend zu deinem Verwaltungstool. Berücksichtige dabei, ob die Geräte auf die Verteilungsdienste von Microsoft zugreifen können.

Konfiguriere vor der Bereitstellung die relevanten Steuerungsmöglichkeiten anhand der Anleitung zur verwalteten Konfiguration. Damit Codex in der Desktop-App Befehle ausführen kann, folge der Anleitung zum Setup der Windows-Sandbox. Prüfe die Gerätekompatibilität und führe bei Bedarf das Setup für die ältere Sandbox-Implementierung durch.

Über die folgenden MSIX-Links erhältst du für jede Architektur jeweils die neueste Version. Frühere Versionen stehen über diese Links nicht zur Verfügung. Prüfe das heruntergeladene Paket und bewahre das freigegebene Artefakt in deinem Bereitstellungssystem auf. Folge der Anleitung App-Updates verwalten, um die integrierte Updatefunktion der App mit Microsoft Store, Intune und anderen Bereitstellungstools abzustimmen.

Bereitstellungsmethode

Paketquelle

Paketquelle für Intune

Über den Microsoft Store bereitstellen

Nutze die Microsoft Store-Integration von Intune, um die App zu installieren und zu aktualisieren.

  1. Gehe im Intune Admin Center zu Apps > Alle Apps > Erstellen. Wähle Microsoft Store-App (neu) aus.

  2. Suche nach ChatGPT von OpenAI oder gib die Store-Produkt-ID 9PLM9XGG6VKS ein. Wähle die App aus und prüfe ihre Installationseinstellungen.

  3. Setze unter App-Informationen das Installationsverhalten auf System.

  4. Füge unter Erforderlich deine Zielgruppe hinzu, damit Intune die App automatisch installiert. Wähle anschließend Erstellen aus.

Wenn die Installation über das Unternehmensportal optional sein soll, wähle stattdessen Für registrierte Geräte verfügbar aus.

Die Geräte benötigen Zugriff auf die Endpunkte für den Microsoft Store und Windows Update, die Microsoft in den Netzwerkanforderungen aufführt. Sind diese Endpunkte gesperrt, wähle Offline-MSIX aus.

Weitere Informationen zum Installationskontext, zu den Netzwerkanforderungen und zur Überwachung der Bereitstellung findest du in Microsofts Anleitung für Store-Apps in Intune.

Codex CLI unter Windows bereitstellen

Bereite das CLI-Paket vor, wende deine Geräterichtlinie an und prüfe den Zugriff über das Terminal mit dem Konto der jeweiligen Person.

Bevor du beginnst

  • Ermittle, für welche Windows-Geräte und Personen du die CLI bereitstellen möchtest und welche Prozessorarchitekturen die Geräte verwenden. Wähle dann eine Installationsmethode. Prüfe, ob die Mitarbeitenden Zugriff auf Codex haben und sich nach dem Verfahren deiner Organisation anmelden können.

  • Für Intune benötigst du Berechtigungen zur App-Verwaltung, registrierte Geräte, die Microsofts Voraussetzungen für die Win32-Paketierung erfüllen, und ein Paket für die unbeaufsichtigte Installation.

  • Lege fest, wer für Updates und die Deinstallation der CLI zuständig ist. Wenn du npm verwendest, berücksichtige die verwaltete Installation von Node.js und npm sowie den Speicherort für globale npm-Pakete.

Installationsmethode auswählen

Wähle eine Installationsmethode und eine konkrete CLI-Version. Sieh dir die CLI-Releases auf GitHub an. Ersetze anschließend in den Beispielen <approved-version> durch die freigegebene Versionsnummer im Format x.y.z. Verwende im Paket und in der Erkennungsregel dieselbe Version.

Ohne Versionsangabe verwendet das eigenständige Installationsprogramm standardmäßig latest. Gib mit -Release explizit an, welche Version bereitgestellt werden soll. Weitere Informationen findest du in der Beschreibung des Versionsparameters des Installationsprogramms. Allgemeine Hinweise findest du in der Anleitung zur CLI-Installation.

Eigenständiges PowerShell-Installationsprogramm. Lade das Installationsprogramm in einem neuen PowerShell-Fenster herunter und übergib ihm die freigegebene Version:

$CodexRelease = '<approved-version>'
Invoke-WebRequest -UseBasicParsing -Uri 'https://chatgpt.com/codex/install.ps1' -OutFile '.\codex-install.ps1'
powershell -ExecutionPolicy Bypass -File .\codex-install.ps1 -Release $CodexRelease

npm. Wenn Node.js und npm auf dem Gerät bereits zentral verwaltet werden, gib die freigegebene Paketversion explizit an:

$CodexRelease = '<approved-version>'
npm install -g "@openai/codex@$CodexRelease"

Nimm für die verwaltete Verteilung das geprüfte Installationsprogramm oder Paketartefakt und die gewählte Versionsangabe in das von deiner IT verwaltete Paket auf. Lege den Installationskontext und das Verfahren für Erkennung, Deinstallation und Updates fest. Die Versionsauswahl ändert nichts daran, dass das Installationsprogramm standardmäßig das Benutzerprofil verwendet. Sie liefert auch keinen vollständigen Wrapper für die unbeaufsichtigte Bereitstellung.

Installationskontext festlegen

Das eigenständige Installationsprogramm legt die Laufzeitdateien standardmäßig im aktuellen Benutzerprofil ab. Es verwendet %LOCALAPPDATA%\Programs\OpenAI\Codex\bin als Befehlsverzeichnis und trägt dieses in die PATH-Variable des Benutzerkontos ein.

Wenn du das unveränderte Installationsprogramm als SYSTEM ausführst, verwendet es das Profil und die Umgebung von SYSTEM. Die Auswahl von System in Intune bewirkt keine Installation für alle Benutzerkonten.

Bereitstellungsoption Was du prüfen solltest
Für die angemeldete Person installieren Führe Installation und Erkennung im Kontext dieses Benutzerkontos aus. Öffne ein neues Terminal und prüfe, ob die Person codex über den Suchpfad findet und ausführen kann.
Ein geräteweites Paket erstellen Lege fest, wie die Installation auf dem Gerät aufgebaut ist, wo die Laufzeitdateien liegen, welche Berechtigungen gelten und wie die CLI über PATH erreichbar ist. Plane auch die Erkennung und Deinstallation und prüfe alle Punkte. Das Standardinstallationsprogramm gibt diese Struktur und Abläufe nicht vor.
npm verwenden Prüfe das globale Paketpräfix und den Speicherort des Befehls für das Konto, unter dem npm ausgeführt wird. „Global“ bedeutet nicht zwangsläufig, dass das Paket für alle Windows-Benutzerkonten verfügbar ist.

Behandle die Installation im Benutzerkonto, die Verteilung der Geräterichtlinie und das von der IT-Administration genehmigte Sandbox-Setup als getrennte Schritte. Wenn ein Verfahren das Profil einer bestimmten Person erfordert, führe es unter ihrem Konto statt unter SYSTEM aus.

Halte die Laufzeitdateien der eigenständigen CLI zusammen. Wenn du nur codex.exe kopierst, fehlt ein Teil des eigenständigen Pakets.

CLI für Intune paketieren und zuweisen

Erstelle und teste ein von der IT verwaltetes Win32-Paket. Es muss für den gewählten Installationskontext eine unbeaufsichtigte Installation und Deinstallation sowie eine passende Erkennungslogik enthalten.

  1. Lege die freigegebenen Installationsdateien und dein Skript für die unbeaufsichtigte Installation in einem Quellordner ab. Gib die freigegebene CLI-Version im Skript an, damit es nicht die über latest ermittelte Version installiert. Lege das Paketierungstool von Microsoft und den Ausgabeordner außerhalb des Quellordners ab.

  2. Erstelle mit dem Microsoft Win32 Content Prep Tool die .intunewin-Datei. In diesem Beispiel heißt das geprüfte Installationsskript Install-Codex.ps1.

    IntuneWinAppUtil.exe -c C:\Packages\Codex\Source -s Install-Codex.ps1 -o C:\Packages\Codex\Output -q

    Das Tool paketiert den Inhalt des Quellordners. Weitere Informationen findest du in der Anleitung zum Erstellen eines Win32-App-Pakets.

  3. Erstelle in Intune eine Windows-App (Win32) und lade das Paket hoch.

  4. Lege passend zum Paket die Installations- und Deinstallationsbefehle, das Installationsverhalten (Benutzer oder System), die Anforderungen und die Erkennungsregeln fest.

  5. Weise die App als Erforderlich oder Für registrierte Geräte verfügbar zu.

Intune setzt eine unbeaufsichtigte Installation voraus. Benutzerdefinierte Erkennungsskripte müssen mit dem Exitcode 0 enden und eine Ausgabe auf stdout schreiben. Eine Ausgabe auf stderr führt dazu, dass die Erkennung fehlschlägt. Weitere Informationen findest du in der Anleitung zum Hinzufügen und Zuweisen einer Win32-App.

Prüfe die CLI mit dem Konto der jeweiligen Person, auch wenn der Verwaltungsagent einen erfolgreichen Exitcode meldet.

Übernimm für Configuration Manager (SCCM) das geprüfte CLI-Installationsverfahren in deine Anwendungsbereitstellung. Verwende dazu ein eigenes Installationsprogramm und eine Erkennungsregel für die CLI. Die MSIX-Einstellungen der Desktop-App gelten nur für die Desktop-App.

Verwaltete Vorgaben konfigurieren

Lege die administrativ erzwungenen Vorgaben für Windows standardmäßig unter folgendem Pfad ab:

%ProgramData%\OpenAI\Codex\requirements.toml

Um einen anderen Speicherort festzulegen, setze den Zeichenfolgenwert RequirementsPath unter HKLM\SOFTWARE\Policies\OpenAI\Codex auf den absoluten Pfad zur Datei.

Verteile die Datei über dein Tool zur Endpunktverwaltung. Gib den vorgesehenen Personen Lesezugriff und verhindere, dass Konten ohne Administratorrechte die administrativ verwaltete Richtlinie ändern können.

Vorgaben schränken ein, welche Einstellungen zulässig sind. Standardwerte der Konfiguration legen die Ausgangswerte fest. Prüfe sowohl die lokale Datei als auch die geltende Cloud-Richtlinie, um die tatsächlich wirksame Konfiguration zu ermitteln.

Lege Vorgaben für Berechtigungen, Genehmigungen, Netzwerkzugriff und das Verhalten der Sandbox fest. Welche Felder unterstützt werden und welche Vorgaben Vorrang haben, erfährst du in der Anleitung zur verwalteten Konfiguration.

Starte Codex nach der Bereitstellung mit dem Konto der jeweiligen Person und prüfe mit /status und /debug-config, welche Richtlinie wirksam ist. Weder die Installation der CLI noch die Verteilung der Vorgaben gewährt Zugriff auf den Workspace.

Windows-Sandbox konfigurieren

Prüfe die Gerätekompatibilität, bevor du eine Windows-Sandbox auswählst. Die Anleitung zur Windows-Sandbox behandelt Microsoft Execution Containers (MXC) und die älteren Implementierungen.

MXC auf kompatiblen Geräten bevorzugen

Wenn du die eigenständige CLI verwendest, aktiviere in config.toml die bevorzugte Verwendung von MXC:

[features]
prefer_mxc = true

Du kannst diesen Wert auch über requirements.toml erzwingen. Wenn MXC nicht verfügbar ist, lässt diese Einstellung den Rückgriff auf eine ältere Implementierung zu. Prüfe vor der Aktivierung die Geräteanforderungen in der Anleitung zur Windows-Sandbox.

Führe ab CLI-Version 0.162.0 den folgenden Kompatibilitätstest in einem Projektverzeichnis aus:

codex -c windows.sandbox=mxc sandbox --include-managed-config --permission-profile :workspace -- cmd.exe /d /c echo MXC_OK
$LASTEXITCODE

Die erwartete Ausgabe ist MXC_OK mit dem Exitcode 0. Der Test prüft den Befehl mit explizit ausgewähltem MXC. Prüfe zusätzlich die Konfiguration einer regulären Sitzung im Konto der jeweiligen Person.

Vergleiche vor dem Rollout die Netzwerkeinschränkungen aus der Sandbox-Anleitung mit deiner verwalteten Netzwerkrichtlinie.

Ältere Sandbox als Ausweichlösung vorbereiten

Wenn MXC nicht verfügbar oder deaktiviert ist, verwende vorzugsweise die ältere Implementierung elevated als Ausweichlösung. Eine Person mit Administratorrechten muss das Setup genehmigen. Die Befehle in der Sandbox laufen anschließend ohne Administratorrechte.

Folge der Setup-Anleitung für die IT für das Konto der jeweiligen Person und das zugehörige Codex-Stammverzeichnis. Führe das folgende Beispiel in einem Prozess mit den erforderlichen erhöhten Rechten aus:

codex sandbox setup --elevated --user 'DOMAIN\alice' --codex-home 'C:\Users\alice\.codex'

Ersetze das Beispielkonto und den Pfad durch die Werte für das vorgesehene Benutzerkonto. Verwende für das Setup mit erhöhten Rechten eine CLI-Installation, der die IT-Administration vertraut.

Wenn du von den älteren Implementierungen nur die Variante elevated zulassen möchtest, füge den folgenden Eintrag in %ProgramData%\OpenAI\Codex\requirements.toml ein, nicht in config.toml. Weitere Informationen findest du in der Anleitung zur Konfiguration einer älteren Sandbox als Ausweichlösung.

[windows]
allowed_sandbox_implementations = ["elevated"]

Das schränkt die Auswahl der älteren Implementierungen ein, ohne MXC zu blockieren. Bevor du unelevated zulässt, berücksichtige, dass diese Implementierung den Netzwerkzugriff weniger stark isoliert und keine Pfade unterstützt, für die der Lesezugriff verweigert wird.

CLI-Bereitstellung überprüfen

Öffne mit dem Konto einer Person, für die die CLI vorgesehen ist, ein neues PowerShell-Fenster ohne Administratorrechte:

Get-Command codex
codex --version
codex

Prüfe, ob der Befehl die ausführbare Datei der vorgesehenen Installation aufruft. Durchlaufe anschließend das freigegebene Anmeldeverfahren. Führe eine kleine Aufgabe in einem dafür vorgesehenen Testprojekt aus und prüfe die aktive Konfiguration.

Prüfung Vorgehen und erwartetes Ergebnis
Installationskontext Prüfe im vorgesehenen Benutzerkonto, ob die CLI über den Suchpfad erreichbar ist, auch nach erneuter Anmeldung.
Erkennung durch das Verwaltungstool Prüfe, ob das Tool die CLI auf Geräten mit installierter CLI erkennt. Auf Geräten ohne CLI muss die Erkennung negativ ausfallen, auch nach einer Deinstallation.
Verwaltete Vorgaben Prüfe, ob die Sitzung die erwartete Richtlinie als wirksam anzeigt.
Windows-Sandbox Prüfe, ob MXC auf kompatiblen Geräten funktioniert und die freigegebene ältere Sandbox dort bereitgestellt ist, wo sie benötigt wird.
Update Prüfe, ob die jeweilige Person nach der Bereitstellung die freigegebene neue Version ausführen kann.
Deinstallation Prüfe, ob das Paket seine Installation und seinen PATH-Eintrag entfernt, ohne andere Benutzerkonfigurationen oder Projektdaten zu löschen.

Updates verwalten

Desktop-App

Die App sucht standardmäßig nach Updates, auch nach einer Offlineinstallation. Damit automatische Updates funktionieren, erlaube den Geräten den Zugriff auf persistent.oaistatic.com. Wenn du automatische Updates deaktivierst, stelle neuere Pakete über dein Verwaltungstool bereit.

Folge der Anleitung App-Updates verwalten, um alle Updatequellen aufeinander abzustimmen. Wenn du die integrierte Updatefunktion deaktivierst, können Microsoft Store, Intune und andere Verwaltungstools die App weiterhin aktualisieren. Dadurch erhältst du weder eine von OpenAI verwaltete Versionsbindung noch einen separaten Releasekanal. Prüfe die installierte Version in deinem Bereitstellungssystem.

Codex CLI

Wähle für jedes CLI-Update eine neue freigegebene Version. Aktualisiere im Bereitstellungspaket den expliziten Wert für -Release oder die npm-Paketversion und passe die Erkennungsregel an. Stelle das Paket über dein übliches Verfahren bereit und prüfe anschließend die installierte Version, den Kontokontext und das Verhalten der Erkennung. Stelle das verwaltete Paket nicht wieder auf einen Installationsbefehl ohne explizite Versionsangabe um. Weitere Informationen findest du in der Übersicht der CLI-Releases, in der Anleitung zu CLI-Installation und Updates und in der Dokumentation zur Versionsauswahl mit npm.

Deinstallation und lokale Daten

Deinstalliere die Desktop-App über die Windows-Einstellungen oder dein Verwaltungstool, etwa Intune oder SCCM. Die Bereinigung erfolgt automatisch bei der Deinstallation.

Lokale Programmierchats und Einstellungen bleiben standardmäßig im Verzeichnis CODEX_HOME des jeweiligen Benutzerkontos erhalten.

Wenn du bei der Deinstallation auch CODEX_HOME entfernen möchtest, füge vor der Deinstallation den folgenden Eintrag in die Datei config.toml in diesem Ordner ein:

[desktop]
uninstall_codex_home = true

Problembehandlung

Bei der Installation werden Administratoranmeldedaten angefordert

Wenn Mitarbeitende die App selbst installieren, muss eine Person mit Administratorrechten die Installation genehmigen.

Bei einer Bereitstellung mit Intune über den Microsoft Store gehst du wie folgt vor:

  1. Gehe im Intune Admin Center zu Apps > Alle Apps und wähle ChatGPT aus.

  2. Prüfe das Installationsverhalten in den Eigenschaften der App. Ist dort Benutzer eingestellt, füge die App erneut als Microsoft Store-App (neu) hinzu und wähle System auf der Seite App-Informationen aus.

  3. Weise die App deiner Zielgruppe unter Erforderlich oder Für registrierte Geräte verfügbar zu. Wenn du eine neue App hinzugefügt hast, entferne die Zuweisung dieser Gruppe aus der ursprünglichen App.

  4. Synchronisiere das betroffene Gerät mit Intune und prüfe anschließend den Geräteinstallationsstatus. Wenn die App als verfügbar zugewiesen wurde, versuche die Installation im Unternehmensportal erneut.

Wenn die App bereits installiert ist und du sie mit dem Installationsverhalten System bereitstellst, meldet Intune unter Umständen 0x87D1041C. Die Installation ist in diesem Fall trotzdem erfolgreich. Prüfe die App auf dem betroffenen Gerät.

Installation fehlgeschlagen mit Fehler 0x80073D28

Windows gibt 0x80073D28 (ERROR_PACKAGED_SERVICE_REQUIRES_ADMIN_PRIVILEGES) zurück, wenn es einen im Paket enthaltenen Dienst ohne Administratorrechte nicht installieren kann. Führe die Installation mit Administratorrechten aus oder konfiguriere dein Bereitstellungstool so, dass es die App im Geräte- oder Systemkontext installiert.

Bei einer bestehenden SCCM-Bereitstellung gehst du wie folgt vor:

  1. Öffne in den Eigenschaften der Anwendung den Bereich Bereitstellungstypen.
  2. Bearbeite den Bereitstellungstyp Windows-App-Paket und öffne Benutzerfreundlichkeit.
  3. Aktiviere Diese Anwendung für alle Benutzer auf dem Gerät bereitstellen und speichere die Änderung.
  4. Aktualisiere die Computerrichtlinie des Clients und versuche die Installation im Softwarecenter erneut.

Weitere Informationen zu dieser Bereitstellungsoption findest du in Microsofts Dokumentation zu den Einstellungen für die Anwendungsbereitstellung.

Installation und Konfiguration von Codex CLI

Symptom Was du prüfen solltest
Intune meldet Erfolg, aber die betreffende Person kann Codex nicht ausführen Prüfe das Installationskonto, den Speicherort der Laufzeitdateien und das Konto, dessen PATH aktualisiert wurde. Wenn das unveränderte Installationsprogramm unter SYSTEM läuft, installiert es die CLI nicht im Profil der betreffenden Person.
codex wird nach der Installation nicht erkannt Öffne ein neues Terminal. Prüfe das Befehlsverzeichnis und die PATH-Variable des vorgesehenen Kontos.
Die falsche Codex-Version startet Prüfe mit Get-Command codex, ob der Befehl auf eine andere eigenständige Installation oder eine npm-Installation verweist.
Der MXC-Kompatibilitätstest schlägt fehl Gleiche die Gerätefunktionen, die CLI-Version und die verwaltete Richtlinie mit der Anleitung zur Windows-Sandbox ab. Stelle bei Bedarf die freigegebene ältere Sandbox als Ausweichlösung bereit.
Das Setup der älteren Sandbox fordert eine Genehmigung mit Administratorrechten an Führe das von der IT betreute Setup für das Konto der jeweiligen Person und das zugehörige Codex-Stammverzeichnis durch.
Die verwalteten Einstellungen weichen von der lokalen Datei mit den Vorgaben ab Prüfe mit /status und /debug-config, welche Einstellungen wirksam sind, welche Richtlinien Vorrang haben und welche Felder unterstützt werden.

Weiterführende Ressourcen