Installer Codex pas à pas sur Windows, macOS et Linux

Introduction

L'installation d'outils de développement peut souvent sembler intimidante, surtout lorsque l'on découvre ce domaine. On vous parle de terminal, de variables d'environnement, de dépendances... Des termes qui peuvent rapidement faire peur.

Rassurez-vous : en réalité, cette installation ne demande que quelques minutes et se résume à télécharger quelques logiciels classiques et à cliquer sur \"Suivant\".

Dans ce chapitre, nous allons installer tous les outils dont Codex a besoin pour fonctionner correctement. Vous serez guidé étape par étape. Aucune connaissance préalable n'est supposée. Chaque outil installé sera expliqué clairement pour que vous sachiez toujours exactement pourquoi vous faites une action, et pas seulement comment la faire.

À la fin de ce chapitre, votre ordinateur sera transformé en véritable station de développement moderne. Tout sera prêt.

Vue d'ensemble de l'installation

Voici les étapes que nous allons suivre pour installer Codex de manière propre et sécurisée.

Étape 1 : Créer un compte OpenAI

Codex est propulsé par les modèles d'intelligence artificielle d'OpenAI. Pour que l'outil puisse fonctionner sur votre ordinateur et comprendre votre code, il doit pouvoir communiquer avec les serveurs de l'entreprise.

Il vous faut donc créer un compte. Ce compte vous fournira plus tard une \"clé d'API\", une sorte de mot de passe sécurisé qui autorisera Codex à utiliser l'intelligence artificielle en votre nom.

Rendez-vous sur la plateforme pour développeurs d'OpenAI (platform.openai.com) et créez un compte. Attention, utiliser Codex via une API est un service payant à l'usage. Vous devrez configurer un moyen de paiement. Rassurez-vous : pour débuter, l'utilisation coûte généralement moins de quelques centimes par jour.

Étape 2 : Installer Visual Studio Code

Visual Studio Code (souvent appelé VS Code) n'est pas qu'un simple bloc-notes. C'est l'éditeur de code le plus utilisé au monde. C'est là que vous lirez vos fichiers, que vous écrirez vos instructions et que Codex vous répondra.

Codex s'intègre merveilleusement bien à VS Code, car Microsoft (le créateur de VS Code) est le principal partenaire d'OpenAI. Cet éditeur permet de gérer facilement vos fichiers, de repérer les erreurs avec des couleurs et d'ouvrir un terminal directement intégré.

Installation sur Windows

1. Rendez-vous sur le site officiel (code.visualstudio.com).
2. Téléchargez le programme d'installation pour Windows.
3. Lancez l'installateur. Laissez toutes les options par défaut, mais cochez absolument l'option \"Ajouter au chemin (PATH)\" si elle est proposée.
4. Cliquez sur Terminer.

Installation sur macOS

1. Rendez-vous sur le site officiel.
2. Téléchargez la version pour Mac (Universal, Apple Silicon ou Intel selon votre modèle).
3. Ouvrez le fichier téléchargé.
4. Glissez simplement l'icône de Visual Studio Code dans votre dossier Applications.

Installation sur Linux

1. Rendez-vous sur le site officiel et téléchargez le paquet correspondant (.deb pour Ubuntu/Debian, .rpm pour Fedora).
2. Utilisez le gestionnaire de paquets de votre distribution pour l'installer (par exemple `sudo apt install ./code_x.x.x.deb`).

Étape 3 : Découvrir le terminal

C'est souvent l'étape qui impressionne le plus. Pourtant, il n'y a aucune raison d'avoir peur. Le terminal est tout simplement une fenêtre noire avec du texte, qui vous permet de dialoguer directement avec l'ordinateur.

Imaginez que votre ordinateur est un cuisinier. Habituellement, vous utilisez une souris pour cliquer sur des menus (comme si vous pointiez des plats sur une carte). Avec le terminal, vous lui donnez vos instructions oralement (ou plutôt par écrit) en tapant des commandes précises.

• Sur Windows : Vous utiliserez l'Invite de commandes (cmd), PowerShell, ou mieux, le Windows Terminal. Dans VS Code, le terminal par défaut est souvent PowerShell.
• Sur macOS : L'application s'appelle simplement Terminal (ou iTerm2 pour les utilisateurs avancés).
• Sur Linux : Vous utilisez déjà certainement l'émulateur de terminal de votre environnement (GNOME Terminal, Konsole, etc.).

Le terminal ne fait rien sans votre accord. Tant que vous appuyez sur la touche \"Entrée\", il ne se passera absolument rien. Dans VS Code, vous pouvez ouvrir le terminal intégré en cliquant sur Terminal > Nouveau terminal dans le menu supérieur.

Étape 4 : Installer Git

Git est le système de gestion de versions par excellence. À quoi ça sert ? C'est votre machine à remonter le temps personnelle.

