Outil en ligne de commande Codex
Codex CLI est un outil officiel en ligne de commande écrit en Rust. Il est léger et efficace, adapté aux passionnés du terminal.
Installer CLI
Codex CLI prend en charge macOS, Linux et Windows (expérimental).
Installation avec npm
Installation globale avec npm
npm install -g @openai/codex
# Vérifier l'installation
codex --version
Installation avec Homebrew
Installation avec Homebrew
brew install codex
Mettre à jour la CLI
Mettre à jour la version
npm install -g @openai/codex@latest
# Mettre à jour via Homebrew
brew upgrade codex
Première utilisation
La première fois que vous exécutez Codex, il vous guidera tout au long de l'authentification.
Lancer Codex
codex
# Ou spécifier une tâche initiale
codex "Expliquez la structure de ce projet"
Codex ouvrira un navigateur pour l'authentification.
- Connectez-vous avec un compte ChatGPT
- Ou utiliser une clé API OpenAI
- Après autorisation, revenez au terminal pour continuer.
TUI interactive
Par défaut, la CLI entre en mode interface utilisateur de terminal (TUI), offrant une expérience immersive.
Zones de l'interface TUI
| Zone | Fonction |
|---|---|
| Zone de messages | Affiche l'historique de conversation, les appels d'outils et les résultats d'exécution |
| Zone de saisie | Boîte de saisie en bas, envoyer le Prompt |
| Barre d'état | Affiche le modèle, l'utilisation du contexte et les informations de thread |
Paramètres du mode TUI
Configuration de l'interface TUI
[tui]
# Mode écran alternatif
alternate_screen = "auto" # auto | always | never
# Conserver l'historique de défilement lorsque l'écran alternatif est désactivé
# alternate_screen = "never"
Le mode écran alternatif fait en sorte que Codex utilise un écran séparé et restaure l'état d'origine du terminal à la sortie.
Mode d'approbation
Le mode d'approbation contrôle le comportement de confirmation avant que Codex n'effectue des actions.
Quatre modes
| Mode | Description | Comportement |
|---|---|---|
| suggest | Mode Suggest | Codex fournit des suggestions mais n'exécute pas |
| auto-edit | Auto-édition | Effectue automatiquement les modifications de fichiers, les commandes nécessitent une confirmation |
| full-auto | Entièrement automatique | Exécute automatiquement toutes les opérations (à utiliser avec prudence) |
| interactive | Mode interactif | Demander avant les opérations sensibles (par défaut) |
Définir le mode d'approbation
codex --approval-mode full-auto
# Ou basculer en session
/approbation full-auto
En mode full-auto, Codex exécute automatiquement toutes les opérations, y compris la suppression de fichiers. À utiliser avec prudence.
Mode sandbox
Le mode sandbox limite la portée d'accès aux fichiers et aux commandes de Codex.
| Mode | Modification de fichiers | Exécution de commandes | Accès réseau |
|---|---|---|---|
| read-only | Interdit | Interdit | Interdit |
| workspace-write | Espace de travail uniquement | Autorisé | Interdit |
| danger-full-access | Autorisé | Autorisé | Autorisé |
Définir le mode Sandbox
codex --sandbox read-only
# Mode d'écriture dans l'espace de travail (recommandé)
codex --sandbox workspace-write
# Mode d'accès complet (dangereux)
codex --sandbox danger-full-access
Commandes slash
L'interface CLI propose un riche ensemble de commandes slash :
| Commande | Fonction |
|---|---|
/model | Changer de modèle (par ex., /model gpt-5.4-mini) |
/fast | Activer/désactiver le mode rapide |
/plan | Passer en mode plan |
/review | Examiner les modifications de code |
/new | Démarrer une nouvelle session |
/resume | Reprendre une session précédente |
/fork | Cloner la session en cours dans un nouveau fil |
/compact | Compresser l'historique du contexte |
/status | Afficher l'état de la session |
/clear | Effacer l'écran |
/quit | Quitter Codex |
Exemples d'utilisation des commandes
Commandes slash
/model gpt-5.4-mini
# Mode plan
/plan implémenter un système d'authentification utilisateur
# Afficher l'état
/status
Exécution de commandes shell
Exécuter des commandes shell directement dans le CLI :
Exécuter la commande
! ls -la
# Exécuter une commande git
! git status
# Afficher les processus
! ps aux
Confirmation de commande
Les commandes dangereuses nécessitent une confirmation :
- Supprimer des fichiers (rm)
- Terminer des processus (kill)
- Modifier la configuration du système
Entrée d'image
L'interface CLI prend en charge l'ajout d'images comme contexte :
Joindre une image
codex -i screenshot.png
# Joindre une maquette de design
codex --image design.png "Implémentez la page en fonction de ce design"
# Plusieurs images
codex -i img1.png -i img2.png
Utilisation des images
- Analyser les messages d'erreur à partir des captures d'écran
- Convertir des maquettes de design UI en code
- Interpréter les données d'un graphique
Mode non interactif (exec)
Utilisez la commande exec pour exécuter une tâche ponctuelle, adaptée aux scripts et CI/CD :
Commande exec
codex exec "Examiner le code et produire un rapport"
# Sortie vers un fichier
codex exec "Générer README" -o README.md
# Utiliser un modèle spécifique
codex exec -m gpt-5.4-mini "Analyser la structure du projet"
# Mode entièrement automatique
codex exec --full-auto "Exécuter les tests et corriger les échecs"
Paramètres exec courants
| Paramètre | Description |
|---|---|
-m | Spécifier le modèle |
-o | Sortie vers un fichier |
--full-auto | Exécution entièrement automatique |
--ephemeral | Ne pas enregistrer les fichiers de session |
--json | Format de sortie JSON |
Raccourcis clavier
| Raccourci | Fonction |
|---|---|
Enter | Envoyer le message |
Shift+Enter | Nouvelle ligne |
Ctrl+C | Interrompre l'opération |
Ctrl+C (两次) | Quitter Codex |
Ctrl+D | Quitter (lorsque la saisie est vide) |
Ctrl+R | Rechercher dans l'historique |
Up/Down | Parcourir l'historique |
Tab | Auto-complétion |
Esc Esc | Modifier le dernier message |
Ctrl+O | Copier la dernière réponse |
FAQ
Q : Statut de la prise en charge de Windows ?
La prise en charge native de Windows est expérimentale ; WSL2 est recommandé pour une expérience optimale.
Q : Comment désactiver l'écran alternatif ?
Utilisercodex --no-alt-screenou configureralternate_screen = "never"。
Q : Commande introuvable ?
Assurez-vous que PATH inclut le répertoire d'installation global de npm, ou installez avec Homebrew.
Q : Comment afficher les journaux détaillés ?
Les journaux se trouvent dans~/.codex/log/répertoire.