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

CommandeDescription
codexLancer 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 --versionAfficher les informations de version
codex --helpAfficher les informations d'aide

Commandes slash

CommandeDescription
/model <name>Changer de modèle
/fastActiver/désactiver le mode rapide
/planPasser en mode plan
/reviewExaminer les modifications de code
/newDémarrer une nouvelle session
/resumeReprendre une session historique
/forkCloner la session actuelle
/compactCompacter le contexte
/statusAfficher l'état de la session
/clearEffacer l'écran
/quitQuitter Codex
/approval <mode>Basculer le mode d'approbation

Arguments CLI

ArgumentDescription
-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-autoExécution entièrement automatique
--ephemeralNe pas enregistrer les fichiers de session
--reasoning-effort <level>Effort de raisonnement

Exécution de commandes shell

FormatDescription
! <command>Exécuter une commande Shell dans Codex
! git statusAfficher l’état Git
! npm testExécuter les tests

Chemins des fichiers de configuration

Emplacements des fichiers de configuration

FichierCheminObjectif
Configuration utilisateur~/.codex/config.tomlConfiguration globale par défaut
Configuration du projet.codex/config.tomlConfiguration spécifique au projet
Instructions du projetAGENTS.mdDirectives 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

EmplacementChemin
Niveau projet.agents/skills/
Niveau utilisateur~/.agents/skills/
Niveau système/etc/codex/skills/

Raccourcis clavier

Raccourcis CLI

RaccourciFonction
EnterEnvoyer le message
Shift+EnterNouvelle ligne
Ctrl+CInterrompre l'opération
Ctrl+C (两次)Quitter Codex
Ctrl+DQuitter (lorsque la saisie est vide)
Ctrl+RRechercher dans l'historique
Up/DownParcourir l'historique
TabAuto-complétion
Esc EscModifier le message précédent
Ctrl+OCopier la dernière réponse

Raccourcis de l'application

RaccourciFonction
Cmd/Ctrl+NNouvelle session
Cmd/Ctrl+Shift+NNouvelle fenêtre
Cmd/Ctrl+WFermer 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

VersionDateContenu de la mise à jour
v1.5.02026-04Ajout de la prise en charge des modèles de la série GPT-5.4
v1.4.02026-03Amélioration de la fonctionnalité Worktree
v1.3.02026-02Ajout du mode Review
v1.2.02026-01Optimisation de la prise en charge de MCP Server
v1.1.02025-12Ajout de l'intégration GitHub
v1.0.02025-11Sortie officielle de Codex

Mise à jour de la CLI

Commandes de mise à jour

# npm update
npm install -g @openai/codex@latest

# Mise à jour de Homebrew
brew upgrade codex

# Afficher la version actuelle
codex --version

Ressources associées

Ressources officielles

RessourceAdresse
Documentation officiellehttps://developers.openai.com/codex
GitHubhttps://github.com/openai/codex
Codex Webhttps://chatgpt.com/codex
Discordhttps://discord.gg/openai

Série de tutoriels

ChapitreTitleContenu
01Premiers pas avec CodexCapacités principales, comparaison des plans
02Concepts fondamentauxPrompt、Thread、Contexte、Sandbox
03Application de bureauFonctionnalités de l'application, mode Révision
04Extension IDEVS Code、Cursor、Windsurf
05Outil en ligne de commandeInstallation de la CLI, TUI, Approbation
06Version cloudInterface web, Environnements
07Intégration & connectivitéGitHub, Slack, Linear, MCP
08Configuration & personnalisationConfig, règles, compétences
09Automatisation & CI/CDexec, SDK, GitHub Action
10Modes de workflowWorkflow de développement, refactoring, corrections de bugs
11Bonnes pratiques des promptsStructure des prompts, décomposition des tâches
12Sécurité & gestion d'entrepriseSandbox, permissions, journaux d'audit
13Sélection du modèleSérie GPT-5.4, force de raisonnement
14AnnexeRéférence rapide des commandes, FAQ

Glossaire

TermeDescription
AgentUnité d'exécution centrale de Codex, capable de comprendre les tâches et d'exécuter des opérations
PromptInstructions de tâche envoyées par l'utilisateur à Codex
FilSéquence de session, contenant l'historique complet de la conversation
ContextePérimètre des informations accessibles à Codex, y compris les fichiers, les conversations et la configuration
Bac à sableEnvironnement d'exécution isolé, limitant le périmètre des opérations de Codex
ApprobationPolitiques d'approbation, contrôlant le comportement de confirmation avant l'exécution des opérations
AGENTS.mdFichiers d'instructions de projet, définissant les lignes directrices de comportement de Codex
CompétenceModules de capacités personnalisées réutilisables
Sous-agentSous-agents, utilisés pour le traitement parallèle de tâches complexes
RèglesMoteur de règles, définissant les autorisations d'exécution des commandes
MCPModel Context Protocol, un protocole pour connecter des outils externes
WorktreeGit 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

Codex est continuellement mis à jour et itéré ; suivez les canaux officiels pour obtenir les dernières informations.

Autres extensions