Codex sous Windows : installer l’application ou la CLI, puis choisir le bac à sable ou WSL2

Quel Codex installer sous Windows

• L’application de bureau ChatGPT, si vous voulez une fenêtre. Codex y a sa propre vue de code à côté de Chat et Work, avec worktrees, tâches planifiées, Git, un navigateur intégré, aperçus de fichiers, plugins et skills. L’application est disponible avec tous les forfaits ChatGPT, y compris Free.
• La CLI Codex, si vous travaillez dans un terminal. Elle s’installe nativement avec un script PowerShell, ou avec npm.
• L’extension d’IDE, si vous travaillez dans un éditeur. OpenAI la cite à côté de l’application et de la CLI comme moyen d’utiliser Codex nativement sous Windows.
• Windows 11 est recommandé. Un Windows 10 récent et entièrement à jour est pris en charge sans garantie et nécessite la version 1809 ou ultérieure, pour ConPTY ; un Windows 10 plus ancien n’est pas recommandé. winget doit être disponible.

Comment télécharger et installer Codex sous Windows

1. Téléchargez l’application de bureau ChatGPT

   Récupérez-la via le lien Microsoft Store de la page d’OpenAI sur l’application Windows, ou installez-la avec winget depuis PowerShell. Ouvrez ChatGPT, connectez-vous et sélectionnez Codex.

   winget install --id 9PLM9XGG6VKS -s msstore

2. Ou installez la CLI Codex

   Ouvrez une nouvelle fenêtre PowerShell et lancez le programme d’installation d’OpenAI ; le relancer met Codex à jour. Avec Node.js installé, vous pouvez utiliser npm à la place. Depuis la CLI, codex app ouvre l’application de bureau, en l’installant si besoin, et /app y transfère la session en cours.

   # Native Windows installer (run it in a new PowerShell window)
   powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"
   
   # Or with npm, if Node.js is installed
   npm install -g @openai/codex
   
   # Start Codex and sign in
   codex

3. Connectez-vous

   Au premier lancement, choisissez Sign in with ChatGPT pour utiliser votre forfait, ou connectez-vous avec une clé API, facturée aux tarifs standard de l’API. Codex cloud nécessite la connexion ChatGPT. codex login status renvoie 0 une fois que vous êtes connecté.

4. Installez les outils que Codex appellera

   Codex utilise ce qui est installé sur le PC. OpenAI suggère Git, Node.js, Python, le SDK .NET et la CLI GitHub, tous via winget, puis de vous connecter à GitHub.

   winget install --id Git.Git
   winget install --id OpenJS.NodeJS.LTS
   winget install --id Python.Python.3.14
   winget install --id Microsoft.DotNet.SDK.10
   winget install --id GitHub.cli
   gh auth login

5. Choisissez où tourne l’agent

   Par défaut, l’agent tourne nativement dans PowerShell sous le bac à sable Windows. Pour le faire tourner dans WSL2, ouvrez Settings, passez l’agent de Windows native à WSL et redémarrez l’application. Dans les deux modes, sélectionnez Ask for approval sous la zone de saisie pour bénéficier de la protection du bac à sable. Pour les commandes qui nécessitent des droits d’administrateur, lancez l’application avec Run as administrator ; l’agent en hérite. Le terminal intégré peut être PowerShell, Command Prompt, Git Bash ou WSL.

Source : documentation Codex d’OpenAI, application Windows

PowerShell natif ou WSL2 ?

OpenAI conseille d’utiliser le bac à sable natif par défaut, et de choisir WSL2 quand vous avez besoin d’outils natifs Linux, que vous travaillez déjà dans WSL2, ou que les options natives ne conviennent pas à votre configuration. WSL1 n’est plus pris en charge : il fonctionnait jusqu’à Codex 0.114, et depuis la 0.115, le bac à sable Linux utilise bubblewrap et la prise en charge de WSL1 a pris fin.

Comment faire tourner Codex dans WSL2

1. Installez WSL2, puis Codex à l’intérieur

   Depuis un PowerShell administrateur, lancez wsl --install, puis wsl pour ouvrir le shell Linux. À l’intérieur, installez bubblewrap pour le bac à sable (sudo apt install bubblewrap ou sudo dnf install bubblewrap), lancez le script d’installation Linux et démarrez codex.

   # In PowerShell, run as administrator
   wsl --install
   wsl
   
   # Inside WSL: the sandbox needs bubblewrap (apt or dnf), then install Codex
   sudo apt install bubblewrap
   curl -fsSL https://chatgpt.com/codex/install.sh | sh
   codex

2. Gardez les dépôts dans le répertoire personnel Linux

   Clonez dans un dossier comme ~/code plutôt que sous /mnt/c, qui est plus lent. Si VS Code dans WSL ne trouve pas Codex, vérifiez où il se trouve avec which codex.

