Installer Codex CLI : configuration, connexion et première tâche

Installez Codex CLI, vérifiez l’exécutable, connectez-vous et commencez par une petite tâche dans le répertoire de votre projet. Les programmes d’installation officiels couvrent désormais macOS, Linux et Windows ; npm et Homebrew restent des alternatives. Choisissez l’une des méthodes ci-dessous. Une installation fonctionnelle est la première étape ; l’accès au compte et la facturation de l’API sont des choix distincts.

1. Choisissez une méthode d’installation

Ces commandes proviennent du guide officiel d’installation de Codex CLI. Utilisez le programme d’installation pour l’environnement dans lequel vous exécuterez l’agent. Installer un exécutable Windows n’installe pas une copie Linux distincte dans WSL, et l’installation sur votre ordinateur portable n’installe pas l’outil sur un serveur distant auquel vous vous connecterez ultérieurement.

curl -fsSL https://chatgpt.com/codex/install.sh | sh

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

Si vous gérez déjà vos outils de développement avec un gestionnaire de paquets, utilisez son alternative au lieu d’exécuter les deux programmes d’installation :

La méthode npm nécessite une installation fonctionnelle de npm ; vérifiez d’abord npm --version. La méthode autonome est utile si vous n’avez pas besoin d’outils Node par ailleurs. Sur une machine administrée, utilisez la méthode d’installation prise en charge par votre administrateur afin que les mises à jour ultérieures restent prévisibles.

2. Vérifiez quel exécutable est utilisé

Ouvrez un nouveau terminal après l’installation si la commande est introuvable. Sur macOS ou Linux, command -v codex affiche l’exécutable sélectionné par votre shell. Dans PowerShell, utilisez Get-Command codex. Comparez ce chemin avec la méthode d’installation choisie avant de réinstaller. Deux copies installées peuvent vous amener à mettre à jour l’une tout en continuant à lancer l’autre.

codex --version
codex --help

# Open your own project directory before starting
cd /path/to/your/project
codex login
codex login status
codex --sandbox read-only "Explain this project's structure and how its tests run. Do not modify files."

Remplacez le chemin de projet d’exemple par le vôtre. La dernière commande utilise un bac à sable en lecture seule pour une première explication. C’est une première vérification utile, car vous pouvez confirmer le dépôt et l’accès au modèle corrects avant de demander à l’agent d’effectuer une modification. Pour inspecter les options disponibles, utilisez l’aide de la CLI installée ou la référence des commandes.

3. Choisissez le chemin de compte approprié

codex login lance le processus de connexion au compte. Vérifiez le compte du navigateur et l’espace de travail avant de le terminer. Pour la facturation directe de l’API OpenAI, l’alternative documentée accepte une clé Platform via l’entrée standard :

# After supplying OPENAI_API_KEY through your credential setup:
printenv OPENAI_API_KEY | codex login --with-api-key

Cette commande API est destinée à une clé OpenAI Platform. Elle ne constitue pas la configuration complète d’une passerelle tierce. Un fournisseur personnalisé nécessite sa propre configuration, son endpoint, sa source d’identifiants et son modèle pris en charge. La documentation sur l’authentification explique les différentes voies, tandis que notre guide des clés API Codex présente la configuration avancée du fournisseur.

4. Transformez la première réponse en une première tâche utile

1. Demandez où se trouvent le code source et les tests concernés, puis vérifiez la réponse dans le dépôt.
2. Choisissez une petite modification et indiquez le comportement attendu.
3. Utilisez une branche propre ou un point de contrôle, et choisissez des autorisations adaptées à cette modification.
4. Demandez à Codex d’exécuter les vérifications pertinentes, puis examinez sa différence et son explication.

Commencez par exemple par un test en échec ou une petite correction documentaire. Évitez de faire de la première tâche une réécriture complète de l’application : l’installation, les identifiants, les dépendances locales et la qualité de la tâche seraient tous plus difficiles à évaluer simultanément. Une fois cette courte boucle opérationnelle, ajoutez les instructions de votre projet et élargissez le périmètre.

Si la configuration s’arrête, corrigez la couche correspondante

« Command not found » indique un problème d’installation ou de PATH. Une erreur 401 indique un problème d’authentification. Une erreur de modèle concerne le fournisseur et le modèle sélectionnés. Un avertissement de limite concerne l’utilisation ou la facturation. Conservez les couches fonctionnelles et suivez la liste de vérification 401 ou le guide des limites d’utilisation, selon le cas ; réinstaller l’exécutable ne reconstituera pas le solde d’un compte.

Pour évaluer Kunavo avec Codex en local, créez un compte et suivez l’intégration Codex. Elle utilise une configuration de fournisseur compatible avec Responses. Vérifiez une petite tâche avant de vous appuyer sur cette nouvelle voie de facturation pour un projet plus important.

Questions fréquentes

Documentation officielle d’installation et aide locale de la CLI vérifiées le 17 septembre 2026.