Déployer l’application de bureau ChatGPT pour Windows et Codex CLI

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

L’application de bureau ChatGPT et la CLI autonome s’installent dans des contextes différents. Avant de déployer la CLI, choisissez et validez le compte qui exécutera le programme d’installation.

Déployer l’application Windows

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

Avant le déploiement, configurez les contrôles applicables en suivant le guide Configuration gérée. Pour préparer l’exécution de commandes Codex dans l’application de bureau ChatGPT, suivez la procédure de configuration du bac à sable Windows. Vérifiez la compatibilité des appareils et, si nécessaire, configurez l’ancienne implémentation.

Les liens MSIX ci-dessous permettent de télécharger la dernière version pour chaque architecture. Ils ne donnent pas accès aux versions antérieures. Examinez le package téléchargé et conservez l’artefact approuvé dans votre système de déploiement. Suivez le guide Gérer les mises à jour de l’application pour coordonner le mécanisme de mise à jour intégré avec le Microsoft Store, Intune et les autres outils de déploiement.

%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

winget install --id 9PLM9XGG6VKS -s msstore

#Requires -RunAsAdministrator
$ErrorActionPreference = 'Stop'

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

Déployer Codex CLI sur Windows

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

Avant de commencer

• Identifiez les utilisateurs et les appareils Windows ciblés, ainsi que l’architecture du processeur de chaque appareil, puis choisissez une méthode d’installation. Vérifiez que les utilisateurs ont accès à Codex et peuvent suivre la procédure de connexion de votre organisation jusqu’au bout.

• Pour Intune, assurez-vous de disposer des autorisations de gestion des applications, d’appareils inscrits qui répondent aux prérequis de Microsoft pour la création de packages Win32 et d’un package d’installation sans assistance.

• Désignez un responsable 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 et de npm, ainsi que de l’emplacement des 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 la version approuvée au format x.y.z. Utilisez la même version dans votre package et votre règle de détection.

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

Programme d’installation PowerShell autonome. Depuis une nouvelle fenêtre PowerShell, téléchargez le programme d’installation et indiquez-lui 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 du package que vous avez vérifié, ainsi que la version sélectionnée, dans le package géré par votre service informatique. Définissez le contexte d’installation et le fonctionnement de la détection, de la désinstallation et des mises à jour. Sélectionner une version ne modifie pas les paramètres par défaut du programme d’installation liés au profil utilisateur et ne suffit pas à automatiser l’ensemble du 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 courant, utilise %LOCALAPPDATA%\Programs\OpenAI\Codex\bin comme répertoire des commandes et ajoute ce répertoire au PATH de l’utilisateur.

Si vous exécutez le programme d’installation sans le modifier sous le compte SYSTEM, il cible le profil et l’environnement de SYSTEM. Sélectionner Système dans Intune ne rend pas l’installation accessible à tous les utilisateurs.

Traitez séparément l’installation pour l’utilisateur, la distribution des stratégies sur l’appareil et la configuration du bac à sable approuvée par un administrateur. Lorsqu’une procédure nécessite le profil d’un employé, exécutez-la sous son identité plutôt que sous le compte SYSTEM.

Conservez ensemble les fichiers d’exécution de la CLI autonome. Copier uniquement codex.exe ne suffit pas à constituer un package autonome complet.

Créer et affecter le package de la CLI avec Intune

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

Intune exige une installation sans assistance. Les scripts de détection personnalisés doivent renvoyer le code de sortie 0 et écrire sur la sortie standard (stdout). Toute sortie sur stderr fait échouer la détection. Consultez le guide Ajouter et affecter une application Win32.

Vérifiez le fonctionnement de la CLI depuis le compte de l’employé, même si 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 que vous avez vérifiée pour déployer l’application, avec un programme d’installation et une règle de détection propres à la CLI. Les paramètres MSIX de l’application de bureau ChatGPT s’appliquent uniquement à cette application.

Configurer les exigences gérées

Par défaut, déployez les exigences Windows imposées par l’administrateur à l’emplacement suivant :

%ProgramData%\OpenAI\Codex\requirements.toml

Pour utiliser un autre emplacement, affectez à la valeur de chaîne RequirementsPath de la clé de registre HKLM\SOFTWARE\Policies\OpenAI\Codex le chemin absolu du fichier.

Distribuez le fichier avec votre outil de gestion des appareils. Accordez un accès en lecture aux utilisateurs concernés et empêchez les utilisateurs ordinaires de modifier cette stratégie gérée par l’administrateur.