Quand vous codez, vous faites des erreurs. L'intelligence artificielle fait aussi des erreurs. Git permet de prendre des \"photos\" de votre projet à un instant T. Si l'IA modifie malencontreusement trente fichiers et casse tout, Git vous permettra d'annuler ces modifications en un seul clic.

Installation sur Windows

Téléchargez Git for Windows (git-scm.com). Lors de l'installation, il y a de nombreux écrans avec beaucoup d'options complexes. Laissez absolument tout par défaut et cliquez frénétiquement sur \"Next\" jusqu'à la fin.

Installation sur macOS

Ouvrez votre Terminal (via Spotlight) et tapez simplement `git`. Si Git n'est pas installé, macOS vous proposera automatiquement d'installer les \"Command Line Tools d'Apple\" qui incluent Git. Acceptez.

Installation sur Linux

Ouvrez votre terminal et tapez `sudo apt install git` (pour Ubuntu/Debian) ou la commande adaptée à votre distribution.

Vérification

Pour vérifier que Git est bien là, ouvrez un nouveau terminal dans VS Code et tapez :

git --version

Si l'ordinateur vous répond avec un numéro de version (ex: git version 2.40.1), c'est gagné !

Étape 5 : Installer Node.js

Node.js est l'environnement d'exécution qui permet de faire tourner du JavaScript directement sur votre ordinateur, et non plus seulement dans un navigateur web.

Pourquoi en avons-nous besoin ? Parce que Codex, comme la grande majorité des outils de développement modernes, a été programmé pour s'exécuter dans cet environnement. De plus, installer Node.js permet d'installer automatiquement npm.

Procédure d'installation

Que vous soyez sur Windows, macOS ou Linux, la procédure recommandée pour les débutants est la même :

1. Allez sur le site officiel (nodejs.org).
2. Téléchargez la version LTS (Long Term Support). C'est la version la plus stable. Évitez la version "Current" qui est destinée aux tests.
3. Lancez l'installateur et acceptez les options par défaut. Assurez-vous que l'option \"Add to PATH\" est cochée (elle l'est généralement d'office).
4. Redémarrez complètement Visual Studio Code.

Vérification

Ouvrez un nouveau terminal dans VS Code et tapez ces deux commandes (appuyez sur Entrée après chacune) :

node -v npm -v

Le terminal doit vous afficher deux numéros de version. Si c'est le cas, votre ordinateur est parfaitement configuré. Sinon, redémarrez votre PC.

Étape 6 : Installer Codex

Maintenant que le moteur (Node.js) et le magasin d'outils (npm) sont en place, nous pouvons enfin télécharger Codex.

Dans votre terminal VS Code, tapez la commande suivante :

npm install -g @openai/codex-cli

Explications :

• npm : on appelle notre magasin d'outils.
• install : on lui donne l'ordre d'installer.
• -g : signifie "global". On veut pouvoir utiliser Codex n'importe où sur notre ordinateur, pas seulement dans le dossier actuel.
• @openai/codex-cli : c'est le nom officiel du paquet de l'outil.

Une barre de chargement va apparaître. Le processus peut prendre quelques secondes. Des avertissements (WARN) jaunes peuvent s'afficher, c'est normal, ignorez-les. Tant qu'il n'y a pas d'erreur rouge (ERR), tout s'est bien passé.

Étape 7 : Premier lancement

L'outil est installé ! Il est temps de le réveiller et de lui dire qui vous êtes.

Tapez la commande suivante dans votre terminal :

codex login

Ce qui va se passer :

1. Un message va s'afficher vous demandant d'appuyer sur Entrée pour ouvrir votre navigateur.
2. Votre navigateur va s'ouvrir sur la page de connexion OpenAI.
3. Connectez-vous avec le compte créé à l'Étape 1.
4. Une page vous demandera d'autoriser Codex à accéder à votre compte. Acceptez.
5. Revenez dans VS Code. Le terminal vous affichera un message de succès (ex: Successfully logged in!).

Félicitations. Codex est maintenant lié à votre compte et prêt à travailler.

Vérifier que l'installation est réussie

Faisons le point. Avant de passer au chapitre suivant, assurez-vous de cocher toutes ces cases :

• [ ] Visual Studio Code s'ouvre correctement.
• [ ] git --version renvoie bien un numéro dans le terminal.
• [ ] node -v renvoie bien un numéro.
• [ ] npm -v renvoie bien un numéro.
• [ ] L'installation de Codex n'a généré aucune erreur bloquante.
• [ ] La commande codex login a fonctionné.

Si toutes les cases sont cochées, votre installation est un succès complet.

Les erreurs les plus fréquentes

L'informatique n'est pas une science exacte, surtout lors d'une première installation. Si quelque chose ne fonctionne pas, cherchez votre symptôme dans cette liste.

