Guide Codex CLI pour débutants : de l'installation à votre première tâche de codage IA

Ce que ce tutoriel vous apprend

Codex CLI est l'agent de codage d'OpenAI qui s'exécute dans votre terminal. Il peut inspecter votre projet, modifier des fichiers, exécuter des commandes et automatiser des tâches répétitives — le tout depuis la ligne de commande. À la fin de ce tutoriel, vous saurez installer Codex CLI sur Windows, macOS ou Linux, vous connecter et effectuer votre première tâche de codage assistée par IA.

Temps nécessaire : 15–20 minutes

Difficulté : Débutant

Avant de commencer

Qu'est-ce qu'un terminal ? Un terminal (aussi appelé ligne de commande) est une fenêtre où vous tapez des commandes au lieu de cliquer sur des boutons. Sous Windows, il s'appelle PowerShell ; sous macOS, il s'appelle Terminal. Dans ce tutoriel, les commandes codex se saisissent dans cette fenêtre, puis on appuie sur Entrée.

Qu'est-ce que Node.js ? Node.js est un programme gratuit qui permet d'installer des outils avec la commande npm. Vous n'en avez besoin que si vous choisissez la méthode d'installation via npm. Si vous ne l'avez pas, installez-le depuis nodejs.org (choisissez la version LTS).

Qu'est-ce qu'une clé API ? Une clé API est un code secret qui identifie votre compte lors d'un paiement à l'utilisation. Elle se génère une seule fois sur platform.openai.com → API keys. Traitez-la comme un mot de passe : ne la partagez jamais.

Comment ouvrir votre terminal (pas à pas)

Si vous ne savez pas comment ouvrir un terminal, suivez les étapes correspondant à votre système ci-dessous. Vous l'utiliserez pour toutes les commandes de ce tutoriel.

Téléchargement et installation

Choisissez votre version

Qu'est-ce que Homebrew ? Homebrew est un gestionnaire de paquets gratuit pour macOS. On tape brew install pour installer des programmes, comme une boutique d'applications pour la ligne de commande. Choisissez cette option uniquement si vous utilisez déjà Homebrew.

Installation pour votre système

Sélectionnez votre système dans le panneau ci-dessous. Chaque onglet contient toutes les étapes complètes pour ce système.

powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"

codex --version

powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"

Connexion

1. 1Ouvrez un terminal et accédez à un dossier de projet (remplacez path/to/your/project par votre propre chemin) :

cd path/to/your/project

1. 1Lancez Codex :

codex

1. 1La première fois, choisissez une méthode de connexion :

• Se connecter avec ChatGPT — utilisez votre compte ChatGPT (abonnement). Une fenêtre de navigateur s'ouvre ; après la connexion, le navigateur renvoie vos identifiants à Codex automatiquement.
• Utiliser une clé API — collez la clé générée sur platform.openai.com lorsqu'on vous le demande.

1. 1Après la connexion, vous verrez l'invite de Codex, prêt pour votre première tâche.

Dépannage de l'installation

Solution pour « codex: command not found » — Windows :

1. 1Appuyez sur la touche Windows, tapez variables d'environnement et cliquez sur Modifier les variables d'environnement système.
2. 2Cliquez sur le bouton Variables d'environnement....
3. 3Dans la liste inférieure (Variables système), trouvez Path, sélectionnez-la et cliquez sur Modifier....
4. 4Cliquez sur Nouveau, ajoutez le dossier où Codex a été installé (par défaut : C:\Users\<votre nom d'utilisateur>\.local\bin), puis cliquez sur OK dans chaque fenêtre.
5. 5Fermez complètement PowerShell puis rouvrez-le, et exécutez codex --version.

Solution pour « codex: command not found » — macOS/Linux :

1. 1Ouvrez Terminal et exécutez cette commande :

echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc

1. 1Rechargez la configuration :

source ~/.zshrc

1. 1Si vous utilisez Bash au lieu de Zsh, remplacez ~/.zshrc par ~/.bashrc dans les deux commandes ci-dessus.
2. 2Exécutez codex --version pour confirmer.

Votre première tâche

Étape 1 : Ouvrez un projet

Accédez au dossier du projet sur lequel vous voulez que Codex travaille (remplacez le chemin par le vôtre) :

cd path/to/your/project

Étape 2 : Lancez Codex

codex

Étape 3 : Posez votre première question

Saisissez cette demande et appuyez sur Entrée :

Tell me about this project

Codex lira les fichiers du projet et expliquera ce qu'il trouve. Essayez quelques tâches supplémentaires :

• Explain the main function in this file — expliquez la fonction principale de ce fichier
• Find the bug in this code — trouvez le bug dans ce code
• Add a comment header to every file — ajoutez un en-tête de commentaire à chaque fichier

Étape 4 : Approuvez ce que Codex veut faire

Lorsque Codex veut modifier des fichiers ou exécuter des commandes, il demande d'abord votre permission. C'est normal. Tapez y et appuyez sur Entrée pour approuver, ou n pour rejeter. Examinez chaque modification : vous gardez le contrôle sur ce qui se passe sur votre machine.

Étape 5 : Quittez Codex

Lorsque vous avez terminé, tapez /exit et appuyez sur Entrée, ou appuyez deux fois sur Ctrl + C.

Commandes utiles

Questions fréquentes

Ai-je besoin d'un plan payant ?

Vous avez besoin d'un abonnement ChatGPT ou d'une clé API OpenAI. Le plan gratuit de ChatGPT n'inclut pas l'accès à Codex CLI. Consultez la page de tarification officielle pour les options actuelles.

Codex fonctionne-t-il hors d'un dépôt git ?

Codex fonctionne mieux dans un projet git. Si vous partez de zéro, créez d'abord un dépôt :

git init

Codex peut-il exécuter mon code ?

Oui, avec votre permission. Codex peut exécuter des commandes et des tests sur votre machine, et il vous montre toujours ce qu'il va exécuter avant de demander. Utilisez les paramètres de permissions pour contrôler ce qu'il peut faire sans demander.

Mon code est-il envoyé à OpenAI ?

Lorsque vous utilisez Codex avec les modèles OpenAI, vos demandes et le contenu des fichiers sont traités par OpenAI conformément aux contrôles de données de votre type de compte (abonnement ou paramètres de l'organisation API). Consultez la documentation officielle sur les contrôles de données.

Et ensuite

• Ajoutez des instructions de projet : Créez un fichier AGENTS.md dans votre dépôt pour donner à Codex des instructions durables sur votre projet.
• Automatisez avec des scripts : Utilisez codex exec dans les pipelines CI et les flux de travail répétables.
• Connectez des outils avec MCP : Utilisez codex mcp pour donner à Codex accès à des données et services externes.
• Essayez Codex cloud : Confiez les tâches de longue durée au cloud et revenez au terminal plus tard.