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.
Paketquelle
Über den Microsoft Store bereitstellen
Nutze die Microsoft Store-Integration von Intune, um die App zu installieren und zu aktualisieren.
-
Gehe im Intune Admin Center zu Apps > Alle Apps > Erstellen. Wähle Microsoft Store-App (neu) aus.
-
Suche nach ChatGPT von OpenAI oder gib die Store-Produkt-ID
9PLM9XGG6VKSein. Wähle die App aus und prüfe ihre Installationseinstellungen. -
Setze unter App-Informationen das Installationsverhalten auf System.
-
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.
Ein Offlinepaket mit Intune bereitstellen
Verwende ein heruntergeladenes MSIX-Paket, wenn die Geräte die Verteilungsdienste von Microsoft nicht nutzen können oder du ein von deiner Organisation geprüftes Paket verteilen musst. Über die Links erhältst du die neueste Version. Verwende bei wiederholten Bereitstellungen das freigegebene Artefakt aus deinem Bereitstellungssystem. Wähle für die automatische Installation Erforderlich aus.
Auch wenn der Zugriff auf die Microsoft Store-App gesperrt ist, kannst du Apps über die Microsoft Store-Integration von Intune bereitstellen. Die Option Microsoft Store (empfohlen) steht dir weiterhin zur Verfügung.
Zuweisung
-
Lade für deine Geräte das MSIX-Paket für x64 oder das MSIX-Paket für Arm64 herunter.
-
Gehe im Intune Admin Center zu Apps > Alle Apps > Erstellen. Wähle Branchenspezifische App aus, lade das MSIX-Paket hoch und prüfe die Paketinformationen.
-
Füge auf der Seite Zuweisungen unter Erforderlich die Zielgerätegruppe hinzu.
-
Wähle für diese Zuweisung in der Spalte Installationskontext den Eintrag Benutzerkontext aus, ändere ihn in Gerätekontext und speichere die Änderung.
-
Prüfe die Einstellungen und erstelle die App. Vergewissere dich unter Geräteinstallationsstatus, dass die Installation erfolgreich war. Bitte die Mitarbeitenden anschließend, ChatGPT wie gewohnt zu starten.
Wenn die App nicht angezeigt wird, bitte die Mitarbeitenden, sich ab- und wieder anzumelden.
Weitere Informationen findest du in Microsofts Anleitung zur Bereitstellung branchenspezifischer Apps.
Um die Installation über das Unternehmensportal anzubieten, stelle das Offlinepaket als Windows-App (Win32) mit der Zuweisung Für registrierte Geräte verfügbar bereit.
-
Lade das MSIX-Paket für x64 oder das MSIX-Paket für Arm64 sowie die Offlinelizenz herunter. Benenne das Paket in
ChatGPT.msixum und lege beide Dateien im selben Ordner ab. -
Speichere das folgende Skript als
Install-ChatGPT.ps1im selben Ordner wie die heruntergeladenen Dateien.#Requires -RunAsAdministrator $ErrorActionPreference = 'Stop' Add-AppxProvisionedPackage -Online ` -PackagePath "$PSScriptRoot\ChatGPT.msix" ` -LicensePath "$PSScriptRoot\ChatGPT-License.xml" ` -Regions all -
Speichere das folgende Skript als
Uninstall-ChatGPT.ps1im selben Ordner wie das MSIX-Paket, die Lizenz und das Installationsskript. Konfiguriere Intune so, dass es dieses Skript bei der Deinstallation der App im Systemkontext ausführt. Das Skript entfernt das bereitgestellte Paket und die App-Registrierungen für alle Benutzerkonten auf dem Gerät.Wenn du lokale Daten bei der Deinstallation entfernen möchtest, sichere alle Daten, die du behalten willst, bevor du das Skript ausführst.
#Requires -RunAsAdministrator $ErrorActionPreference = 'Stop' Get-AppxProvisionedPackage -Online | Where-Object DisplayName -eq 'OpenAI.Codex' | Remove-AppxProvisionedPackage -Online -AllUsers Get-AppxPackage -AllUsers -Name 'OpenAI.Codex' | Remove-AppxPackage -AllUsersHalte dich bei beiden Skripten an die Richtlinie deiner Organisation zur Signierung von PowerShell-Skripten.
-
Folge Microsofts Anleitung für Win32-Apps, um das MSIX-Paket, die Lizenz,
Install-ChatGPT.ps1undUninstall-ChatGPT.ps1gemeinsam zu paketieren. Füge in Intune eine Windows-App (Win32) hinzu, setze das Installationsverhalten auf System und wähle die Prozessorarchitektur des Pakets als Zielarchitektur aus. Konfiguriere die folgenden 64-Bit-Befehle für die Installation und Deinstallation. Weise die App anschließend als Für registrierte Geräte verfügbar zu.
Einstellungen für die Installation, Deinstallation und Erkennung der Win32-App
Gib unter Installationsbefehl folgenden Befehl ein:
%SystemRoot%\Sysnative\WindowsPowerShell\v1.0\powershell.exe -NoProfile -File .\Install-ChatGPT.ps1Für Geräte, auf denen Windows unter C:\Windows installiert ist, gib unter Deinstallationsbefehl folgenden Befehl ein:
C:\Windows\Sysnative\WindowsPowerShell\v1.0\powershell.exe -NoProfile -File .\Uninstall-ChatGPT.ps1Falls Windows in einem anderen Verzeichnis installiert ist, passe den Pfad entsprechend an. Mit diesem expliziten Pfad rufst du die 64-Bit-Version von Windows PowerShell aus dem 32-Bit-Befehlskontext von Intune auf. Verwende im Feld für den Deinstallationsbefehl nicht %SystemRoot%, da Intune dort keine Umgebungsvariablen auflöst. Wenn du Variablen auflösen musst, nimm ein Wrapper-Skript in das Paket auf. Das Vorgehen beschreibt Microsoft in der Dokumentation zu den Programmeinstellungen.
Führe das folgende benutzerdefinierte Erkennungsskript in der 64-Bit-Version von PowerShell aus. Es meldet Erfolg, wenn die App auf dem Gerät bereitgestellt ist. Um eine bestimmte freigegebene Version zu erkennen, vergleiche zusätzlich die Paketeigenschaft Version mit der freigegebenen Versionsnummer.
$package = Get-AppxProvisionedPackage -Online -ErrorAction Stop |
Where-Object DisplayName -eq 'OpenAI.Codex'
if ($package) {
Write-Output $package.PackageName
exit 0
}
exit 1Windows registriert das bereitgestellte Paket bei der Anmeldung. Wenn die App nicht angezeigt wird, bitte die Mitarbeitenden, sich ab- und wieder anzumelden.
Mit Microsoft Configuration Manager (SCCM) bereitstellen
Stelle das heruntergeladene MSIX-Paket über Configuration Manager und das Softwarecenter bereit.
-
Lade für deine Geräte das MSIX-Paket für x64 oder das MSIX-Paket für Arm64 herunter. Lege es auf einer Netzwerkfreigabe ab, auf die Configuration Manager zugreifen kann.
-
Gehe zu Softwarebibliothek > Anwendungsverwaltung > Anwendungen > Anwendung erstellen. Wähle Windows-App-Paket aus und gib den Pfad zum MSIX-Paket ein. Prüfe die erkannten Paketinformationen und aktiviere Diese Anwendung für alle Benutzer auf dem Gerät bereitstellen.
-
Verteile den Inhalt an deine Verteilungspunkte und stelle die App für eine Gerätesammlung bereit. Wähle Erforderlich für die automatische Installation oder Verfügbar, damit Mitarbeitende die App über das Softwarecenter installieren können.
Verwende den Bereitstellungstyp für Windows-App-Pakete und nicht den für Store-Links. Informationen zu den Paketanforderungen und zur Bereitstellung für alle Benutzerkonten findest du in Microsofts Anleitung für Configuration Manager.
Falls dein Bereitstellungsverfahren es erfordert, lade zusätzlich zum Paket die Offlinelizenz herunter.
Eine bereitgestellte App mit Configuration Manager entfernen
Wenn sich Mitarbeitende bereits an Geräten mit der bereitgestellten App angemeldet haben, erstelle beide Deinstallationszuweisungen:
-
Weise die Deinstallation der Gerätesammlung zu, die die betroffenen Geräte enthält.
-
Weise die Deinstallation zusätzlich der Benutzersammlung zu, die die Konten der Personen enthält, die sich bereits an diesen Geräten angemeldet haben.
Wenn du die bereitgestellte App vom Gerät entfernst, bleibt sie für bestehende Benutzerkonten installiert. Prüfe, ob die App sowohl vom Gerät als auch aus den betreffenden Benutzerkonten entfernt wurde. Weitere Informationen findest du in Microsofts Anleitung zum Entfernen bereitgestellter Apps.
Paketquelle
Mitarbeitende die App selbst installieren lassen
Nutze diese Option, wenn Mitarbeitende Anwendungen selbst installieren können oder Unterstützung von einer Person mit Administratorrechten erhalten.
-
Verweise die Mitarbeitenden auf das Windows-Installationsprogramm für ChatGPT.
-
Die Mitarbeitenden führen das Installationsprogramm aus und folgen den Installationsanweisungen von Windows. Eine Person mit Administratorrechten muss die Installation genehmigen.
-
Anschließend öffnen die Mitarbeitenden ChatGPT und melden sich mit ihrem Geschäftskonto an.
Mitarbeitende können die App auch über die Befehlszeile installieren:
winget install --id 9PLM9XGG6VKS -s msstoreDas Installationsprogramm sorgt für automatische Updates. Bei der Installation oder bei Updates können Komponenten des Microsoft Store angezeigt werden. Die Mitarbeitenden müssen die App dafür nicht im Store suchen.
Aus einem Offlinepaket installieren
Lade die Dateien auf einem Rechner mit Internetzugang herunter und kopiere sie auf das Zielgerät. Eine Person mit Administratorrechten muss die Installation durchführen.
-
Lade das MSIX-Paket für x64 oder das MSIX-Paket für Arm64 sowie die Offlinelizenz herunter. Benenne das Paket in
ChatGPT.msixum und lege beide Dateien im selben Ordner ab. -
Öffne Windows PowerShell in diesem Ordner mit Administratorrechten und führe folgenden Befehl aus:
Add-AppxProvisionedPackage -Online ` -PackagePath .\ChatGPT.msix ` -LicensePath .\ChatGPT-License.xml ` -Regions all -
Melde dich ab und wieder an, falls die App nicht angezeigt wird. Öffne anschließend ChatGPT und melde dich mit einem Geschäftskonto an.
Über die Downloadlinks erhältst du für jede Architektur das neueste vom Store signierte Paket. Auch nach einer Offlineinstallation benötigst du Internetzugang, um ChatGPT zu nutzen. Für die Desktop-App gibt es weder eigenständige MSI-Pakete noch EXE-Pakete außerhalb des Stores.
Mit einem anderen Verwaltungstool bereitstellen
Nutze das Verfahren deines Verwaltungstools zur Bereitstellung von MSIX-Paketen.
-
Lade für deine Geräte das MSIX-Paket für x64 oder das MSIX-Paket für Arm64 herunter.
-
Füge das MSIX-Paket deinem Bereitstellungstool hinzu. Konfiguriere die Installation für das Gerät so, dass sie unter dem lokalen Systemkonto oder mit Administratorrechten ausgeführt wird.
-
Weise die automatische Installation zunächst einer Pilotgruppe von Geräten zu. Prüfe, ob die Mitarbeitenden ChatGPT mit ihren regulären Windows-Konten öffnen können, bevor du die App auf weiteren Geräten bereitstellst.
Wenn die App nicht angezeigt wird, bitte die Mitarbeitenden, sich ab- und wieder anzumelden.
Mit einem PowerShell-Skript installieren
Wenn dein Tool einen Installationsbefehl benötigt, lade zusätzlich zum MSIX-Paket die Offlinelizenz herunter. Benenne das Paket in ChatGPT.msix um und speichere das folgende Skript als Install-ChatGPT.ps1 im selben Ordner.
#Requires -RunAsAdministrator
$ErrorActionPreference = 'Stop'
Add-AppxProvisionedPackage -Online `
-PackagePath "$PSScriptRoot\ChatGPT.msix" `
-LicensePath "$PSScriptRoot\ChatGPT-License.xml" `
-Regions allFasse das Skript und die beiden Dateien in einem Paket zusammen. Konfiguriere dein Tool so, dass es das Skript mit der 64-Bit-Version von Windows PowerShell unter dem lokalen Systemkonto oder mit einem Administratorkonto ausführt.
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.
-
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
latestermittelte Version installiert. Lege das Paketierungstool von Microsoft und den Ausgabeordner außerhalb des Quellordners ab. -
Erstelle mit dem Microsoft Win32 Content Prep Tool die
.intunewin-Datei. In diesem Beispiel heißt das geprüfte InstallationsskriptInstall-Codex.ps1.IntuneWinAppUtil.exe -c C:\Packages\Codex\Source -s Install-Codex.ps1 -o C:\Packages\Codex\Output -qDas Tool paketiert den Inhalt des Quellordners. Weitere Informationen findest du in der Anleitung zum Erstellen eines Win32-App-Pakets.
-
Erstelle in Intune eine Windows-App (Win32) und lade das Paket hoch.
-
Lege passend zum Paket die Installations- und Deinstallationsbefehle, das Installationsverhalten (Benutzer oder System), die Anforderungen und die Erkennungsregeln fest.
-
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:
-
Gehe im Intune Admin Center zu Apps > Alle Apps und wähle ChatGPT aus.
-
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.
-
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.
-
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:
- Öffne in den Eigenschaften der Anwendung den Bereich Bereitstellungstypen.
- Bearbeite den Bereitstellungstyp Windows-App-Paket und öffne Benutzerfreundlichkeit.
- Aktiviere Diese Anwendung für alle Benutzer auf dem Gerät bereitstellen und speichere die Änderung.
- 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. |