3. Partagez les réglages avec l’application Windows

   L’application Windows garde son Codex home dans %USERPROFILE%\.codex, tandis qu’une CLI dans WSL utilise le répertoire personnel Linux. Pour n’en partager qu’un, définissez CODEX_HOME dans WSL sur le dossier Windows.

   export CODEX_HOME=/mnt/c/Users/<windows-user>/.codex

4. Ouvrez des projets WSL dans l’application de bureau

   Choisissez Add new project (ou appuyez sur Ctrl+O) et tapez \\wsl$\. Si l’agent reste natif, il est plus fiable de garder les projets sur le disque Windows et d’y accéder depuis WSL via /mnt/<drive>/....

Source : documentation Codex d’OpenAI, Windows et WSL

Le bac à sable Windows de Codex : MXC, elevated et unelevated

Le bac à sable Windows permet à Codex de tourner nativement dans PowerShell, sans WSL ni machine virtuelle, tout en limitant ce que ses commandes et leurs processus enfants peuvent toucher sur le disque et sur le réseau. Il existe en trois implémentations. L’application de bureau choisit MXC automatiquement pour les comptes grand public sur les appareils qui le prennent en charge.

Configuration du bac à sable Windows de Codex

1. Vérifiez si MXC fonctionne sur votre PC

   Avec la CLI Codex 0.162.0 ou ultérieure, lancez ce test. Il doit afficher MXC_OK et se terminer avec le code 0.

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

2. Privilégiez MXC dans la CLI

   L’application de bureau privilégie déjà MXC pour les comptes grand public. Pour la CLI, ou dans un environnement d’entreprise, activez-le dans config.toml, dans votre Codex home.

   # config.toml in your Codex home (%USERPROFILE%\.codex)
   [features]
   prefer_mxc = true

3. Ou choisissez un ancien bac à sable

   Là où MXC n’est pas disponible, choisissez elevated, ou unelevated en dernier recours. Le bac à sable elevated nécessite qu’un administrateur approuve sa configuration. Dans la CLI, la commande /setup-default-sandbox lance cette configuration ; elle n’apparaît que sous Windows, quand Codex utilise le bac à sable dégradé à jeton restreint.

   # config.toml in your Codex home (%USERPROFILE%\.codex)
   [windows]
   sandbox = "elevated"   # or "unelevated"

4. Ou laissez le service informatique le configurer à l’avance

   Un administrateur peut provisionner le bac à sable elevated pour un autre utilisateur. Pour supprimer plus tard l’ancien bac à sable, lancez codex sandbox uninstall en tant qu’administrateur.

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

Source : documentation Codex d’OpenAI, bac à sable Windows

Échec de la configuration du bac à sable Windows de Codex ? Les solutions documentées

La page d’OpenAI sur le bac à sable Windows contient une liste de dépannage. Voici ce qu’elle couvre, sous les intitulés mêmes de la documentation.

• « My legacy sandbox setup failed » : les causes habituelles sont une invite UAC ou administrateur refusée, une stratégie qui bloque la création d’utilisateurs et de groupes locaux, la modification du pare-feu ou l’octroi de droits de connexion à l’utilisateur du bac à sable, ou une autre stratégie. Réessayez et approuvez l’invite, demandez au service informatique, ou utilisez le bac à sable unelevated en attendant.
• « I see Windows error 1385 » : Windows refuse à l’utilisateur du bac à sable le type de connexion dont il a besoin. Les droits de connexion de l’utilisateur du bac à sable font partie de ce qu’une stratégie peut bloquer : sur un PC géré, demandez donc au service informatique. MXC ne crée aucun compte Windows supplémentaire : sous Windows 11 24H2 ou 25H2, il ne dépend donc pas d’un utilisateur de bac à sable.
• « Codex switched me to the unelevated sandbox », « Codex warns that some folders are writable by Everyone », « Sandboxed commands cannot reach the network » et « Sandboxing worked before and then stopped » ont chacun leur propre entrée sur cette page.
• Pour le diagnostic, lisez CODEX_HOME/.sandbox/sandbox.log. N’envoyez jamais à qui que ce soit le dossier CODEX_HOME/.sandbox-secrets/.
• Vous cherchez « setup didn't finish » ? La documentation d’OpenAI n’a aucune entrée formulée ainsi. Le cas documenté le plus proche est « My legacy sandbox setup failed ».
• Si PowerShell refuse d’exécuter npm et affiche npm.ps1 cannot be loaded because running scripts is disabled on this system., la solution courante est Set-ExecutionPolicy -ExecutionPolicy RemoteSigned.

Sous Windows, Computer Use prend le contrôle de l’écran