• Symptôme : "node n'est pas reconnu en tant que commande interne ou externe" (Windows) ou "command not found: node" (Mac/Linux).
  Cause : Vous n'avez pas relancé le terminal après l'installation de Node.js, ou la variable PATH n'a pas été mise à jour.
  Solution : Fermez et rouvrez VS Code. Si ça persiste, redémarrez votre PC. Sur Windows, réinstallez Node.js en vous assurant que "Add to PATH" est coché.
• Symptôme : "git is not recognized"
  Cause : Même problème que Node.js, mais avec Git.
  Solution : Redémarrez le terminal.
• Symptôme : EACCES: permission denied lors de `npm install -g`
  Cause : Sur Mac ou Linux, votre compte utilisateur n'a pas les droits pour écrire dans les dossiers globaux.
  Solution : Précédez votre commande du mot "sudo" : `sudo npm install -g @openai/codex-cli`. L'ordinateur vous demandera votre mot de passe de session (celui que vous tapez à l'allumage).
• Symptôme : L'exécution de scripts est désactivée sur ce système (Erreur PowerShell Windows)
  Cause : Windows Defender bloque les scripts locaux par sécurité.
  Solution : Ouvrez PowerShell en tant qu'administrateur, tapez `Set-ExecutionPolicy RemoteSigned`, appuyez sur Entrée, puis sur "O" pour Oui.
• Symptôme : "npm ERR! code ENOTFOUND"
  Cause : npm ne parvient pas à se connecter à Internet.
  Solution : Vérifiez votre connexion. Si vous êtes en entreprise, un proxy ou un firewall bloque l'accès. Il faudra configurer npm pour qu'il utilise le proxy de l'entreprise.
• Symptôme : "npm WARN deprecated..."
  Cause : Certaines dépendances de Codex sont un peu anciennes.
  Solution : Aucune. Les avertissements jaunes (WARN) sont normaux et ne bloquent pas le fonctionnement.
• Symptôme : La fenêtre du navigateur ne s'ouvre pas lors du `codex login`
  Cause : Le terminal ne parvient pas à lancer votre navigateur par défaut.
  Solution : Codex affiche généralement un lien complet dans le terminal. Copiez l'URL commençant par "http..." et collez-la manuellement dans Chrome ou Safari.
• Symptôme : "Unauthorized / Invalid API Key" lors du premier essai
  Cause : Votre compte OpenAI n'est pas lié à un moyen de paiement valide, ou vous n'avez plus de crédits.
  Solution : Allez sur le site d'OpenAI (platform.openai.com) et vérifiez votre section Facturation (Billing).
• Symptôme : Le terminal se ferme tout seul quand je l'ouvre.
  Cause : Configuration corrompue du profil de terminal dans VS Code.
  Solution : Dans VS Code, utilisez Ctrl+Maj+P (ou Cmd+Maj+P), tapez "Select Default Profile" et choisissez "Command Prompt" (Windows) ou "bash" (Mac).
• Symptôme : npm bloque indéfiniment sur "idealTree:lib"
  Cause : Problème réseau ou cache corrompu.
  Solution : Annulez avec Ctrl+C. Tapez `npm cache clean --force` puis réessayez.
• Symptôme : "Version trop ancienne"
  Cause : Vous avez installé une très vieille version de Node.js.
  Solution : Allez sur le site officiel de Node.js, téléchargez la dernière LTS et installez-la par-dessus l'ancienne.
• Symptôme : "Error: ENOSPC system limit for number of file watchers reached" (Linux)
  Cause : Linux refuse de surveiller autant de fichiers.
  Solution : Augmentez la limite avec `echo fs.inotify.max_user_watches=524288 | sudo tee -a /etc/sysctl.conf && sudo sysctl -p`.
• Symptôme : L'icône Git n'apparaît pas dans VS Code
  Cause : VS Code n'a pas détecté l'installation de Git.
  Solution : Assurez-vous d'avoir redémarré VS Code. Sinon, vérifiez l'emplacement d'installation.
• Symptôme : VS Code demande d'installer des extensions recommandées sans arrêt.
  Cause : VS Code détecte les langages que vous utilisez.
  Solution : Installez-les, elles sont toujours très utiles !
• Symptôme : Vous vous sentez perdu face à ce vocabulaire technique.
  Cause : C'est totalement normal.
  Solution : Prenez une grande respiration. Vous venez d'accomplir le plus difficile. La suite sera beaucoup plus intuitive.

Foire aux questions

À retenir

Transition vers le chapitre suivant

L'atelier est monté. Les outils sont rangés. Le moteur tourne. Il est temps de construire quelque chose de concret.

Dans le prochain chapitre, nous allons créer ensemble votre tout premier projet de développement et adresser votre toute première véritable requête à Codex.