Déployer l’application Windows et Codex CLI

Déployez l’application de bureau Windows, Codex CLI ou les deux sur des appareils Windows gérés. Choisissez l’application pour un accès depuis le bureau ou la CLI pour un accès depuis le terminal.

L’application de bureau et la CLI autonome utilisent des contextes d’installation différents. Avant de déployer la CLI, choisissez et validez le compte utilisé pour exécuter son programme d’installation.

Déployer l’application Windows

Choisissez une méthode en fonction de votre outil de gestion et de la possibilité pour les appareils d’accéder aux services de distribution de Microsoft.

Avant le déploiement, configurez les contrôles applicables à l’aide de la Configuration gérée. Pour préparer l’exécution de commandes Codex dans l’application de bureau, suivez la procédure de configuration du bac à sable Windows. Vérifiez la compatibilité des appareils et effectuez toute configuration requise pour les systèmes hérités.

Les liens MSIX ci-dessous téléchargent la dernière version pour chaque architecture, et non une version antérieure. Examinez le package téléchargé et conservez l’artefact approuvé dans votre système de déploiement. Suivez les instructions de la page Gérer les mises à jour de l’application pour coordonner le mécanisme de mise à jour intégré de l’application avec Microsoft Store, Intune et les autres outils de déploiement.

   #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

Déployer Codex CLI sous Windows

Préparez le package de la CLI, appliquez votre stratégie pour les appareils et vérifiez l’accès depuis le terminal avec le compte de l’employé.

Avant de commencer

• Identifiez les appareils Windows et les utilisateurs cibles ainsi que les architectures de processeur concernées, puis choisissez une méthode d’installation. Vérifiez que les utilisateurs ont accès à Codex et peuvent suivre le processus de connexion de votre organisation jusqu’au bout.

• Pour Intune, prévoyez les autorisations de gestion des applications, des appareils inscrits qui respectent les prérequis de Microsoft pour la création de packages Win32 et un package d’installation sans assistance.

• Désignez les responsables des mises à jour et de la désinstallation de la CLI. Si vous utilisez npm, tenez compte de l’installation gérée de Node.js/npm et de l’emplacement de ses packages globaux.

Choisir une méthode d’installation

Choisissez une méthode d’installation et une version précise de la CLI. Consultez les versions de la CLI sur GitHub, puis remplacez <approved-version> dans les exemples par le numéro de version approuvé, au format x.y.z. Utilisez la même version dans votre package et dans votre règle de détection.

Le programme d’installation autonome utilise latest par défaut lorsqu’aucune version n’est spécifiée. Définissez explicitement -Release pour fixer la version du déploiement ; consultez le paramètre de version du programme d’installation. Pour des instructions générales d’installation, consultez Installation de la CLI.

Programme d’installation PowerShell autonome. Dans une nouvelle fenêtre PowerShell, téléchargez le programme d’installation et indiquez la version approuvée :

$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. Si Node.js et npm sont déjà gérés sur l’appareil, sélectionnez explicitement la version approuvée du package :

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

Pour une distribution gérée, conservez le programme d’installation ou l’artefact de package vérifié ainsi que la version sélectionnée dans le package géré par votre service informatique. Définissez le contexte d’installation ainsi que les modalités de détection, de désinstallation et de mise à jour. La sélection d’une version ne modifie pas les paramètres par défaut du programme d’installation liés au profil utilisateur et ne fournit pas de script complet d’encapsulation pour un déploiement sans assistance.

Définir le contexte d’installation

Par défaut, le programme d’installation autonome place les fichiers d’exécution dans le profil de l’utilisateur actuel, utilise %LOCALAPPDATA%\Programs\OpenAI\Codex\bin comme répertoire de commandes et ajoute ce répertoire au PATH utilisateur.

L’exécution du programme d’installation sans modification en tant que SYSTEM cible le profil et l’environnement SYSTEM. Sélectionner Système dans Intune ne transforme pas cette installation en installation pour tous les utilisateurs.

Traitez séparément l’installation pour l’utilisateur, la distribution des stratégies aux appareils et la configuration du bac à sable approuvée par un administrateur. Lorsqu’une procédure nécessite le profil d’un employé, utilisez l’identité de cet employé plutôt que SYSTEM.

Conservez ensemble les fichiers d’exécution autonomes ; copier uniquement codex.exe ne suffit pas à constituer un package autonome complet.

Créer et attribuer le package de la CLI via Intune

Préparez et validez un package Win32 géré par votre service informatique, comprenant un programme d’installation sans assistance, un programme de désinstallation et une logique de détection adaptés au contexte d’installation choisi.

1. Préparez un dossier source contenant les fichiers d’installation approuvés et votre script d’installation sans assistance. Spécifiez la version approuvée de la CLI dans ce script au lieu de le laisser utiliser latest. Conservez l’outil de création de packages Microsoft et le dossier de sortie en dehors de ce dossier source.

2. Générez le fichier .intunewin avec Microsoft Win32 Content Prep Tool. Cet exemple suppose que votre script d’installation vérifié se nomme Install-Codex.ps1 :

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

L’outil crée un package à partir du contenu du dossier source. Consultez Créer un package d’application Win32.

3. Dans Intune, créez une Application Windows (Win32) et chargez le package.

4. Définissez les commandes d’installation et de désinstallation, le comportement Utilisateur ou Système, les exigences et les règles de détection en fonction du package.

5. Affectez-le comme Obligatoire ou Disponible pour les appareils inscrits.

Intune exige une installation sans intervention. Les scripts de détection personnalisés doivent se terminer avec le code 0 et écrire sur stdout ; toute sortie sur stderr entraîne un échec de la détection. Consultez Ajouter et affecter une application Win32.

