Codex sur un VPS : l’installer sur un serveur Linux et s’y connecter en SSH

Comment s’articule Codex sur un VPS

Trois machines interviennent, chacune avec un seul rôle :

• Le serveur Linux fait tourner Codex. Les chats de ses projets y exécutent des commandes, y lisent des fichiers et y écrivent des modifications, avec les dépendances, les politiques de sécurité et la puissance de calcul du serveur. L’application de bureau y démarre Codex en SSH, dans le shell de connexion de l’utilisateur distant.
• Un Mac ou un PC Windows fait tourner l’application de bureau ChatGPT, qui maintient la connexion SSH. C’est l’hôte auquel parle votre téléphone : il doit donc lui aussi rester éveillé et en ligne.
• Votre téléphone fait tourner l’application ChatGPT et contrôle cet hôte grâce au contrôle à distance. Il envoie les prompts et les approbations, et vous montre les diffs, la sortie du terminal et les notifications.
• OpenAI ne documente que macOS et Windows comme hôtes de contrôle à distance : appairer un téléphone directement avec un serveur Linux n’est donc pas documenté. Appairez plutôt votre téléphone avec le Mac ou le PC, idéalement un Mac mini toujours allumé.

Ce qu’il vous faut

• Un serveur Linux accessible en SSH. Le guide d’installation de la CLI Codex sur GitHub indique Ubuntu 20.04+ ou Debian 10+, avec 4 Go de RAM au minimum et 8 Go recommandés ; des builds de release existent pour x86_64 et ARM64.
• Un Mac ou un PC Windows avec l’application de bureau ChatGPT, pour ajouter le serveur comme hôte SSH. Si vous voulez joindre le serveur depuis votre téléphone, cet ordinateur doit rester allumé.
• Un compte ChatGPT pour Codex. Le tableau des forfaits d’OpenAI indique les connexions à distance SSH sur Plus, Pro, Business et Enterprise ainsi qu’avec une clé API, et le contrôle à distance mobile sur Plus, Pro, Business et Enterprise, mais pas avec une clé API.
• L’application ChatGPT sur votre téléphone, iOS ou Android.

Comment configurer Codex sur un VPS Linux

1. Louez un serveur et vérifiez l’accès SSH

   Créez un serveur Linux et assurez-vous de pouvoir vous y connecter en SSH depuis le Mac ou le PC qui fera tourner l’application de bureau. Utilisez une connexion par clé et un compte qui n’a que les droits dont Codex a besoin, pas root.

2. Installez la CLI Codex sur le serveur

   Lancez le script d’installation d’OpenAI sur le serveur ; la même commande le met à jour plus tard, et npm fonctionne aussi. Installez bubblewrap pour le bac à sable de Codex : sans bwrap dans le PATH, Codex se rabat sur un utilitaire intégré qui nécessite des user namespaces non privilégiés, et affiche un avertissement au démarrage. Ubuntu 24.04 peut continuer d’avertir tant que vous n’avez pas chargé le profil AppArmor bwrap-userns-restrict.

   # On the server: install the Codex CLI (run it again to update)
   curl -fsSL https://chatgpt.com/codex/install.sh | sh
   # or: npm install -g @openai/codex
   
   # Codex's sandbox on Linux uses bubblewrap
   sudo apt install bubblewrap   # Fedora: sudo dnf install bubblewrap

3. Connectez-vous sur un serveur headless

   Le serveur n’a pas de navigateur : utilisez donc la connexion par code d’appareil. Lancez codex login --device-auth, ou choisissez Sign in with Device Code, et suivez les instructions. Elle est en bêta, et la connexion par code d’appareil doit d’abord être activée dans vos paramètres de sécurité ChatGPT ou par l’administrateur de votre espace de travail. Si vous ne pouvez pas l’utiliser, redirigez le callback de connexion avec ssh -L 1455:localhost:1455 et lancez codex login sur le serveur, ou copiez ~/.codex/auth.json depuis un ordinateur où vous êtes connecté, et traitez ce fichier comme un mot de passe.

   # Headless sign-in (beta; turn on device code login in ChatGPT first)
   codex login --device-auth
   
   # Or forward the browser callback from your computer, then run codex login
   ssh -L 1455:localhost:1455 you@devbox.example.com
   
   # Exits 0 once you're signed in
   codex login status

4. Ajoutez le serveur à votre configuration SSH

   Sur le Mac ou le PC, ajoutez une entrée Host dans ~/.ssh/config et vérifiez que ssh devbox fonctionne. Codex lit les alias d’hôtes concrets de ce fichier et ignore les entrées qui ne sont que des motifs. L’application de bureau démarre Codex dans le shell de connexion de l’utilisateur distant : codex doit donc s’y trouver dans le PATH.

   # ~/.ssh/config on the Mac or PC running the ChatGPT desktop app
   Host devbox
     HostName devbox.example.com
     User you
     IdentityFile ~/.ssh/id_ed25519
   
   # Check it works before adding it in the app
   ssh devbox

5. Ajoutez-le comme hôte SSH dans l’application de bureau

   Dans l’application de bureau ChatGPT, ouvrez Settings > Connections, ajoutez ou activez l’hôte SSH, puis choisissez un dossier de projet sur le serveur. Les chats de ce projet exécutent des commandes, lisent des fichiers et écrivent des modifications sur le serveur.

6. Contrôlez-le depuis votre téléphone

   Sur le même Mac ou PC, ouvrez Settings > Connections > Control this Mac or PC, sélectionnez Set up ou Add, et scannez le QR code avec l’application ChatGPT. Ouvrez Codex sur votre téléphone, choisissez cet ordinateur et le projet du serveur, et démarrez un chat. Le chat tourne sur le serveur via le Mac ou le PC : gardez donc cet ordinateur éveillé et en ligne ; un Mac mini à la maison peut tenir ce rôle. Les détails de configuration et les solutions aux problèmes se trouvent dans le guide du contrôle à distance de Codex.

