Die Windows-App und Codex CLI bereitstellen

Stellen Sie die Windows-Desktop-App, Codex CLI oder beides auf verwalteten Windows-Geräten bereit. Wählen Sie die App für den Desktopzugriff oder die CLI für den Terminalzugriff.

Die Desktop-App und die eigenständige CLI verwenden unterschiedliche Installationskontexte. Wählen und überprüfen Sie vor der Bereitstellung der CLI das Konto, unter dem das Installationsprogramm ausgeführt wird.

Die Windows-App bereitstellen

Wählen Sie eine Methode anhand Ihres Verwaltungstools und abhängig davon, ob die Geräte auf die Verteilungsdienste von Microsoft zugreifen können.

Konfigurieren Sie vor der Bereitstellung die relevanten Kontrollen anhand der verwalteten Konfiguration. Um die Befehlsausführung durch Codex in der Desktop-App vorzubereiten, folgen Sie der Anleitung zur Einrichtung der Windows-Sandbox. Prüfen Sie die Gerätekompatibilität und führen Sie gegebenenfalls die erforderliche Einrichtung für ältere Systeme durch.

Über die folgenden MSIX-Links laden Sie die neueste Version für die jeweilige Architektur herunter, keine ältere Version. Prüfen Sie das heruntergeladene Paket und bewahren Sie das freigegebene Artefakt in Ihrem Bereitstellungssystem auf. Folgen Sie der Anleitung App-Updates verwalten, um den integrierten Updater der App mit Microsoft Store, Intune und anderen Bereitstellungstools abzustimmen.

   #Requires -RunAsAdministrator
   $ErrorActionPreference = 'Stop'

   Add-AppxProvisionedPackage -Online `
     -PackagePath "$PSScriptRoot\ChatGPT.msix" `
     -LicensePath "$PSScriptRoot\ChatGPT-License.xml" `
     -Regions all

   #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 -AllUsers

%SystemRoot%\Sysnative\WindowsPowerShell\v1.0\powershell.exe -NoProfile -File .\Install-ChatGPT.ps1

C:\Windows\Sysnative\WindowsPowerShell\v1.0\powershell.exe -NoProfile -File .\Uninstall-ChatGPT.ps1

$package = Get-AppxProvisionedPackage -Online -ErrorAction Stop |
  Where-Object DisplayName -eq 'OpenAI.Codex'

if ($package) {
  Write-Output $package.PackageName
  exit 0
}
exit 1

#Requires -RunAsAdministrator
$ErrorActionPreference = 'Stop'

Add-AppxProvisionedPackage -Online `
  -PackagePath "$PSScriptRoot\ChatGPT.msix" `
  -LicensePath "$PSScriptRoot\ChatGPT-License.xml" `
  -Regions all

