Un site renvoie une erreur 502. Plutôt que de copier des journaux dans un chatbot, vous demandez à un agent IA installé sur le serveur d’inspecter les fichiers concernés et d’expliquer le problème. C’est un usage concret de Codex CLI sur un VPS Linux.
Ce guide couvre l’installation, la connexion depuis une session SSH et une première tâche avec des permissions restreintes. Nous expliquons ensuite le véritable test derrière notre vidéo : Codex a identifié une incohérence de port sur un site de démonstration volontairement cassé.
Ce qui tourne où : l’agent Codex et ses outils en ligne de commande s’exécutent sur votre VPS. Avec la configuration OpenAI décrite ici, le modèle d’IA tourne dans le cloud d’OpenAI. Il vous faut votre propre compte ChatGPT éligible ou un accès à l’API OpenAI facturé séparément. Un VPS SharpHeberg n’inclut pas cet accès.
Avant de commencer
- Un VPS Linux accessible en SSH, avec un accès HTTPS sortant. Les commandes de paquets ci-dessous ciblent Debian et Ubuntu.
- Un utilisateur Linux standard disposant de sudo pour installer les paquets système. Exécutez Codex avec cet utilisateur, pas en root.
- Un compte OpenAI avec accès à Codex. Vérifiez la disponibilité et les limites actuelles de votre offre ; la facturation de l’API est distincte d’un abonnement ChatGPT.
- Un projet de test ou un environnement de préproduction. Gardez les identifiants de production et les fichiers clients sans rapport en dehors du compte et de l’espace de travail accessibles à l’agent.
Vous n’avez pas besoin d’héberger les poids du modèle ni de provisionner un GPU pour ce workflow adossé au cloud. Les ressources que consomment vos projets, vos outils de build et vos services comptent toujours dans le choix d’un VPS.
Périmètre de validation : notre démonstration de diagnostic a tourné sur un VPS Debian 12 jetable avec Codex CLI 0.164.0. Cette expérience isolée utilisait un compte de diagnostic privilégié ; ce n’est pas la configuration de compte que nous recommandons en production. Nous avons aussi vérifié l’installeur autonome officiel dans un répertoire d’installation Linux x86-64 isolé, ainsi que la version de la CLI et les options de connexion/sandbox. Nous n’avons pas testé toutes les versions d’Ubuntu ni toutes les configurations de VPS.
1. Connectez-vous à votre VPS
Depuis votre propre ordinateur, connectez-vous avec votre compte SSH existant non-root. Remplacez l’utilisateur et l’adresse d’exemple :
ssh youruser@YOUR_VPS_IP
Si votre serveur n’a qu’un compte root, créez et vérifiez d’abord un compte distinct en suivant les instructions d’administration de votre système d’exploitation. Vous ne devriez pas donner à un agent IA un shell root juste pour commencer.
Sous Debian ou Ubuntu, installez les outils de téléchargement et de gestion de projet utilisés dans ce guide :
sudo apt update
sudo apt install ca-certificates curl git less
Ces commandes installent des paquets système ; elles ne mettent pas à niveau tout le serveur et ne modifient pas votre pare-feu.
2. Installez Codex CLI
OpenAI documente un installeur autonome pour macOS et Linux, ainsi que des alternatives avec npm et Homebrew. La voie autonome ne vous oblige pas à installer d’abord Node.js et npm. Consultez le guide d’installation officiel de Codex CLI.
Téléchargez l’installeur dans votre propre répertoire afin de pouvoir l’inspecter avant de l’exécuter :
mkdir -p "$HOME/codex-setup"
curl -fsSL https://chatgpt.com/codex/install.sh -o "$HOME/codex-setup/install.sh"
less "$HOME/codex-setup/install.sh"
Appuyez sur q pour quitter less. Après avoir relu le script, exécutez-le avec votre utilisateur standard :
sh "$HOME/codex-setup/install.sh"
export PATH="$HOME/.local/bin:$PATH"
codex --version
codex --help
L’installeur officiel utilise par défaut ~/.local/bin et gère son paquet autonome dans le répertoire utilisateur de Codex. Il peut modifier le fichier de démarrage de votre shell. Rouvrez votre terminal lorsque cela vous est demandé ; l’export ci-dessus rend aussi l’emplacement d’installation par défaut disponible dans la session en cours.
Si l’URL de téléchargement courte échoue : la source de l’installeur est aussi disponible dans le dépôt officiel OpenAI Codex. Téléchargez cette source, inspectez-la, puis suivez les mêmes étapes d’installation :
curl -fsSL https://raw.githubusercontent.com/openai/codex/main/scripts/install/install.sh -o "$HOME/codex-setup/install.sh"
less "$HOME/codex-setup/install.sh"
sh "$HOME/codex-setup/install.sh"
Ne le remplacez pas par un script provenant d’un miroir inconnu. Si le téléchargement du binaire lui-même échoue, OpenAI documente CODEX_INSTALLER_USE_RELEASES_OPENAI_COM=false pour sélectionner les GitHub Releases :
CODEX_INSTALLER_USE_RELEASES_OPENAI_COM=false sh "$HOME/codex-setup/install.sh"
Si vous gérez déjà une installation Node.js/npm prise en charge, l’alternative npm documentée est npm install -g @openai/codex. Choisissez une seule méthode d’installation plutôt que d’en mélanger plusieurs en vous demandant quel codex figure dans votre PATH.
3. Connectez-vous depuis un serveur sans interface graphique
Votre VPS n’a généralement pas de navigateur de bureau. OpenAI recommande l’authentification par code d’appareil dans ce cas :
codex login --device-auth
Suivez le lien affiché dans votre terminal depuis votre propre ordinateur ou votre téléphone, connectez-vous et saisissez le code à usage unique. Vous devrez peut-être d’abord activer la connexion par code d’appareil dans vos paramètres de sécurité ChatGPT, ou demander à l’administrateur de votre espace de travail de l’autoriser. N’envoyez jamais ce code à quelqu’un d’autre.
Vérifiez ensuite la méthode d’authentification :
codex login status
Si la connexion par code d’appareil n’est pas disponible, OpenAI documente aussi un tunnel SSH pour le flux de connexion habituel par navigateur. Lancez cette connexion depuis votre ordinateur :
ssh -L 1455:localhost:1455 youruser@YOUR_VPS_IP
Dans cette session SSH, exécutez codex login et ouvrez son lien de connexion dans votre navigateur local. Cela redirige le callback localhost sans exposer publiquement de port d’authentification. Consultez les instructions d’OpenAI pour la connexion sans interface si votre environnement utilise une autre configuration de callback.
Utiliser plutôt une clé d’API
Si vous préférez un accès à l’API facturé à l’usage, provisionnez votre propre clé d’API OpenAI de manière sécurisée dans une variable d’environnement, puis transmettez-la via l’entrée standard :
printenv OPENAI_API_KEY | codex login --with-api-key
Ne collez pas une clé d’API en clair dans une commande enregistrée dans l’historique du shell. L’utilisation de l’API est facturée via votre compte OpenAI Platform et n’est pas déduite de votre facture d’hébergement VPS. Traitez les identifiants stockés par Codex comme des mots de passe et gardez-les hors des dépôts, des captures d’écran et des tickets de support. Le guide d’authentification officiel explique les deux méthodes.
4. Commencez par une tâche en lecture seule
Placez-vous dans un projet de test dont vous comprenez les fichiers. Si vous n’en avez pas, un répertoire vide suffit pour ouvrir la CLI et inspecter l’interface :
mkdir -p "$HOME/codex-first-session"
cd "$HOME/codex-first-session"
codex --sandbox read-only --ask-for-approval on-request
Dans un vrai dépôt de test, un premier prompt utile est :
Explain how this project starts. Read the relevant configuration and README files, identify the entry point, and list anything you cannot verify. Do not change files or install packages.
read-only restreint les commandes générées par le modèle via le sandbox configuré. on-request permet au modèle de demander une approbation supplémentaire ; cela ne veut pas dire que chaque commande exige automatiquement une confirmation. Lisez toute demande d’élévation avant de décider de l’autoriser.
Un prompt disant « ne modifie rien » n’est pas une frontière de sécurité en soi. Utilisez un compte dédié et un environnement de test, limitez les données accessibles et vérifiez les permissions présentées par votre version installée. Un accès en lecture seule peut quand même exposer le contenu des fichiers lisibles au service du modèle.
Consultez codex --help et la référence des commandes de la CLI avant de copier des options d’un ancien tutoriel. Évitez de contourner le sandbox ou les approbations pour résoudre une erreur d’installation.
5. Passez de l’explication à une tâche serveur utile
Une étape suivante raisonnable consiste à donner à Codex un périmètre de diagnostic réduit et explicite. Préparez des copies nettoyées des journaux et de la configuration concernés dans un répertoire de test, puis demandez :
This demo site returns HTTP 502. Inspect only the supplied nginx configuration, application entry point and error log. Explain the cause and propose the smallest fix. Do not edit files, install packages or restart services.
Relisez la modification proposée avant de l’appliquer vous-même. Pour un vrai service, sauvegardez la configuration, validez-la avec la vérification propre au service et préparez un retour arrière. Une explication d’IA ne prouve pas qu’une modification est sûre pour la production.
Ce qui s’est passé dans notre démonstration
Nous avons volontairement mal configuré un site de démonstration sur un VPS jetable. Nginx transmettait les requêtes au port 3000, alors que l’application écoutait sur 3001. Le site renvoyait un code HTTP 502.
Codex a inspecté la configuration, l’application et le journal d’erreurs sélectionnés en mode lecture seule. Il a identifié l’incohérence et proposé une correction d’une seule ligne en 22 secondes environ, sans modifier les fichiers fournis. Notre opérateur de production a appliqué cette proposition, vérifié la configuration nginx, rechargé le service et constaté une réponse HTTP 200.
Il s’agissait d’un test contrôlé avec une panne connue, introduite volontairement. Ce n’est ni un benchmark, ni une garantie de délai de réparation, ni une démonstration de reprise de production sans surveillance.
Si quelque chose ne fonctionne pas
codex: command not found: rouvrez le terminal, vérifiezcommand -v codexet confirmez que le répertoire de l’installeur figure dans votre PATH.- L’URL de l’installeur ou le téléchargement est bloqué : utilisez la source du dépôt officiel et la sélection GitHub Releases documentée ci-dessus. Ne désactivez pas la vérification TLS.
- La connexion ne peut pas ouvrir de navigateur : utilisez la connexion par code d’appareil ou le tunnel SSH documenté. Ne publiez pas de ports d’authentification localhost.
- Vous atteignez une limite d’utilisation : vérifiez le compte et la méthode d’authentification affichés par
codex login status. Installer la CLI ou acheter un VPS ne supprime pas les limites d’utilisation d’OpenAI. - Erreurs de sandbox ou d’outils auxiliaires : conservez l’installation officielle complète et vérifiez la prise en charge par votre distribution des mécanismes d’isolation requis. Un conteneur ou un VPS restreint peut imposer des contraintes supplémentaires. Ne résolvez pas cela en exécutant Codex en root ou en désactivant ses garde-fous.
Regardez la démonstration, puis essayez sur votre propre VPS
Notre vidéo d’accompagnement suit l’exemple de diagnostic, du site cassé à la réponse vérifiée. Elle montre ce que l’agent installé peut vous aider à investiguer ; les commandes d’installation figurent dans ce guide.
Démonstration contrôlée sur un VPS de test jetable : Codex propose la correction ; notre opérateur l’applique et la vérifie. Regarder la démonstration sur YouTube.
Commencez par un projet de test, gardez les permissions de l’agent étroites et vérifiez chaque résultat. Si vous avez besoin d’un serveur pour cet espace de travail, découvrez les offres VPS Linux de SharpHeberg. Votre compte OpenAI et son utilisation restent distincts du service d’hébergement.