Aide-mémoire Codex
Cette annexe contient un aide-mémoire des commandes, une FAQ et des informations sur les mises à jour de version.
Aide-mémoire des commandes
Commandes de base de la CLI
| Commande | Description |
|---|---|
codex | Lancer l'interface TUI interactive |
codex "任务" | Lancer et exécuter la tâche spécifiée |
codex exec "任务" | Exécuter une tâche en mode non interactif |
codex --version | Afficher les informations de version |
codex --help | Afficher les informations d'aide |
Commandes slash
| Commande | Description |
|---|---|
/model <name> | Changer de modèle |
/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 historique |
/fork | Cloner la session actuelle |
/compact | Compacter le contexte |
/status | Afficher l'état de la session |
/clear | Effacer l'écran |
/quit | Quitter Codex |
/approval <mode> | Basculer le mode d'approbation |
Arguments CLI
| Argument | Description |
|---|---|
-m <model> | Spécifier le modèle |
--sandbox <mode> | Définir le mode bac à sable |
--approval-mode <mode> | Définir le mode d'approbation |
-i <file> | Joindre une image |
-o <file> | Sortie vers un fichier (exec) |
--full-auto | Exécution entièrement automatique |
--ephemeral | Ne pas enregistrer les fichiers de session |
--reasoning-effort <level> | Effort de raisonnement |
Exécution de commandes shell
| Format | Description |
|---|---|
! <command> | Exécuter une commande Shell dans Codex |
! git status | Afficher l’état Git |
! npm test | Exécuter les tests |
Chemins des fichiers de configuration
Emplacements des fichiers de configuration
| Fichier | Chemin | Objectif |
|---|---|---|
| Configuration utilisateur | ~/.codex/config.toml | Configuration globale par défaut |
| Configuration du projet | .codex/config.toml | Configuration spécifique au projet |
| Instructions du projet | AGENTS.md | Directives de comportement du projet |
| Répertoire des journaux | ~/.codex/log/ | Journaux d’exécution |
| Répertoire de session | ~/.codex/sessions/ | Enregistrements de session |
Répertoire des compétences
| Emplacement | Chemin |
|---|---|
| Niveau projet | .agents/skills/ |
| Niveau utilisateur | ~/.agents/skills/ |
| Niveau système | /etc/codex/skills/ |
Raccourcis clavier
Raccourcis CLI
| 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 message précédent |
Ctrl+O | Copier la dernière réponse |
Raccourcis de l'application
| Raccourci | Fonction |
|---|---|
Cmd/Ctrl+N | Nouvelle session |
Cmd/Ctrl+Shift+N | Nouvelle fenêtre |
Cmd/Ctrl+W | Fermer la fenêtre/l'onglet |
Cmd/Ctrl+[ | Onglet précédent |
Cmd/Ctrl+] | Onglet suivant |
Questions fréquentes
Installation et authentification
Q : Comment installer Codex CLI ?
Utilisez npm ou Homebrew :
npm install -g @openai/codex # 或 brew install codex
Q : Comment s’authentifier lors de la première utilisation ?
L’exécution de la commande codex ouvre automatiquement un navigateur pour l’authentification. Connectez-vous avec un compte ChatGPT ou une clé API.
Q : Prise en charge de Windows ?
La prise en charge native de Windows est expérimentale ; WSL2 est recommandé pour une meilleure expérience.
Problèmes d’utilisation
Q : Comment afficher la configuration actuelle ?
Utiliser/statuscommande pour afficher la configuration et l’état de la session actuelle.
Q : Comment désactiver l’écran alternatif ?
Utilisercodex --no-alt-screenou configureralternate_screen = "never"。
Q : Que se passe-t-il si la commande est introuvable ?
Assurez-vous que PATH inclut le répertoire d’installation globale npm, ou utilisez Homebrew pour l’installation.
Q : Comment consulter les logs ?
Les logs se trouvent dans le~/.codex/log/répertoire.
Problèmes de fonctionnalités
Q : Quelle est la différence entre exec et le mode interactif ?
exec se termine après une seule exécution, ce qui convient aux scripts d'automatisation ; le mode interactif prend en charge une conversation continue, ce qui convient au développement quotidien.
Q : Comment reprendre une session historique ?
Utiliser/resumecommande oucodex resume --last。
Q : GitHub Actions peut-il modifier des fichiers ?
Oui, définissez sandbox: workspace-write.
Q : Comment s’authentifier dans CI/CD ?
Utiliser la variable d’environnement CODEX_API_KEY, stockée dans les Secrets.
Problèmes de sécurité
Q : Comment empêcher Codex de supprimer des fichiers importants ?
Utilisez le mode sandbox read-only ou workspace-write, et configurez Rules pour interdire les commandes dangereuses.
Q : Le mode full-auto est-il sûr ?
full-auto exécute automatiquement toutes les opérations, y compris la suppression de fichiers ; à utiliser avec prudence.
Q : Comment gérer les données sensibles ?
Utilisez le stockage Secrets, disponible uniquement dans les scripts de configuration.
Mises à jour de version
Mises à jour récentes
| Version | Date | Contenu de la mise à jour |
|---|---|---|
| v1.5.0 | 2026-04 | Ajout de la prise en charge des modèles de la série GPT-5.4 |
| v1.4.0 | 2026-03 | Amélioration de la fonctionnalité Worktree |
| v1.3.0 | 2026-02 | Ajout du mode Review |
| v1.2.0 | 2026-01 | Optimisation de la prise en charge de MCP Server |
| v1.1.0 | 2025-12 | Ajout de l'intégration GitHub |
| v1.0.0 | 2025-11 | Sortie officielle de Codex |
Mise à jour de la CLI
Commandes de mise à jour
npm install -g @openai/codex@latest
# Mise à jour de Homebrew
brew upgrade codex
# Afficher la version actuelle
codex --version
Ressources associées
Ressources officielles
| Ressource | Adresse |
|---|---|
| Documentation officielle | https://developers.openai.com/codex |
| GitHub | https://github.com/openai/codex |
| Codex Web | https://chatgpt.com/codex |
| Discord | https://discord.gg/openai |
Série de tutoriels
| Chapitre | Title | Contenu |
|---|---|---|
| 01 | Premiers pas avec Codex | Capacités principales, comparaison des plans |
| 02 | Concepts fondamentaux | Prompt、Thread、Contexte、Sandbox |
| 03 | Application de bureau | Fonctionnalités de l'application, mode Révision |
| 04 | Extension IDE | VS Code、Cursor、Windsurf |
| 05 | Outil en ligne de commande | Installation de la CLI, TUI, Approbation |
| 06 | Version cloud | Interface web, Environnements |
| 07 | Intégration & connectivité | GitHub, Slack, Linear, MCP |
| 08 | Configuration & personnalisation | Config, règles, compétences |
| 09 | Automatisation & CI/CD | exec, SDK, GitHub Action |
| 10 | Modes de workflow | Workflow de développement, refactoring, corrections de bugs |
| 11 | Bonnes pratiques des prompts | Structure des prompts, décomposition des tâches |
| 12 | Sécurité & gestion d'entreprise | Sandbox, permissions, journaux d'audit |
| 13 | Sélection du modèle | Série GPT-5.4, force de raisonnement |
| 14 | Annexe | Référence rapide des commandes, FAQ |
Glossaire
| Terme | Description |
|---|---|
| Agent | Unité d'exécution centrale de Codex, capable de comprendre les tâches et d'exécuter des opérations |
| Prompt | Instructions de tâche envoyées par l'utilisateur à Codex |
| Fil | Séquence de session, contenant l'historique complet de la conversation |
| Contexte | Périmètre des informations accessibles à Codex, y compris les fichiers, les conversations et la configuration |
| Bac à sable | Environnement d'exécution isolé, limitant le périmètre des opérations de Codex |
| Approbation | Politiques d'approbation, contrôlant le comportement de confirmation avant l'exécution des opérations |
| AGENTS.md | Fichiers d'instructions de projet, définissant les lignes directrices de comportement de Codex |
| Compétence | Modules de capacités personnalisées réutilisables |
| Sous-agent | Sous-agents, utilisés pour le traitement parallèle de tâches complexes |
| Règles | Moteur de règles, définissant les autorisations d'exécution des commandes |
| MCP | Model Context Protocol, un protocole pour connecter des outils externes |
| Worktree | Git worktree, utilisé pour isoler les répertoires de travail pour différentes tâches |
Retours et assistance
Obtenir de l'aide
- Utilisation
/helpUtilisez des commandes pour afficher l'aide intégrée - Consultez la documentation officielle pour des instructions détaillées
- Rejoignez la communauté Discord pour communiquer et discuter
Signaler des problèmes
- GitHub Issues:Soumettez des bugs ou des demandes de fonctionnalités
- Soumettez des suggestions via la fonctionnalité de feedback de Codex
Autres extensionsCodex est continuellement mis à jour et itéré ; suivez les canaux officiels pour obtenir les dernières informations.