Computer Use permet à Codex d’utiliser des applications de bureau en déplaçant le pointeur et en tapant au clavier. Dans l’application de bureau, il est disponible sur macOS et Windows, avec ChatGPT Work et Codex, dans les régions prises en charge. Pour l’activer, ouvrez Settings > Computer use, trouvez Any App sous Control, et sélectionnez Install ou activez l’interrupteur.

• Il tourne sur le bureau actif et ne peut pas travailler en arrière-plan. Pendant qu’une tâche tourne, il déplace le pointeur, tape au clavier et fait passer des fenêtres au premier plan : vous ne pouvez donc pas utiliser le PC en même temps.
• Pour le laisser travailler pendant votre absence, gardez le PC déverrouillé et en ligne, et suivez-le depuis votre téléphone avec le contrôle à distance, ou faites tourner l’application de bureau dans une machine virtuelle Windows, pour que Computer Use prenne le contrôle de la VM plutôt que de votre écran.
• L’utilisation verrouillée (locked use), qui permet à une tâche de continuer une fois l’ordinateur verrouillé, est réservée à macOS.
• Pour enregistrer les approbations d’applications, listez les applications dans $CODEX_HOME/config.toml sous [computer_use.windows], par exemple always_allowed_app_ids = ["mspaint.exe"].
• Sur tous les systèmes, Computer Use ne peut ni automatiser les applications de terminal ou ChatGPT lui-même, ni se connecter en tant qu’administrateur, ni approuver les demandes de sécurité et de confidentialité.

Contrôler Codex sur votre PC Windows depuis votre téléphone

Un PC Windows peut servir d’hôte de contrôle à distance, comme un Mac. L’application ChatGPT sur votre téléphone envoie les prompts et les approbations ; le PC exécute les commandes avec ses propres projets, fichiers, identifiants et outils. La configuration complète et les solutions aux problèmes se trouvent dans le guide du contrôle à distance de Codex.

• Sur le PC, ouvrez l’application de bureau ChatGPT et allez dans Settings > Connections > Control this Mac or PC, puis sélectionnez Set up ou Add. Scannez le QR code avec votre téléphone (iOS ou Android).
• Le PC apparaît alors sous Codex dans l’application ChatGPT. Les anciennes versions de l’application l’appellent Remote.
• Gardez le PC éveillé, en ligne, connecté et avec l’application de bureau ouverte ; s’il se met en veille ou perd le réseau, l’accès à distance s’arrête jusqu’à son retour. Pour les tâches qui utilisent Computer Use, gardez la session Windows déverrouillée.
• Le tableau des forfaits d’OpenAI indique le contrôle à distance mobile pour Plus, Pro, Business et Enterprise, pas pour une connexion par clé API. Dans un espace de travail ChatGPT, un administrateur devra peut-être d’abord activer l’accès Remote Control.
• Le PC peut aussi ouvrir des projets sur un serveur Linux comme hôte SSH : votre téléphone pilote alors Codex sur le serveur via le PC. Voir Codex sur un VPS et Codex sous Linux. Pour un Mac toujours allumé, voir plutôt Codex sur un Mac mini.

Donnez un poste permanent à Codex sur votre PC

Le contrôle à distance et Computer Use attendent toujours que vous lanciez chaque tâche. Crewmark transforme un chat Codex sur votre PC Windows en employé IA doté d’un rôle, d’objectifs, d’horaires de travail et d’une pulsation : pendant ses horaires, la CLI crewmark, qui tourne sous Windows comme sous macOS et Linux, le réveille pour qu’il prenne le ticket suivant sur un tableau partagé. Pour cela, le PC doit rester allumé.

1. Recrutez un employé

   Choisissez un rôle parmi les rôles d’employés IA, comme ingénieur logiciel, et rédigez ses objectifs et ses KPI.

2. Connectez un chat Codex sur le PC

   Reliez un chat Codex sur le PC à l’employé via la CLI crewmark. Cette conversation devient l’employé. Claude Code fonctionne aussi.

3. Fixez les horaires de travail et une pulsation

   En semaine seulement ou tous les jours, dans votre fuseau horaire, avec des horaires qui peuvent dépasser minuit. Pendant ces horaires, la CLI réveille l’employé toutes les 15, 30, 60, 120 ou 240 minutes. Voir les tâches longues avec Codex.

4. Assignez des tickets de n’importe où

   Créez et assignez des tickets sur le tableau de crewmark.ai depuis n’importe quel navigateur ; en assigner un réveille l’employé. Quand il a besoin d’une revue ou d’une décision, il passe le ticket en Needs action et vous pose la question sur le ticket. Des missions à lui confier se trouvent dans les cas d’usage de Codex.

FAQ