Source : documentation d’OpenAI sur les remote connections et les hôtes SSH

Terminal seul : la CLI Codex en SSH dans tmux

Si un terminal vous suffit, vous pouvez vous passer de l’application de bureau. Connectez-vous au serveur en SSH, lancez la CLI Codex dans tmux et détachez-vous : Codex continue de tourner après votre déconnexion, et vous vous rattachez depuis n’importe quel ordinateur capable de s’y connecter en SSH.

1. Lancez Codex dans tmux

   Installez tmux depuis les paquets de votre distribution s’il n’est pas présent, démarrez une session et lancez codex dans le dossier de votre projet.

   # On the server: run Codex inside tmux so it outlives your SSH connection
   tmux new -s codex
   cd ~/my-project
   codex
   
   # Detach with Ctrl+B, then D. Reattach later with:
   tmux attach -t codex

2. Sachez ce que cela ne fait pas

   Cette configuration n’est pas reliée à votre téléphone. Selon OpenAI, la configuration mobile part de l’application de bureau et ne peut pas se faire depuis la CLI. La CLI dispose d’une commande expérimentale codex remote-control, que la documentation associe à des clients de contrôle à distance gérés et à des workflows SSH, mais elle ne décrit pas l’appairage d’un téléphone avec un serveur qui ne fait tourner que la CLI.

Sécuriser le serveur

• Traitez-le comme n’importe quel serveur SSH : clés de confiance, compte aux privilèges minimaux, et aucun service non authentifié en écoute sur l’Internet public.
• N’exposez pas l’app server de Codex. codex app-server --listen et codex --remote servent surtout au développement et au débogage, et OpenAI déconseille d’ouvrir les transports de l’app server sur un réseau partagé ou public.
• Pour joindre le serveur depuis l’extérieur de son réseau, utilisez un VPN ou un réseau maillé comme Tailscale, qui ne relie que vos propres appareils via des liaisons WireGuard chiffrées.
• Gardez ~/.codex/auth.json privé ; OpenAI recommande de le traiter comme un mot de passe.
• Les réglages du bac à sable, les contrôles de sécurité et les approbations s’appliquent aux chats sur le serveur comme en local, et le bac à sable sous Linux nécessite bubblewrap.

Déplacer un chat entre votre ordinateur et le serveur

L’application de bureau peut transférer un chat, avec son état Git, entre votre ordinateur et un hôte SSH connecté. Les deux doivent avoir un projet enregistré pour le même dépôt Git. Dans le pied du chat, sélectionnez l’endroit où il tourne actuellement, choisissez l’hôte de destination (This computer le ramène), vérifiez et sélectionnez Hand off. Codex y crée ou réutilise un worktree. Une réponse encore en cours est interrompue, et un chat ne peut pas être transféré vers Codex cloud.

Pas de serveur du tout : Codex cloud

• Codex cloud exécute des tâches de code dans le cloud d’OpenAI. Chaque tâche dispose de son propre espace de travail et continue pendant que votre ordinateur est en veille.
• Lancez-les depuis le web, depuis l’application de bureau (Work in > Cloud) ou depuis l’application ChatGPT sur votre téléphone (ouvrez Codex, choisissez Cloud et un environnement). Avec l’environnement par défaut, vous pouvez commencer sans choisir de dépôt, et Codex peut récupérer des dépôts depuis votre compte GitHub ou GitLab connecté.
• Une tâche cloud ne voit que son environnement cloud : vos fichiers locaux, vos processus en cours, vos connexions dans le navigateur et votre accès VPN ne sont pas repris. Les configurations réutilisables se trouvent sous Work in > Cloud > Select environment > Create environment.
• Il faut une connexion ChatGPT, pas une clé API. Depuis un terminal, codex cloud ouvre un sélecteur de vos chats cloud et codex cloud exec soumet une tâche.

Hôte Mac mini, hôte SSH Linux ou Codex cloud

Donnez un poste permanent au serveur

Un serveur qui ne se met jamais en veille attend tout de même votre prochain prompt. Crewmark transforme un chat Codex sur ce serveur en employé IA doté d’un rôle, d’un objectif chiffré, d’horaires de travail et d’une pulsation : pendant les horaires de travail, la CLI crewmark, qui tourne sous Linux comme sous macOS et Windows, réveille l’employé pour qu’il traite ses tickets sur un tableau partagé. L’ordinateur sur lequel il tourne doit rester allumé, et c’est le cas d’un VPS.

1. Recrutez un employé

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

2. Connectez Codex sur le serveur

   Collez le lien de configuration dans un chat Codex sur le serveur. Il installe la CLI crewmark et relie ce chat à l’employé. Claude Code fonctionne aussi ; voir Claude Code sur un VPS.

3. Fixez les horaires de travail et une pulsation

   En semaine seulement ou tous les jours, des horaires qui peuvent dépasser minuit, et un réveil toutes les 15, 30, 60, 120 ou 240 minutes. Chaque réveil arrive dans le même chat Codex, pour qu’il reprenne là où il s’était arrêté. Les options de planification propres à Codex sont comparées dans Codex proactif.

4. Assignez des tickets et parlez-lui depuis votre téléphone

   Ouvrez crewmark.ai dans le navigateur de votre téléphone pour créer et assigner des tickets, ou écrivez à l’employé dans son Work log ; le message arrive dans le chat Codex sur le serveur, et il y répond. Assigner un ticket le réveille immédiatement, et 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