Les exigences limitent les valeurs autorisées pour les paramètres. Les valeurs par défaut de la configuration servent de point de départ. Examinez le fichier local et la stratégie cloud applicable pour déterminer la configuration effective.

Choisissez les exigences relatives aux autorisations, aux approbations, à l’accès réseau et au fonctionnement du bac à sable. Consultez le guide 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 vérifier la stratégie effective. Ni l’installation de la CLI ni la distribution des exigences ne donnent accès à l’espace de travail.

Configurer le bac à sable Windows

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

Privilégier MXC sur les appareils compatibles

Pour utiliser MXC en priorité avec la CLI autonome, activez cette préférence dans config.toml :

[features]
prefer_mxc = true

Vous pouvez aussi imposer la valeur de ce paramètre via requirements.toml. Cette préférence autorise le recours à une ancienne implémentation lorsque MXC est indisponible. Avant de l’activer, vérifiez les prérequis pour l’appareil dans le guide du bac à sable Windows.

Avec la version 0.162.0 ou ultérieure de la CLI, exécutez ce test de compatibilité depuis le répertoire d’un 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 l’exécution de la commande qui demande explicitement MXC. Examinez également la configuration de 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 l’ancienne implémentation comme solution de repli

Lorsque MXC est indisponible ou désactivé, privilégiez l’ancienne implémentation elevated comme solution de repli. Sa configuration doit être approuvée par un administrateur, mais les commandes exécutées dans le bac à sable ne disposent pas de privilèges d’administrateur.

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

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

Remplacez l’identité et le chemin de l’exemple par ceux de l’utilisateur concerné. Pour cette configuration avec élévation de privilèges, utilisez une installation de la CLI jugée fiable par l’administrateur.

Pour que l’ancienne implémentation avec élévation de privilèges soit la seule autorisée comme solution de repli, ajoutez les lignes suivantes dans %ProgramData%\OpenAI\Codex\requirements.toml, et non dans config.toml. Consultez la section Configurer une ancienne implémentation comme solution de repli.

[windows]
allowed_sandbox_implementations = ["elevated"]

Ce paramètre limite le choix de l’ancienne implémentation sans bloquer MXC. Avant d’autoriser unelevated, tenez compte de son isolation réseau plus faible et du fait qu’elle ne prend pas en charge les interdictions de lecture par chemin.

Vérifier le déploiement de la CLI

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

Get-Command codex
codex --version
codex

Vérifiez que l’exécutable trouvé correspond à l’installation prévue, puis suivez la procédure de connexion approuvée. Exécutez une petite tâche dans un projet de test prévu à cet effet et examinez la configuration active.

Gérer les mises à jour

Application de bureau ChatGPT

Par défaut, l’application recherche les mises à jour, même 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 avec votre outil de gestion.

Suivez le guide Gérer les mises à jour de l’application pour coordonner toutes les sources de mise à jour. Désactiver le mécanisme de mise à jour intégré n’empêche pas le Microsoft Store, Intune ou d’autres outils de gestion de mettre l’application à jour. Cela ne permet pas non plus de fixer une version sous le contrôle d’OpenAI ni de disposer d’un canal de publication distinct. Vérifiez la version installée dans votre système de déploiement.

Codex CLI

Pour chaque mise à jour de la CLI, choisissez une nouvelle version approuvée. Dans votre package de déploiement, mettez à jour la valeur explicite de -Release ou la version du package npm, ainsi que la règle de détection. Déployez le package selon votre procédure habituelle, puis vérifiez la version installée, le contexte du compte et le fonctionnement de la détection. Conservez une version explicite dans la commande d’installation du package géré. Consultez les versions de la CLI, le guide Installation et mises à jour de la CLI et la documentation sur la sélection d’une version avec npm.

Désinstallation et données locales

Désinstallez l’application de bureau ChatGPT depuis les paramètres Windows ou votre outil de gestion, par exemple Intune ou SCCM. Le nettoyage s’effectue automatiquement pendant la désinstallation.

Par défaut, les discussions locales sur le code et les paramètres sont conservés dans le répertoire CODEX_HOME de l’utilisateur.

Pour supprimer également CODEX_HOME lors de la désinstallation, ajoutez les lignes suivantes au fichier config.toml de ce dossier avant de désinstaller l’application :

[desktop]
uninstall_codex_home = true

Dépannage

Installation et configuration de Codex CLI

Ressources associées

• Installation de la CLI

• Configuration gérée

• Configuration du bac à sable Windows

• Application de bureau ChatGPT pour Windows

• Consultez le guide Microsoft sur la création de packages Win32.

• Consultez la documentation Microsoft sur les paramètres de déploiement Win32.