Installer et utiliser OpenAI Codex CLI : connexion et 1re tâche

Installer Codex CLI, se connecter avec ChatGPT ou une clé API, puis terminer une première tâche dans un vrai dépôt.

Il vous faut un agent de code qui lit le dépôt local, modifie des fichiers et lance les outils de la machine — sans quitter le terminal.

Ce parcours couvre comment installer et utiliser OpenAI Codex CLI : installeur officiel, connexion ChatGPT ou clé API, et une première tâche dans un vrai dépôt. Étapes d’après developers.openai.com/codex/cli et developers.openai.com/codex/auth.

Installer Se connecter Première tâche dépôt

À qui ça s’adresse

Codex CLI travaille sur un dépôt local : inspecter, éditer, lancer les outils déjà là. En interactif, codex ; pour les pipelines, codex exec. Ce n’est pas l’onglet web ChatGPT, et l’extension IDE n’est pas obligatoire.

01

Démarrer dans un vrai dépôt

Faire cd dans le projet avant de lancer. L’entrée officielle : demander “Tell me about this project”, puis un changement ciblé et relisible.

02

Deux connexions, deux factures

ChatGPT utilise les crédits Plus / Pro / Business / Edu / Enterprise. Une clé API facture aux tarifs Platform — mieux pour un CI privé, avec certaines fonctions cloud d’espace limitées.

03

Régler les permissions d’abord

/permissions montre le bac à sable et les racines inscriptibles. La doc officielle recommande aussi des points Git avant et après la tâche pour pouvoir revert.

Installer, se connecter, première tâche

  1. 1

    Installer le CLI

    macOS / Linux : curl -fsSL https://chatgpt.com/codex/install.sh | sh. Windows : installeur PowerShell officiel. Autrement npm install -g @openai/codex ou brew install --cask codex. La même commande met à jour.

  2. 2

    Se connecter

    Dans le projet, lancer codex ou codex login, choisir Sign in with ChatGPT, terminer le navigateur. Sans écran ou callback localhost bloqué : codex login --device-auth (activer les codes appareil dans les réglages de sécurité ChatGPT). Automatisation : printenv OPENAI_API_KEY | codex login --with-api-key. Vérifier avec codex login status ; sortir avec codex logout.

  3. 3

    Lancer une première tâche

    Entrer dans le dépôt et lancer codex. Faire expliquer la structure, puis demander un changement ciblé — un test, un correctif typé, une erreur claire. /review avant le commit. /init peut écrire un AGENTS.md pour les consignes d’équipe.

0
IDE supplémentaire
2
Méthodes de connexion
1
Premier prompt
curl -fsSL https://chatgpt.com/codex/install.sh | sh
# Windows: irm https://chatgpt.com/codex/install.ps1 | iex
# npm install -g @openai/codex
# brew install --cask codex

codex login
# printenv OPENAI_API_KEY | codex login --with-api-key
# codex login --device-auth

cd ~/code/your-repo
codex
# Tell me about this project

Ce qui bloque souvent le premier run

Méthode Facturation Mieux pour
Connexion ChatGPT Crédits du forfait Travail local quotidien
Clé API Tarifs Platform CI privé / scripts
Code appareil Comme ChatGPT Sans écran ou SSH
Traiter auth.json comme un mot de passe
La connexion est mise en cache dans ~/.codex/auth.json ou le trousseau OS. Ne pas la committer ni la coller dans un ticket. Le CLI et l’extension IDE partagent ce cache ; se déconnecter d’un côté impose de se reconnecter de l’autre.
Sans écran, autre chemin
Si l’hôte distant bloque le callback localhost, préférer le code appareil. Variantes : copier le cache depuis une machine avec navigateur, ou transférer localhost:1455 en SSH.
Proxy d’entreprise : un CA
Avec un proxy TLS ou une racine privée, définir CODEX_CA_CERTIFICATE avant codex login. Sinon, repli sur SSL_CERT_FILE.

Avertissement officiel pour l’API et le CI : ne pas exposer l’exécution de Codex dans des environnements publics ou non fiables.

Quand le diff doit se discuter

Après les édits, il manque souvent une image : ce qui a changé et pourquoi ça peut fusionner. Pas de suite de réunion en plus. Ouvrir un espace court sur tidemeet ou voir comment créer un espace. Canevas : bases du tableau. Note d’incident d’éval OpenAI sur ce site : rapport METR.

Questions

Faut-il installer l’extension IDE ?

Non. Le CLI suffit. L’extension partage le cache de connexion, mais la première tâche dépôt n’a besoin que du terminal.

Peut-on mélanger ChatGPT et une clé API ?

Une méthode active par session. ChatGPT utilise les droits d’espace et les crédits du forfait ; la clé API, les réglages d’organisation Platform et la facturation à l’usage. Codex cloud exige une connexion ChatGPT.

La première tâche doit-elle être un gros refactor ?

Non. L’entrée officielle : comprendre le dépôt, puis un changement ciblé. Vérifier /permissions et garder un point Git pour revert.

Quel rapport avec un outil de réunion temporaire ?

Aucun lien produit. S’il s’agit seulement de parler d’un diff, outils de réunion temporaires dit quand un court espace navigateur suffit.

Créer un espace gratuit