Vérifiez la CLI depuis le compte de l’employé, même lorsque l’agent de gestion signale un code de sortie indiquant une réussite.

Pour Configuration Manager (SCCM), utilisez la procédure d’installation de la CLI validée dans votre workflow d’application, avec un programme d’installation et une règle de détection propres au CLI. Les paramètres MSIX de l’application de bureau s’appliquent uniquement à celle-ci.

Configurer les exigences gérées

Déployez les exigences Windows imposées par l’administrateur à l’emplacement suivant :

%ProgramData%\OpenAI\Codex\requirements.toml

Distribuez le fichier au moyen de votre outil de gestion des terminaux. Accordez aux utilisateurs concernés un accès en lecture et empêchez les utilisateurs ordinaires de modifier la stratégie administrée par l’administrateur.

Les exigences encadrent les paramètres ; les valeurs de configuration par défaut fournissent les valeurs initiales. Examinez le fichier local et la stratégie cloud applicable pour déterminer la configuration effective.

Définissez les exigences relatives aux autorisations, aux approbations, à l’accès réseau et au comportement du bac à sable. Consultez Configuration gérée pour connaître les champs pris en charge et les règles de priorité.

Après le déploiement, lancez Codex sous le compte de l’employé et utilisez /status et /debug-config pour confirmer la stratégie effective. L’installation de la CLI ou la distribution des exigences n’accorde pas l’accès à l’espace de travail.

Configurer le bac à sable Windows

Vérifiez la compatibilité des appareils avant de choisir un bac à sable Windows. Le guide du bac à sable Windows présente Microsoft Execution Containers (MXC) et les implémentations historiques.

Privilégier MXC sur les appareils compatibles

Pour utiliser la CLI de manière autonome, activez la préférence pour MXC dans config.toml :

[features]
prefer_mxc = true

Vous pouvez également imposer la valeur de cette fonctionnalité au moyen de requirements.toml. Cette préférence autorise le recours à une implémentation historique lorsque MXC est indisponible. Vérifiez les exigences relatives aux appareils dans le guide du bac à sable Windows avant de l’activer.

Avec la version 0.162.0 ou ultérieure de la CLI, exécutez ce test de compatibilité depuis un répertoire de projet :

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

Vous devez obtenir MXC_OK et un code de sortie de 0. Ce test vérifie la commande qui utilise explicitement MXC ; examinez également la configuration de la session habituelle de l’employé.

Avant le déploiement, comparez les contraintes réseau décrites dans le guide du bac à sable à votre stratégie réseau gérée.

Préparer la solution de repli historique

Lorsque MXC est indisponible ou désactivé, privilégiez la solution de repli historique elevated. Sa configuration nécessite l’approbation d’un administrateur, mais les commandes exécutées dans le bac à sable s’exécutent sans privilèges d’administrateur.

Suivez la procédure de configuration menée par le service informatique pour le compte de l’employé et le répertoire de base de Codex. Exécutez cet exemple depuis un processus disposant des privilèges élevés appropriés :

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

Remplacez l’identité et le chemin de l’exemple par les valeurs de l’utilisateur concerné. Utilisez une installation de la CLI approuvée par l’administrateur pour la configuration avec privilèges élevés.

Pour autoriser uniquement l’implémentation historique avec privilèges élevés, ajoutez ce qui suit à %ProgramData%\OpenAI\Codex\requirements.toml, et non à config.toml. Consultez Configurer une solution de repli historique :

[windows]
allowed_sandbox_implementations = ["elevated"]

Cela restreint la solution de repli historique sans bloquer MXC. Avant d’autoriser unelevated, examinez son isolation réseau plus faible et l’absence de prise en charge des chemins interdits en lecture.

Vérifier le déploiement de la CLI

Sous le compte d’un employé concerné, ouvrez une nouvelle fenêtre PowerShell sans privilèges d’administrateur :

Get-Command codex
codex --version
codex

Confirmez que l’exécutable trouvé correspond à l’installation prévue, puis suivez le processus de connexion approuvé. Exécutez une petite tâche dans un projet de test désigné et examinez la configuration active.

Gérer les mises à jour

Application de bureau

L’application recherche les mises à jour par défaut, y compris après une installation hors connexion. Pour activer les mises à jour automatiques, autorisez les appareils à accéder à persistent.oaistatic.com. Si vous désactivez les mises à jour automatiques, déployez les nouveaux packages au moyen de votre outil de gestion.

Suivez les instructions de la page Gérer les mises à jour de l’application pour coordonner toutes les sources de mise à jour. La désactivation du mécanisme de mise à jour intégré n’empêche pas Microsoft Store, Intune ou d’autres outils de gestion de mettre à jour l’application, et ne fournit ni verrouillage de version géré par OpenAI ni canal de publication distinct. Confirmez la version installée au moyen de votre système de déploiement.

Codex CLI

Pour chaque mise à jour de la CLI, choisissez une nouvelle version approuvée, mettez à jour la valeur explicite de -Release ou la version du package npm dans votre package de déploiement, puis mettez à jour sa règle de détection. Déployez-le selon votre processus de gestion des packages, puis vérifiez la version installée, le contexte du compte et le comportement de détection. Ne remplacez pas la commande du package géré par une commande d’installation sans version explicite. Consultez les versions de la CLI, la page Installation et mises à jour de la CLI et la sélection de version npm.

Dépannage

Installation et configuration de Codex CLI

Ressources connexes

• Installation de la CLI

• Configuration gérée

• Configuration du bac à sable Windows

• Application de bureau ChatGPT pour Windows

• Consultez le guide Microsoft de création de packages Win32

• Consultez les paramètres de déploiement Win32 de Microsoft