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.
À 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.
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.
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.
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
Installer le CLI
macOS / Linux :
curl -fsSL https://chatgpt.com/codex/install.sh | sh. Windows : installeur PowerShell officiel. Autrementnpm install -g @openai/codexoubrew install --cask codex. La même commande met à jour. -
2
Se connecter
Dans le projet, lancer
codexoucodex 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 aveccodex login status; sortir aveccodex logout. -
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./reviewavant le commit./initpeut écrire unAGENTS.mdpour les consignes d’équipe.
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.jsonou 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:1455en SSH. - Proxy d’entreprise : un CA
- Avec un proxy TLS ou une racine privée, définir
CODEX_CA_CERTIFICATEavantcodex login. Sinon, repli surSSL_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.