winget install --id 9PLM9XGG6VKS -s msstore

   Add-AppxProvisionedPackage -Online `
     -PackagePath .\ChatGPT.msix `
     -LicensePath .\ChatGPT-License.xml `
     -Regions all

Codex CLI unter Windows bereitstellen

Bereiten Sie das CLI-Paket vor, wenden Sie Ihre Geräterichtlinie an und überprüfen Sie den Terminalzugriff über das Konto des Mitarbeiters.

Bevor Sie beginnen

• Ermitteln Sie die Windows-Zielgeräte und Benutzer sowie die jeweiligen Prozessorarchitekturen und wählen Sie anschließend eine Installationsmethode. Stellen Sie sicher, dass die Benutzer Zugriff auf Codex haben und den Anmeldevorgang Ihrer Organisation abschließen können.

• Stellen Sie für Intune die Berechtigungen zur App-Verwaltung, registrierte Geräte, die Microsofts Voraussetzungen für die Win32-Paketerstellung erfüllen, und ein Paket für die unbeaufsichtigte Installation bereit.

• Legen Sie fest, wer für Updates und die Deinstallation der CLI verantwortlich ist. Wenn Sie npm verwenden, berücksichtigen Sie die verwaltete Node.js/npm-Installation und deren globalen Paketspeicherort.

Installationsmethode auswählen

Wählen Sie eine Installationsmethode und eine konkrete CLI-Version. Prüfen Sie die CLI-Releases auf GitHub und ersetzen Sie anschließend <approved-version> in den Beispielen durch Ihre freigegebene Versionsnummer im Format x.y.z. Verwenden Sie im Paket und in der Erkennungsregel dieselbe Version.

Das eigenständige Installationsprogramm verwendet standardmäßig latest, wenn keine Version angegeben ist. Legen Sie -Release explizit fest, um die Bereitstellung an eine bestimmte Version zu binden; siehe Release-Parameter des Installationsprogramms. Allgemeine Installationshinweise finden Sie unter CLI-Installation.

Eigenständiges PowerShell-Installationsprogramm. Laden Sie das Installationsprogramm in einem neuen PowerShell-Fenster herunter und übergeben Sie 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 verwaltet werden, wählen Sie die freigegebene Paketversion explizit aus:

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

Nehmen Sie für die verwaltete Verteilung das geprüfte Installationsprogramm oder Paketartefakt und die ausgewählte Version in das von Ihrer IT verwaltete Paket auf. Definieren Sie den Installationskontext sowie das Verhalten bei Erkennung, Deinstallation und Updates. Die Auswahl einer Version ändert weder die Standardeinstellungen des Installationsprogramms für das Benutzerprofil noch stellt sie einen vollständigen Wrapper für die unbeaufsichtigte Bereitstellung bereit.

Installationskontext festlegen

Das eigenständige Installationsprogramm verwendet standardmäßig Laufzeitdateien im Profil des aktuellen Benutzers, ein Befehlsverzeichnis unter %LOCALAPPDATA%\Programs\OpenAI\Codex\bin und den Benutzer-PATH.

Wenn Sie das unveränderte Installationsprogramm als SYSTEM ausführen, werden das SYSTEM-Profil und dessen Umgebung verwendet. Die Auswahl von System in Intune macht daraus keine Installation für alle Benutzer.

Trennen Sie die Benutzerinstallation, die Bereitstellung von Geräterichtlinien und die vom Administrator genehmigte Sandbox-Einrichtung voneinander. Wenn ein Vorgang das Profil eines Mitarbeiters erfordert, verwenden Sie die Identität dieses Mitarbeiters statt SYSTEM.

Halten Sie die eigenständigen Laufzeitdateien zusammen; wenn Sie nur codex.exe kopieren, erhalten Sie kein vollständiges eigenständiges Paket.

CLI über Intune paketieren und zuweisen

Bereiten Sie ein von Ihrer IT verwaltetes Win32-Paket mit einem unbeaufsichtigten Installationsprogramm, einem Deinstallationsprogramm und einer Erkennungslogik für den gewählten Installationskontext vor und überprüfen Sie es.

1. Bereiten Sie einen Quellordner mit den freigegebenen Installationsdateien und Ihrem Skript für die unbeaufsichtigte Installation vor. Geben Sie in diesem Skript die freigegebene CLI-Version an, statt es latest auflösen zu lassen. Speichern Sie das Microsoft-Paketierungstool und den Ausgabeordner außerhalb dieses Quellordners.

2. Erstellen Sie die .intunewin-Datei mit dem Microsoft Win32 Content Prep Tool. In diesem Beispiel wird angenommen, dass Ihr geprüftes Installationsskript Install-Codex.ps1 heißt:

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

Das Tool paketiert den Inhalt des Quellordners. Siehe Win32-App-Paket erstellen.

3. Erstellen Sie in Intune eine Windows-App (Win32) und laden Sie das Paket hoch.

4. Legen Sie die Installations- und Deinstallationsbefehle, das Verhalten als Benutzer oder System, die Anforderungen und die Erkennungsregeln passend zum Paket fest.

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

Intune erfordert eine unbeaufsichtigte Installation. Benutzerdefinierte Erkennungsskripts müssen mit dem Exitcode 0 beendet werden und auf stdout schreiben; Ausgaben auf stderr führen zu einem Erkennungsfehler. Siehe Win32-App hinzufügen und zuweisen.

Überprüfen Sie die CLI über das Konto des Mitarbeiters, auch wenn der Verwaltungsagent einen erfolgreichen Exitcode meldet.

Verwenden Sie für Configuration Manager (SCCM) das geprüfte CLI-Installationskonzept in Ihrem Anwendungsworkflow, mit einem CLI-spezifischen Installationsprogramm und einer entsprechenden Erkennungsregel. Die MSIX-Einstellungen der Desktop-App gelten nur für die Desktop-App.

Verwaltete Anforderungen konfigurieren

Stellen Sie die von Administratoren erzwungenen Windows-Anforderungen unter folgendem Pfad bereit:

%ProgramData%\OpenAI\Codex\requirements.toml

Verteilen Sie die Datei über Ihr Endpunktverwaltungstool. Gewähren Sie den vorgesehenen Benutzern Lesezugriff und verhindern Sie, dass reguläre Benutzer die vom Administrator verwaltete Richtlinie ändern.

Anforderungen schränken Einstellungen ein; Konfigurationsstandardwerte liefern Ausgangswerte. Prüfen Sie sowohl die lokale Datei als auch die geltende Cloud-Richtlinie, um die wirksame Konfiguration zu ermitteln.

Legen Sie Anforderungen für Berechtigungen, Genehmigungen, Netzwerkzugriff und Sandbox-Verhalten fest. Unterstützte Felder und Vorrangregeln finden Sie unter Verwaltete Konfiguration.

Starten Sie Codex nach der Bereitstellung als Mitarbeiter und verwenden Sie /status und /debug-config, um die wirksame Richtlinie zu bestätigen. Die Installation der CLI oder die Verteilung von Anforderungen gewährt keinen Zugriff auf den Arbeitsbereich.

Die Windows-Sandbox konfigurieren

Prüfen Sie die Gerätekompatibilität, bevor Sie eine Windows-Sandbox auswählen. Der Leitfaden zur Windows-Sandbox behandelt Microsoft Execution Containers (MXC) und die älteren Implementierungen.

MXC auf kompatiblen Geräten bevorzugen

Aktivieren Sie für die eigenständige Nutzung der CLI die Bevorzugung von MXC in config.toml:

[features]
prefer_mxc = true

Sie können diesen Funktionswert auch über requirements.toml erzwingen. Die Einstellung erlaubt den Rückgriff auf eine ältere Implementierung, wenn MXC nicht verfügbar ist. Prüfen Sie vor der Aktivierung die Geräteanforderungen im Leitfaden zur Windows-Sandbox.

Führen Sie ab CLI-Version 0.162.0 die folgende Kompatibilitätsprüfung aus einem Projektverzeichnis aus:

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

Erwartet werden MXC_OK und der Exitcode 0. Damit wird der explizite MXC-Befehl geprüft; prüfen Sie auch die normale Sitzungskonfiguration des Mitarbeiters.

Gleichen Sie vor dem Rollout die Netzwerkeinschränkungen im Sandbox-Leitfaden mit Ihrer verwalteten Netzwerkrichtlinie ab.

Den Rückgriff auf eine ältere Implementierung vorbereiten

Wenn MXC nicht verfügbar oder deaktiviert ist, bevorzugen Sie die ältere Ausweichimplementierung elevated. Sie erfordert eine vom Administrator genehmigte Einrichtung, die Befehle in der Sandbox werden jedoch ohne Administratorrechte ausgeführt.

Befolgen Sie das von der IT durchgeführte Einrichtungsverfahren für das Mitarbeiterkonto und das Codex-Home-Verzeichnis. Führen Sie dieses Beispiel aus einem Prozess mit entsprechend erhöhten Rechten aus:

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

Ersetzen Sie die Beispielidentität und den Beispielpfad durch die Werte des vorgesehenen Benutzers. Verwenden Sie für die Einrichtung mit erhöhten Rechten eine CLI-Installation, der der Administrator vertraut.

Um nur die ältere Implementierung mit erhöhten Rechten zuzulassen, fügen Sie Folgendes zu %ProgramData%\OpenAI\Codex\requirements.toml hinzu, nicht zu config.toml. Siehe Rückgriff auf eine ältere Implementierung konfigurieren:

[windows]
allowed_sandbox_implementations = ["elevated"]

Dadurch wird der Rückgriff auf ältere Implementierungen eingeschränkt, ohne MXC zu blockieren. Bevor Sie unelevated zulassen, prüfen Sie die schwächere Netzwerkisolierung und die fehlende Unterstützung für Pfade mit verweigertem Lesezugriff.

CLI-Bereitstellung überprüfen

Öffnen Sie als vorgesehener Mitarbeiter ein neues PowerShell-Fenster ohne Administratorrechte:

Get-Command codex
codex --version
codex

Bestätigen Sie, dass die ausführbare Datei aus der vorgesehenen Installation stammt, und durchlaufen Sie dann den genehmigten Anmeldeablauf. Führen Sie eine kleine Aufgabe in einem dafür vorgesehenen Testprojekt aus und prüfen Sie die aktive Konfiguration.

Updates verwalten

Desktop-App

Die App sucht standardmäßig nach Updates, auch nach einer Offline- Installation. Um automatische Updates zu aktivieren, erlauben Sie Geräten den Zugriff auf persistent.oaistatic.com. Wenn Sie automatische Updates deaktivieren, stellen Sie neuere Pakete über Ihr Verwaltungstool bereit.

Befolgen Sie App-Updates verwalten, um alle Updatequellen zu koordinieren. Das Deaktivieren der integrierten Updatefunktion hindert Microsoft Store, Intune oder andere Verwaltungstools nicht daran, die App zu aktualisieren. Es ermöglicht auch weder eine von OpenAI verwaltete Versionsfixierung noch einen separaten Releasekanal. Bestätigen Sie die installierte Version über Ihr Bereitstellungssystem.

Codex CLI

Wählen Sie für jedes CLI-Update ein neues genehmigtes Release aus, aktualisieren Sie den expliziten -Release-Wert oder die npm-Paketversion in Ihrem Bereitstellungspaket und aktualisieren Sie dessen Erkennungsregel. Stellen Sie das Paket über Ihren Paketprozess bereit und überprüfen Sie anschließend die installierte Version, den Kontokontext und das Erkennungsverhalten. Stellen Sie das verwaltete Paket nicht wieder auf einen Installationsbefehl ohne explizite Releaseangabe um. Siehe CLI-Releases, CLI-Installation und Updates und npm-Versionsauswahl.

Problembehandlung

Installation und Konfiguration der Codex CLI

Verwandte Ressourcen

• CLI-Installation

• Verwaltete Konfiguration

• Einrichtung der Windows-Sandbox

• ChatGPT-Desktop-App für Windows

• Siehe Microsoft-Anleitung zur Win32-Paketerstellung

• Siehe Microsoft-Einstellungen für die Win32-Bereitstellung