Commandes pour les développeurs

Sur le Web, la zone de saisie de ChatGPT dispose de son propre menu de commandes. Saisissez / pour voir les actions disponibles dans la discussion en cours. Ce menu ne propose pas les commandes de l’application de bureau ChatGPT ni celles de la CLI. Les commandes slash, les commandes CLI et les options de Codex décrites ici ne s’appliquent pas à ChatGPT sur le Web.

Commandes de l’application de bureau ChatGPT

La page Commandes présente la navigation dans l’application, les raccourcis de discussion, la personnalisation des raccourcis clavier et les liens profonds vers les discussions, les paramètres, les skills, les tâches planifiées, les plugins et les compagnons.

La page Commandes slash décrit les commandes disponibles dans la zone de saisie de l’application, notamment /feedback, /goal, /init, /mcp, /plan, /review et /status.

Comment utiliser cette référence

Cette page répertorie toutes les commandes et options documentées de Codex CLI. Utilisez les tableaux interactifs pour effectuer une recherche par clé ou par description. Chaque section indique le niveau de maturité des options et signale les options obsolètes ainsi que les combinaisons à risque.

Options globales

Ces options s’appliquent à la commande de base codex. La plupart sont transmises aux sous-commandes. Pour connaître les exceptions, consultez les remarques ci-dessus ou l’aide de la commande concernée. Pour utiliser les options transmises, suivez les indications de cette aide. Par exemple, codex exec --oss ... applique --oss à exec.

Vue d’ensemble des commandes

Détail des commandes

codex (mode interactif)

Exécutez codex sans sous-commande pour ouvrir l’interface interactive du terminal (TUI). L’agent accepte les options globales ci-dessus ainsi que les images en pièces jointes. Par défaut, la recherche web utilise le cache. Utilisez --search pour consulter le Web en direct. Pour simplifier le travail en local, utilisez --sandbox workspace-write --ask-for-approval on-request.

Utilisez --remote ws://host:port ou --remote wss://host:port pour connecter la TUI à un serveur d’application démarré avec codex app-server --listen ws://IP:PORT. Pour une connexion locale par socket Unix, utilisez --remote unix:// pour le socket par défaut ou --remote unix://PATH pour spécifier son chemin. Ajoutez --remote-auth-token-env <ENV_VAR> si le serveur exige un jeton Bearer pour l’authentification WebSocket.

codex agents

Ouvrez le centre de commande pour parcourir les discussions et passer d’un agent à l’autre sur un serveur partagé. Utilisez --remote <URL> pour vous connecter à un serveur distant et --cd <DIR> pour définir le répertoire des nouvelles tâches distantes. codex agents ne prend pas en charge --no-daemon.

codex queue

Placez un message texte dans la file d’attente d’une session existante :

codex queue --thread <SESSION_ID> --message "Run the remaining checks"

--thread accepte un UUID ou le nom exact d’une session. Utilisez un UUID si plusieurs sessions portent le même nom. Le modèle de la session traite les messages en file d’attente. La commande accepte uniquement du texte.

Ajoutez --resume pour mettre le message en file d’attente, puis reprendre la session si elle n’est pas déjà chargée. La reprise nécessite un démon local en cours d’exécution ou un serveur sélectionné avec --remote. Utilisez --remote-auth-token-env si le serveur exige un jeton. Si Codex ne parvient pas à reprendre la session, il affiche un avertissement, mais la commande renvoie tout de même un code de sortie nul.

codex app-server

Démarrez le serveur d’application Codex en local. Il sert principalement au développement et au débogage et peut évoluer sans préavis.

codex app-server --listen stdio:// conserve le transport par défaut, qui transmet du JSONL sur les flux d’entrée et de sortie standard. codex app-server --stdio est un alias pour ce transport. --listen ws://IP:PORT active le transport WebSocket pour les clients du serveur d’application. Le serveur accepte les URL d’écoute ws://. Utilisez une terminaison TLS ou un proxy sécurisé si les clients se connectent avec wss://. Utilisez --listen unix:// pour accepter les demandes de connexion WebSocket sur le socket Unix par défaut de Codex, ou --listen unix:///absolute/path.sock pour choisir le chemin du socket. Si vous générez des schémas pour les liaisons côté client, ajoutez --experimental pour inclure les champs et méthodes dont l’accès est restreint.

Utilisez --code-mode-host https://code-mode.example.com pour connecter tous les fils du processus du serveur d’application à un hôte Code Mode distant via gRPC. L’option --listen détermine comment les clients se connectent au serveur d’application.

codex remote-control

Exécutez codex remote-control pour démarrer le contrôle à distance via le serveur géré en arrière-plan si les conditions le permettent. À défaut, Codex s’exécute au premier plan. Utilisez codex remote-control --no-daemon pour imposer l’exécution au premier plan. Utilisez codex remote-control start pour démarrer le démon local du serveur d’application avec le contrôle à distance activé, et codex remote-control stop pour l’arrêter. Les clients gérés de contrôle à distance et les workflows distants via SSH utilisent ces commandes. Si vous développez un client local du protocole, utilisez codex app-server --listen.

Une fois le démon démarré, utilisez codex remote-control pair pour créer et afficher un code d’appairage manuel à validité limitée. Ajoutez --json à une commande de contrôle à distance pour obtenir une sortie lisible par machine. Pour pair, la réponse JSON contient pairingCode, manualPairingCode, environmentId et expiresAt. --no-daemon s’applique uniquement à la commande remote-control sans sous-commande. Ne l’utilisez pas avec start, stop ou pair.

codex app

Lancez l’application de bureau ChatGPT depuis le terminal sur macOS ou Windows. Sur macOS, Codex peut ouvrir l’espace de travail au chemin indiqué. Sur Windows, Codex affiche le chemin à ouvrir.

codex app ouvre l’application de bureau ChatGPT si elle est installée, ou lance le programme d’installation si elle est absente. Sur macOS, Codex ouvre l’espace de travail au chemin indiqué. Sur Windows, il affiche le chemin à ouvrir après l’installation.

codex debug app-server send-message-v2

Envoyez un message via le workflow V2 du serveur d’application, qui utilise des fils et des tours de discussion, à l’aide du client de test intégré.

Ce workflow de débogage s’initialise avec experimentalApi: true, ouvre un fil, envoie un tour de discussion et transmet les notifications du serveur en continu. Utilisez-le pour reproduire et examiner en local le comportement du protocole du serveur d’application.

codex debug models

Affichez au format JSON le catalogue brut des modèles que voit Codex.

Utilisez --bundled pour examiner uniquement le catalogue fourni avec le binaire actuel, sans l’actualiser depuis le point de terminaison distant des modèles.

codex debug prompt-input

Affichez au format JSON la liste exacte des entrées du prompt que reçoit le modèle. Utilisez cette commande pour déboguer la détection des instructions, le contexte de session ou la construction du prompt.

codex apply

Appliquez à votre dépôt local le dernier diff d’une discussion Codex Cloud. Vous devez vous authentifier et avoir accès à la discussion.

Codex affiche la liste des fichiers modifiés et renvoie un code de sortie non nul si git apply échoue, par exemple en raison de conflits.

codex review

Lancez une revue de code en mode non interactif. Choisissez une seule cible de revue ou fournissez des instructions de revue personnalisées dans un prompt.

--uncommitted, --base, --commit et un PROMPT personnalisé sont mutuellement exclusifs. Utilisez --title uniquement avec --commit.

codex archive et codex unarchive

Archivez ou restaurez une session interactive enregistrée en indiquant son identifiant ou son nom. Utilisez ces commandes pour retirer une session du sélecteur sans supprimer son historique. Les identifiants de session ont priorité sur les noms.

Lorsque vous archivez ou restaurez une session, Codex tente également d’archiver ou de restaurer les sessions de sous-agents qu’elle a créées, ainsi que toutes leurs sessions descendantes.

codex archive <SESSION>
codex unarchive <SESSION>

codex delete

Supprimez définitivement une session interactive enregistrée en indiquant son identifiant ou son nom. Utilisez cette commande uniquement si vous souhaitez effacer l’historique. Pour simplement masquer la session dans les listes de sessions actives, archivez-la.

codex delete <SESSION>
codex delete <SESSION_UUID> --force

Utilisez --force uniquement avec un UUID de session. Si vous indiquez un nom, Codex demande toujours confirmation pour éviter de supprimer une session dont le nom est partagé ou ambigu.

codex cloud

Accédez aux discussions Codex Cloud depuis le terminal. La commande par défaut ouvre un sélecteur interactif. codex cloud exec soumet directement une tâche et codex cloud list renvoie les discussions récentes pour les consulter rapidement ou les exploiter dans un script.

L’authentification utilise les mêmes identifiants que la CLI principale. Codex renvoie un code de sortie non nul si la soumission de la tâche échoue.

codex cloud list

Affichez les discussions récentes dans le cloud, avec filtrage et pagination facultatifs.

La sortie en texte brut affiche l’URL d’une tâche suivie de détails sur son état. Utilisez --json pour les automatisations. Les données JSON contiennent un tableau tasks et, éventuellement, une valeur cursor. Chaque tâche contient id, url, title, status, updated_at, environment_id, environment_label, summary, is_review et attempt_total.

codex completion

Générez les scripts de complétion du shell et redirigez la sortie vers l’emplacement approprié, par exemple avec codex completion zsh > "${fpath[1]}/_codex".

codex doctor

Générez un rapport de diagnostic local avant de signaler un problème à l’assistance ou pour rechercher la cause d’un dysfonctionnement de Codex. Le rapport vérifie l’installation, la configuration, l’authentification, l’environnement d’exécution, Git, le terminal, le serveur d’application et l’état de l’inventaire des fils.

codex features

Gérez les options d’activation des fonctionnalités stockées dans $CODEX_HOME/config.toml. Les commandes enable et disable enregistrent les modifications pour les sessions futures. La sous-commande features n’accepte pas --profile.

codex exec

Utilisez codex exec (ou sa forme courte codex e) pour les exécutions par script ou en intégration continue qui doivent se terminer sans intervention humaine.

Par défaut, Codex met en forme sa sortie. Ajoutez --json pour recevoir les événements JSON à raison d’un événement par ligne et par changement d’état. La sous-commande facultative resume permet de reprendre les tâches non interactives. Utilisez --last pour sélectionner la session la plus récente du répertoire de travail actuel, ou ajoutez --all pour étendre la recherche à toutes les sessions :

Utilisez codex exec fork <SESSION_ID> [PROMPT] pour copier une session enregistrée dans une nouvelle session. L’argument de session accepte un UUID ou un nom. Sans prompt, Codex crée le fork sans lancer de tour de discussion. Passez - comme prompt pour le lire depuis l’entrée standard, ou ajoutez --image pour joindre des images.

Un prompt est obligatoire si vous joignez des images ou utilisez --output-schema, --output-last-message ou --ephemeral.

Ajoutez --worktree à une nouvelle exécution ou à un fork pour créer un arbre de travail Git géré :

codex exec --worktree "implement the next step"
codex exec fork <SESSION_ID> --worktree "try an alternative approach"

--worktree nécessite une exécution locale. Ne l’utilisez pas avec resume, review, --ephemeral ou --ignore-user-config.

codex execpolicy

Vérifiez les fichiers de règles execpolicy avant de les enregistrer. codex execpolicy check accepte une ou plusieurs options --rules (par exemple pour des fichiers dans ~/.codex/rules) et affiche au format JSON la décision la plus stricte ainsi que les règles correspondantes. Ajoutez --pretty pour mettre en forme la sortie. La commande execpolicy est actuellement disponible en préversion.

codex login

Authentifiez la CLI avec un compte ChatGPT, une clé API ou un jeton d’accès. Sans option, Codex ouvre un navigateur pour vous authentifier auprès de ChatGPT via OAuth.

codex login status renvoie le code de sortie 0 si des identifiants sont présents, ce qui permet de vérifier leur présence dans un script d’automatisation.

codex logout

Supprimez les identifiants enregistrés pour l’authentification par clé API et via ChatGPT. Cette commande ne prend aucune option.

codex mcp

Gérez les entrées des serveurs Model Context Protocol stockées dans ~/.codex/config.toml.

La sous-commande add prend en charge les transports stdio et HTTP en streaming :

Les actions OAuth (login, logout) fonctionnent uniquement avec les serveurs HTTP en streaming qui prennent en charge OAuth.

codex plugin

Installez, listez et supprimez des plugins depuis les marketplaces configurées.

codex plugin add --json affiche pluginId, name, marketplaceName, version, installedPath et authPolicy. codex plugin list --json affiche les tableaux installed et available. Les entrées contiennent pluginId, name, marketplaceName, version, installed, enabled, source, installPolicy, authPolicy et, le cas échéant, marketplaceSource, qui indique le type et la valeur de la source configurée pour la marketplace. codex plugin remove --json affiche pluginId, name et marketplaceName.

codex plugin marketplace

Gérez les sources des marketplaces que Codex peut parcourir pour y trouver des plugins à installer.

codex plugin marketplace add accepte les notations abrégées GitHub telles que owner/repo ou owner/repo@ref, les URL Git HTTP, HTTPS ou SSH et les répertoires racines des marketplaces locales. Utilisez --ref pour fixer une référence Git et répétez --sparse PATH pour extraire uniquement les chemins voulus dans les dépôts Git des marketplaces.

codex plugin marketplace list affiche les noms et les répertoires racines des marketplaces prises en compte, y compris les marketplaces par défaut détectées automatiquement et les instantanés de marketplaces configurés.

Ajoutez --json aux commandes d’ajout, de listage, de mise à niveau ou de suppression de marketplaces pour obtenir une sortie exploitable par script. Pour l’ajout, la sortie JSON contient marketplaceName, installedRoot et alreadyAdded. Pour le listage, elle contient un tableau marketplaces avec name, root et, éventuellement, marketplaceSource. Pour la mise à niveau, elle contient selectedMarketplaces, upgradedRoots et errors. Pour la suppression, elle contient marketplaceName et installedRoot.

codex mcp-server

codex resume

Reprenez une session interactive par son identifiant ou poursuivez la discussion la plus récente. codex resume limite la recherche avec --last au répertoire de travail actuel, sauf si vous passez --all. La commande permet de remplacer le modèle et les paramètres du bac à sable, mais n’accepte pas --worktree.

Si le répertoire de travail actuel diffère de celui enregistré pour la session, Codex vous demande lequel utiliser. Réglez tui.resume_cwd sur "current" ou "session" pour réutiliser ce choix sans confirmation. Si vous indiquez explicitement un répertoire avec --cd (-C), il a priorité sur tui.resume_cwd.

codex fork

Forkez une session interactive précédente pour créer une nouvelle discussion. Par défaut, codex fork ouvre le sélecteur de sessions. Utilisez --last pour forker la session la plus récente du répertoire actuel. Utilisez --last --all pour forker la session la plus récente, tous répertoires confondus.

Si le répertoire actuel diffère de celui enregistré pour la session, codex fork vous pose la même question sur le répertoire de travail et utilise le même paramètre tui.resume_cwd que codex resume.

Pour forker la session dans un arbre de travail Git géré, exécutez codex fork <SESSION_ID> --worktree. Cette opération nécessite un identifiant de session explicite et une exécution locale. Elle ne prend en charge ni --last ni le sélecteur de sessions.

codex sandbox

Utilisez l’utilitaire de bac à sable pour exécuter une commande avec les mêmes politiques que celles qu’applique Codex en interne.

Seatbelt sur macOS

Bac à sable Linux

Windows

Avant de supprimer l’ancien bac à sable Windows, arrêtez les applications qui l’utilisent. Si le service de provisionnement du bac à sable est installé, arrêtez-le également. Exécutez ensuite codex sandbox uninstall en tant qu’administrateur. La commande supprime les comptes et les règles réseau du bac à sable définis à l’échelle de la machine. Elle conserve votre répertoire personnel Codex, y compris les répertoires du bac à sable et les autorisations du système de fichiers.

codex update

Recherchez et appliquez une mise à jour de Codex CLI si la version installée prend en charge sa propre mise à jour. Les versions de débogage affichent un message vous invitant à installer une version de distribution.

Combinaisons d’options et conseils de sécurité

• Utilisez --sandbox workspace-write pour les tâches locales sans supervision qui peuvent se limiter à l’espace de travail. Évitez --dangerously-bypass-approvals-and-sandbox, sauf si vous travaillez dans une machine virtuelle dédiée au bac à sable.
• Pour autoriser Codex à écrire dans d’autres répertoires, privilégiez --add-dir plutôt que d’imposer --sandbox danger-full-access.
• En intégration continue, combinez --json et --output-last-message pour obtenir à la fois des données de progression lisibles par machine et un résumé final en langage naturel.

Raccourcis interactifs

• Saisissez @ pour rechercher un fichier dans l’espace de travail et ajouter son chemin au prompt.
• Appuyez sur Flèche haut ou Flèche bas pour retrouver un brouillon dans l’historique.
• Appuyez sur Ctrl+R pour rechercher un prompt dans l’historique, puis sur Entrée pour utiliser le résultat ou sur Échap pour annuler.
• Appuyez sur Ctrl+ O  pour copier la dernière réponse terminée. Exécutez /copy pour choisir le contenu à copier.
• Commencez une ligne par ! pour exécuter une commande shell locale avec les paramètres d’approbation et de bac à sable actuels.
• Pendant que Codex travaille, appuyez sur Tab pour mettre en file d’attente un prompt de suivi, une commande slash ou une commande shell pour le prochain tour.
• Pendant que Codex travaille, appuyez sur Entrée pour lui transmettre de nouvelles instructions pour le tour en cours.
• Lorsque la zone de saisie est vide, appuyez deux fois sur Échap pour modifier le message utilisateur précédent et forker la discussion à partir de ce point.
• Appuyez sur Ctrl+C ou exécutez /exit pour fermer la session.

Ressources associées

• Présentation de Codex CLI : installation, mises à niveau et conseils pratiques.
• Bases de la configuration : enregistrement des valeurs par défaut, comme le modèle et le fournisseur.
• Configuration avancée : profils, fournisseurs, réglages du bac à sable et intégrations.
• AGENTS.md : présentation des capacités des agents Codex et des bonnes pratiques.

Les commandes slash permettent de piloter rapidement Codex au clavier. Saisissez / dans la zone de saisie pour ouvrir le menu des commandes slash, puis choisissez une commande. Codex peut ainsi changer de modèle, ajuster les autorisations ou résumer de longues discussions sans que vous quittiez le terminal.

Ce guide vous explique comment :

• Trouver la commande slash intégrée adaptée à une tâche
• Piloter une session active avec des commandes comme /model, /fast, /permissions, /approve, /raw, /agents, /subagents et /status

Commandes slash intégrées

Codex fournit les commandes ci-dessous. Ouvrez le menu des commandes slash et commencez à saisir le nom de la commande pour filtrer la liste.

Si une discussion est déjà en cours, saisissez une commande slash et appuyez sur Tab pour la mettre en file d’attente pour le tour suivant. Codex interprète les commandes en attente au moment de leur exécution. Les menus et les erreurs s’affichent donc après la fin du tour en cours. La complétion fonctionne jusqu’à la mise en file d’attente de la commande.

/quit et /exit ferment toutes deux la CLI. Utilisez-les uniquement après avoir enregistré votre travail important ou créé un commit.

Utilisez /permissions pour ajuster les actions que Codex peut effectuer sans demander d’approbation. Utilisez /approve uniquement pour relancer une action récente refusée par la révision automatique.

Piloter une session avec les commandes slash

Les workflows suivants permettent de piloter votre session sans redémarrer Codex.

Modifier les préférences du terminal avec /config

Saisissez /config pour ouvrir les préférences du terminal. Parcourez les paramètres par groupe ou appuyez sur  /  pour lancer une recherche. Codex enregistre automatiquement vos modifications.

Choisir le mode du terminal avec /tui

1. Saisissez /tui.
2. Choisissez le mode avec historique de défilement ou le mode plein écran, puis confirmez.
3. Redémarrez Codex pour appliquer votre choix.

Résultat attendu : au prochain lancement, Codex utilise le mode enregistré. Les options de lancement telles que --no-alt-screen restent prioritaires.

Exporter une conversation avec /export

1. Saisissez /export.
2. Choisissez Copier dans le presse-papiers ou Enregistrer dans un fichier.

Résultat attendu : Codex exporte la conversation complète au format Markdown. Pour l’enregistrer directement dans un fichier, exécutez /export session.md. Attendez la fin du tour en cours avant de lancer l’exportation.

Résumer la discussion avec /recap

1. Lorsque Codex est inactif, saisissez /recap.

Résultat attendu : Codex génère un résumé de la conversation, même si tui.auto_recap = false. Utilisez /compact pour libérer de l’espace dans le contexte.

Changer de répertoire avec /cd

1. Saisissez /pwd (ou /cwd) pour vérifier le répertoire actuel.
2. Saisissez /cd <path> pour changer de répertoire, ou /cd pour utiliser votre répertoire personnel.

Résultat attendu : Codex poursuit la discussion dans le répertoire sélectionné. Le changement de répertoire nécessite une session principale inactive, sans entrée en file d’attente ni terminal en arrière-plan.

Poursuivre dans un arbre de travail avec /worktree

1. Saisissez /worktree dans un dépôt Git local.
2. Choisissez de démarrer une nouvelle discussion ou de poursuivre la conversation actuelle dans un nouvel arbre de travail.

Résultat attendu : Codex crée un arbre de travail Git géré et y démarre la discussion sélectionnée. Choisissez Parcourir les arbres de travail pour retrouver les arbres de travail existants et les discussions auxquelles ils appartiennent. Cette commande nécessite la prise en charge locale des arbres de travail et reste indisponible pendant l’exécution d’une tâche.

Gérer le serveur en arrière-plan avec /daemon

1. Saisissez /daemon.
2. Examinez la connexion au serveur et les actions disponibles.

Résultat attendu : pour le serveur local en arrière-plan, Codex propose d’installer la dernière version stable publique ou d’utiliser la version actuelle de la CLI. Confirmer une mise à jour ferme Codex et peut interrompre le travail en cours. Pour redémarrer un serveur local géré, choisissez Redémarrer le serveur en arrière-plan, puis confirmez. Codex se reconnecte automatiquement. Le redémarrage peut interrompre les tâches en cours ou en file d’attente dans d’autres discussions. Si la connexion est distante, gérez le serveur sur son hôte.

Examiner les avertissements avec /warnings

1. Saisissez /warnings.

Résultat attendu : Codex affiche les avertissements conservés et les détails de diagnostic associés.

Définir le modèle actif avec /model

Le sélecteur affiche uniquement les modèles disponibles pour votre compte et votre espace de travail. Si GPT-6.1 Sol ne figure pas dans la liste, choisissez un autre modèle. Consultez la page Disponibilité de GPT-6.1 Sol selon le forfait.

1. Démarrez Codex et ouvrez la zone de saisie.
2. Saisissez /model et appuyez sur Entrée.
3. Dans le menu qui s’ouvre, choisissez un modèle, par exemple gpt-6-luna ou gpt-6.1-sol.

Résultat attendu : Codex confirme le nouveau modèle dans l’historique. Exécutez /status pour vérifier le changement.

Pour modifier directement les paramètres de la session actuelle, utilisez /model [model] [--reasoning=<level>] [--speed=<tier>]. Par exemple, /model --reasoning=high conserve le modèle actuel et règle son effort de raisonnement sur Élevé si le modèle prend en charge ce niveau.

Réutiliser des prompts et des commandes avec /presets

Saisissez /presets et appuyez sur  n  pour enregistrer un prompt ou une commande slash dans un emplacement numéroté. Appuyez sur  s  pour créer un préréglage à partir du modèle, des autorisations, du titre du terminal ou de la ligne d’état de la session actuelle. Pour exécuter un préréglage enregistré, ouvrez /presets et appuyez sur la touche correspondant à son numéro.

Activer ou désactiver le mode Rapide avec /fast

1. Saisissez /fast pour activer l’offre Rapide du modèle actuel.
2. Saisissez de nouveau /fast pour la désactiver.

Résultat attendu : Codex active ou désactive l’offre et enregistre votre choix. Avec /statusline, vous pouvez également afficher l’état du mode Rapide dans le pied de page de la TUI.

Les commandes de l’offre Rapide dépendent du catalogue. Si le modèle actuel ne propose pas cette offre, Codex n’affiche pas /fast.

Activer ou désactiver Daybreak

Si vous utilisez le fournisseur OpenAI et que votre compte et votre modèle ont accès à Daybreak, utilisez /daybreak pour activer ou désactiver Daybreak. Codex applique votre choix à la discussion actuelle et l’enregistre comme valeur par défaut pour les discussions futures.

Parler à Codex avec /voice

Si votre version de la CLI et votre session prennent en charge les conversations vocales, utilisez /voice ou F8 pour démarrer ou arrêter une conversation vocale. Utilisez /voice mute pour activer ou désactiver votre microphone et /voice stop pour mettre fin à la conversation. Utilisez /voice settings pour choisir une voix pour les prochaines conversations.

Passer en mode plan avec /plan

1. Saisissez /plan et appuyez sur Entrée pour passer la discussion active en mode plan.
2. Si vous le souhaitez, ajoutez le texte du prompt sur la même ligne. Par exemple, pour demander un plan de migration pour ce service, saisissez /plan Propose a migration plan for this service.
3. Vous pouvez coller du contenu ou joindre des images lorsque vous passez des arguments directement à /plan.

Résultat attendu : Codex passe en mode plan. Si vous avez fourni un prompt sur la même ligne, il l’utilise comme première demande de planification.

La commande /plan est temporairement indisponible pendant que Codex travaille.

Définir ou consulter l’objectif d’une tâche avec /goal

1. Saisissez /goal <objective> pour définir l’objectif. Par exemple, pour demander à Codex de terminer la migration en veillant à ce que les tests continuent de réussir, saisissez /goal Finish the migration and keep tests green.
2. Saisissez /goal pour consulter l’objectif actuel.
3. Utilisez /goal edit pour modifier l’objectif. Utilisez /goal pause, /goal resume ou /goal clear pour le suspendre, le reprendre ou le supprimer.

Résultat attendu : Codex conserve l’objectif dans la discussion active pendant toute la durée du travail.

Un objectif doit contenir entre 1 et 4 000 caractères. Pour des instructions plus longues, consignez les détails dans un fichier et indiquez ce fichier dans l’objectif.

Activer ou désactiver les fonctionnalités expérimentales avec /experimental

1. Saisissez /experimental et appuyez sur Entrée.
2. Activez ou désactivez les fonctionnalités souhaitées, comme le proxy réseau ou le blocage de la mise en veille pendant l’exécution, puis redémarrez Codex si un message vous y invite.

Résultat attendu : Codex enregistre vos choix dans la configuration et les applique au redémarrage.

Autoriser une nouvelle tentative après un refus de la révision automatique avec /approve

Utilisez /approve si la révision automatique a refusé une action récente et que vous souhaitez que Codex la retente une fois.

1. Saisissez /approve.
2. Confirmez la nouvelle tentative lorsque Codex affiche l’action refusée.

Résultat attendu : Codex retente une fois l’action refusée, conformément à la politique de la session actuelle.

Configurer les mémoires avec /memories

1. Saisissez /memories.
2. Choisissez si Codex doit utiliser les mémoires existantes, en générer de nouvelles ou laisser ces fonctions désactivées.

Résultat attendu : Codex met à jour les paramètres de mémoire concernés pour les sessions futures.

Utiliser les skills avec /skills

1. Saisissez /skills.
2. Choisissez le skill à appliquer.

Résultat attendu : Codex insère le contexte du skill sélectionné pour suivre ses instructions lors de la prochaine demande.

Importer la configuration de Claude Code ou de Cursor avec /import

1. Saisissez /import.
2. Choisissez Claude Code ou Cursor.
3. Sélectionnez la configuration, les fichiers de projet ou les discussions récentes à migrer.

Codex recherche jusqu’à 50 discussions parmi celles des 30 derniers jours. Si Codex est connecté à un démon local ou à un serveur distant, il lit et importe les fichiers sur la machine qui exécute ce démon ou ce serveur. Attendez la fin de la tâche en cours avant de lancer une importation.

Pour connaître la procédure dans l’application de bureau et les types d’éléments pris en charge, consultez la page Importer depuis un autre agent.

Effacer le terminal et démarrer une nouvelle discussion avec /clear

1. Saisissez /clear et appuyez sur Entrée.

Résultat attendu : Codex efface le terminal, réinitialise l’historique visible et démarre une nouvelle discussion dans la même session CLI.

Pour nommer la discussion dès sa création, exécutez /clear release prep.

Contrairement à Ctrl+L, /clear démarre une nouvelle discussion.

Ctrl+L efface uniquement l’affichage du terminal et conserve la discussion actuelle. Codex désactive ces deux actions pendant l’exécution d’une tâche.

Archiver la session actuelle avec /archive

1. Saisissez /archive et appuyez sur Entrée.
2. Confirmez l’archivage de la session actuelle.

Résultat attendu : Codex archive la session et revient au centre de commande si la connexion passe par un serveur local en arrière-plan ou un serveur distant. Sans serveur partagé, Codex se ferme. Codex conserve l’historique, que vous pouvez restaurer ultérieurement avec codex unarchive <SESSION>.

Si un tour est en cours, confirmer /archive arrête ce tour avant l’archivage.

Supprimer la session actuelle avec /delete

1. Saisissez /delete et appuyez sur Entrée.
2. Confirmez la suppression de la session actuelle.

Résultat attendu : Codex supprime définitivement l’historique et les sessions descendantes créées à partir de cette session. Si la connexion passe par un serveur local en arrière-plan ou un serveur distant, Codex revient au centre de commande. Sans serveur partagé, Codex se ferme.

/delete est indisponible pendant l’exécution d’une discussion ou dans une discussion secondaire.

Modifier les autorisations avec /permissions

1. Saisissez /permissions et appuyez sur Entrée.
2. Sélectionnez le préréglage d’approbation qui vous convient, par exemple Auto pour les exécutions sans intervention ou Read Only pour examiner les modifications en lecture seule. Si des profils d’autorisations nommés sont actifs, le sélecteur affiche également les profils personnalisés configurés et leur description.

Pour sélectionner un profil par son identifiant pour cette session, utilisez /permissions <profile-id> [--approval-policy=<policy>] [--reviewer=user|auto_review]. Par exemple, /permissions :workspace --approval-policy=on-request --reviewer=user sélectionne l’accès à l’espace de travail et vous adresse les demandes d’approbation lorsque votre configuration le permet.

Inclure le contexte de l’IDE avec /ide

1. Saisissez /ide.
2. Si vous le souhaitez, ajoutez du texte sur la même ligne pour expliquer à Codex comment utiliser la sélection actuelle de l’IDE ou les fichiers ouverts.

Résultat attendu : Codex inclut le contexte disponible de l’IDE dans le prochain prompt.

Activer ou désactiver le mode Vim avec /vim

1. Saisissez /vim.
2. Continuez à écrire dans la zone de saisie.

Résultat attendu : Codex active ou désactive le mode Vim de la zone de saisie pour la session actuelle. Pour activer le mode Vim par défaut dans les nouvelles sessions, définissez tui.vim_mode_default = true dans config.toml.

Configurer le bac à sable Windows avec élévation de privilèges à l’aide de /setup-default-sandbox

Cette commande apparaît uniquement sur Windows lorsque Codex utilise le bac à sable en mode dégradé avec jeton restreint.

1. Saisissez /setup-default-sandbox.
2. Suivez la procédure de configuration administrateur.

Résultat attendu : Codex configure le bac à sable Windows avec élévation de privilèges et sélectionne le préréglage d’approbation automatique correspondant.

Copier la dernière réponse avec /copy

En mode avec historique de défilement, saisissez /copy, puis choisissez de copier la dernière réponse terminée en entier, un de ses blocs de code ou une de ses citations. En mode plein écran, sélectionnez un bloc dans l’historique. Appuyez sur Entrée pour copier votre sélection.

Après /status, utilisez /copy pour copier l’état complet ou un champ en particulier. Pour copier directement la dernière réponse terminée, appuyez sur Ctrl+ O .

Activer ou désactiver l’historique brut du terminal avec /raw

1. Saisissez /raw, /raw on ou /raw off.

Résultat attendu : Codex active ou désactive l’affichage brut de l’historique, ce qui facilite la sélection et la copie dans le terminal. Vous pouvez aussi utiliser le raccourci par défaut Alt+R ou activer ce mode par défaut avec tui.raw_output_mode = true.

Examiner la session avec /status

1. Dans une discussion, saisissez /status.
2. Consultez la sortie pour vérifier le modèle actif, la politique d’approbation, les répertoires racines accessibles en écriture et l’utilisation actuelle des tokens. Si la TUI est connectée à distance, la sortie indique également l’adresse distante et la version du serveur.

Résultat attendu : Codex affiche un récapitulatif qui vous permet de vérifier qu’il s’exécute dans l’environnement prévu.

Consulter l’utilisation du compte avec /usage

1. Saisissez /usage pour ouvrir le menu d’utilisation.
2. Choisissez d’afficher l’utilisation des tokens ou d’utiliser une réinitialisation que vous avez obtenue et qui reste disponible.
3. Pour accéder directement à l’utilisation des tokens, saisissez /usage daily, /usage weekly ou /usage cumulative.

Résultat attendu : Codex ouvre le menu des actions ou affiche l’utilisation des tokens du compte pour la période sélectionnée. Si la session n’est pas authentifiée auprès du service Codex avec votre compte, Codex vous invite à vous connecter.

Examiner les couches de configuration avec /debug-config

1. Saisissez /debug-config.
2. Consultez la sortie pour vérifier l’ordre des couches de configuration (de la moins prioritaire à la plus prioritaire), leur état d’activation et les sources des politiques.

Résultat attendu : Codex affiche les diagnostics des couches et les détails des politiques, notamment allowed_approval_policies, allowed_sandbox_modes, mcp_servers, rules et network_proxy si ces paramètres sont configurés.

Utilisez cette sortie pour déterminer pourquoi un paramètre effectif diffère de celui indiqué dans config.toml.

Configurer les éléments du pied de page avec /statusline

1. Saisissez /statusline.
2. Dans le sélecteur, activez, désactivez ou réordonnez les éléments, puis confirmez.

Résultat attendu : la ligne d’état du pied de page est immédiatement mise à jour. Codex enregistre votre sélection dans le paramètre tui.status_line du fichier config.toml.

La ligne d’état peut notamment afficher le modèle seul ou avec le niveau de raisonnement, les statistiques du contexte, les limites de débit, la branche Git, les compteurs de tokens, l’identifiant de session, le répertoire actuel ou la racine du projet, ainsi que la version de Codex.

Pour configurer le pied de page uniquement pour cette session, indiquez les éléments dans l’ordre d’affichage souhaité. Par exemple, /statusline model project-name affiche le modèle avant le nom du projet. Utilisez /statusline --clear pour masquer tous les éléments pendant cette session.

Configurer les éléments du titre du terminal avec /title

1. Saisissez /title.
2. Dans le sélecteur, activez, désactivez ou réordonnez les éléments, puis confirmez.

Résultat attendu : le titre de la fenêtre ou de l’onglet du terminal est immédiatement mis à jour. Codex enregistre votre sélection dans le paramètre tui.terminal_title du fichier config.toml.

Le titre peut notamment afficher le nom de l’application, le projet, un indicateur d’activité animé, l’état, le fil, la branche Git, le modèle et la progression de la tâche.

Pour configurer le titre uniquement pour cette session, indiquez les éléments dans l’ordre d’affichage souhaité. Par exemple, /title project-name model affiche le nom du projet avant le modèle. Utilisez /title --clear pour effacer les éléments du titre pour cette session.

Choisir un thème de coloration syntaxique avec /theme

1. Saisissez /theme.
2. Prévisualisez un thème dans le sélecteur, puis confirmez.

Résultat attendu : Codex met à jour la coloration syntaxique et enregistre votre choix dans le paramètre tui.theme du fichier config.toml.

Choisir un compagnon de terminal avec /pets

1. Saisissez /pets (ou /pet) pour ouvrir le sélecteur de compagnons.
2. Choisissez un compagnon intégré ou personnalisé, ou désactivez les compagnons.

Résultat attendu : Codex affiche le compagnon sélectionné en arrière-plan dans les terminaux compatibles et enregistre votre choix. Vous pouvez aussi saisir /pets off pour le masquer.

Réaffecter les raccourcis de la TUI avec /keymap

Utilisez /keymap pour consulter, modifier et enregistrer les raccourcis clavier de la TUI.

1. Saisissez /keymap.
2. Choisissez le contexte du raccourci et l’action à modifier.
3. Saisissez la nouvelle combinaison de touches ou supprimez la combinaison existante.

Résultat attendu : Codex met à jour les raccourcis actifs et enregistre la combinaison personnalisée dans le paramètre tui.keymap du fichier config.toml.

Les combinaisons de touches utilisent des noms tels que ctrl-a, shift-enter et page-down. Les raccourcis propres à un contexte ont priorité sur tui.keymap.global. Une liste vide supprime tout raccourci pour l’action concernée.

Vérifier les terminaux en arrière-plan avec /ps

1. Saisissez /ps.
2. Consultez la liste des terminaux en arrière-plan et leur état.

Résultat attendu : pour chaque terminal en arrière-plan, Codex affiche la commande et jusqu’à trois lignes récentes non vides de sa sortie, afin que vous puissiez évaluer rapidement sa progression.

Les terminaux en arrière-plan s’affichent lorsque unified_exec est utilisé. Sinon, la liste peut être vide.

Arrêter les terminaux en arrière-plan avec /stop

1. Saisissez /stop.
2. Si Codex vous demande confirmation avant d’arrêter les terminaux indiqués, confirmez.

Résultat attendu : Codex arrête tous les terminaux en arrière-plan de la session actuelle. /clean reste disponible comme alias de /stop.

Réduire la taille de l’historique avec /compact

1. Après un long échange, saisissez /compact.
2. Confirmez lorsque Codex propose de résumer la discussion jusqu’à présent.

Résultat attendu : Codex remplace les tours précédents par un résumé concis. Cela libère de l’espace dans le contexte tout en conservant les détails essentiels.

Examiner les modifications avec /diff

1. Saisissez /diff pour examiner le diff Git.
2. Faites défiler la sortie dans la CLI pour examiner les modifications et les fichiers ajoutés.

Résultat attendu : Codex affiche les modifications indexées, celles qui ne le sont pas encore et les fichiers que Git ne suit pas encore. Vous pouvez ainsi décider des éléments à conserver.

Désigner des fichiers avec /mention

1. Saisissez /mention suivi d’un chemin, par exemple /mention src/lib/api.ts.
2. Sélectionnez le résultat correspondant dans le menu qui s’ouvre.

Résultat attendu : Codex ajoute le fichier à la discussion pour que les tours suivants puissent s’y référer directement.

Démarrer une nouvelle discussion avec /new

1. Saisissez /new et appuyez sur Entrée.
2. Si Codex vous propose de choisir une copie de travail, sélectionnez le répertoire actuel ou un nouvel arbre de travail.

Résultat attendu : Codex démarre une nouvelle discussion dans la même session CLI. Vous pouvez ainsi changer de discussion sans quitter le terminal.

Pour nommer la discussion dès sa création, exécutez /new bug bash.

Contrairement à /clear, /new conserve l’affichage actuel du terminal.

Renommer la discussion actuelle avec /rename

1. Saisissez /rename <name>, ou saisissez /rename pour ouvrir la boîte de saisie du nom.
2. Saisissez un nom court qui vous permettra de retrouver facilement la discussion.

Résultat attendu : Codex met à jour le nom enregistré de la discussion sans modifier son historique.

Reprendre une discussion enregistrée avec /resume

1. Saisissez /resume et appuyez sur Entrée.
2. Dans le sélecteur, choisissez la portée de la recherche. Cwd affiche les discussions du répertoire actuel. Si l’option Repo est disponible, elle inclut également le répertoire correspondant dans les arbres de travail locaux liés. All étend la recherche à tous les répertoires.
3. Sélectionnez la discussion à reprendre.

Résultat attendu : Codex recharge l’historique de la discussion sélectionnée. Vous pouvez reprendre là où vous en étiez en conservant tout l’historique d’origine.

Forker la discussion actuelle avec /fork

1. Saisissez /fork et appuyez sur Entrée.
2. Si Codex vous propose de choisir une copie de travail, sélectionnez le répertoire actuel ou un nouvel arbre de travail.

Résultat attendu : Codex clone la discussion actuelle dans une nouvelle discussion dotée de son propre identifiant. L’historique d’origine reste intact et vous pouvez explorer une autre approche en parallèle.

Pour forker une session enregistrée plutôt que la session actuelle, exécutez codex fork dans le terminal afin d’ouvrir le sélecteur de sessions.

Poursuivre dans l’application de bureau avec /app

Sur macOS et Windows, saisissez /app pour ouvrir la session actuelle dans l’application de bureau ChatGPT. Si l’application n’est pas installée ou n’est pas en cours d’exécution, Codex affiche une erreur vous invitant à l’installer ou à la lancer.

Résultat attendu : l’application de bureau ouvre la même discussion enregistrée pour vous permettre de la poursuivre.

Démarrer une discussion secondaire avec /side

Utilisez /side pour créer un fork temporaire de la discussion actuelle tout en gardant la discussion principale ouverte.

1. Saisissez /side pour ouvrir une discussion secondaire.
2. Si vous le souhaitez, ajoutez du texte sur la même ligne. Par exemple, pour demander à Codex de vérifier si le plan présente un risque évident, saisissez /side Check whether this plan has an obvious risk.
3. Revenez à la discussion parente une fois la question traitée.

Résultat attendu : Codex ouvre une discussion secondaire dont l’historique est distinct de celui de la discussion parente. Pendant cet échange, la TUI continue d’afficher l’état de la discussion parente pour que vous puissiez vérifier si elle est toujours en cours.

/side est indisponible dans une autre discussion secondaire et en mode revue.

Générer un fichier AGENTS.md avec /init

1. Exécutez /init dans le répertoire où Codex doit rechercher des instructions persistantes.
2. Examinez le fichier AGENTS.md généré, puis adaptez-le aux conventions de votre dépôt.

Résultat attendu : Codex crée une trame de fichier AGENTS.md que vous pouvez compléter et intégrer à un commit pour les sessions futures.

Demander une revue de l’arbre de travail avec /review

1. Saisissez /review.
2. Exécutez ensuite /diff si vous souhaitez examiner en détail les modifications apportées aux fichiers.

Résultat attendu : Codex résume les problèmes détectés dans votre arbre de travail, en particulier les changements de comportement et les tests manquants. Il utilise le modèle de la session actuelle, sauf si vous définissez review_model dans config.toml.

Lister les outils MCP avec /mcp

1. Saisissez /mcp.
2. Consultez la liste pour vérifier quels serveurs et outils MCP sont disponibles.

Résultat attendu : la liste affiche les outils Model Context Protocol (MCP) configurés que Codex peut appeler dans cette session.

Utilisez /mcp verbose pour inclure les diagnostics détaillés des serveurs. Utilisez /mcp login <name> pour vous authentifier auprès d’un serveur MCP configuré depuis la session active.

Parcourir les applications avec /apps

1. Saisissez /apps.
2. Choisissez une application dans la liste.

Résultat attendu : Codex insère la mention de l’application dans la zone de saisie sous la forme $app-slug. Vous pouvez alors lui demander immédiatement de l’utiliser.

Parcourir les plugins avec /plugins

1. Saisissez /plugins.
2. Choisissez l’onglet d’une marketplace, puis sélectionnez un plugin pour examiner ses fonctionnalités ou les actions disponibles.

Résultat attendu : Codex ouvre le navigateur de plugins. Vous pouvez y consulter les plugins installés, leur état et les autres plugins que votre configuration vous permet de découvrir. Sélectionnez un plugin installé et appuyez sur Espace pour l’activer ou le désactiver.

Consulter et gérer les hooks du cycle de vie avec /hooks

1. Saisissez /hooks.
2. Choisissez un événement pour examiner les gestionnaires de hooks correspondants.
3. Selon vos besoins, accordez votre confiance aux hooks non gérés, désactivez-les ou réactivez-les.

Résultat attendu : Codex ouvre le navigateur de hooks pour vous permettre d’examiner les hooks du cycle de vie configurés. Les hooks gérés sont signalés comme tels. Vous ne pouvez pas les désactiver depuis le navigateur de hooks utilisateur.

Gérer les discussions avec /agents

1. Saisissez /agents et appuyez sur Entrée.
2. Sélectionnez une discussion dans le centre de commande pour l’ouvrir.

Résultat attendu : Codex affiche une vue d’ensemble des discussions sur le serveur connecté. Vous pouvez examiner leur état et passer de l’une à l’autre. Pour ouvrir le centre de commande directement depuis le terminal, exécutez codex agents. Le centre de commande nécessite un serveur partagé, local ou distant.

Changer de fil d’agent avec /subagents

1. Saisissez /subagents et appuyez sur Entrée.
2. Choisissez le fil souhaité dans le sélecteur.

Résultat attendu : Codex active le fil sélectionné pour vous permettre d’examiner ou de poursuivre le travail de cet agent.

Envoyer des commentaires avec /feedback

1. Saisissez /feedback et appuyez sur Entrée.
2. Suivez les indications pour inclure des journaux ou des données de diagnostic.

Résultat attendu : Codex recueille les données de diagnostic demandées et les transmet à l’équipe de maintenance.

Se déconnecter avec /logout

1. Saisissez /logout et appuyez sur Entrée.

Résultat attendu : Codex efface les identifiants locaux de la session utilisateur actuelle.

Quitter la CLI avec /quit ou /exit

1. Saisissez /quit (ou /exit) et appuyez sur Entrée.

Résultat attendu : Codex se ferme immédiatement. Au préalable, enregistrez tout travail important ou créez un commit.

Utilisez ces commandes pour piloter Codex depuis la palette de commandes de VS Code. Vous pouvez également leur associer des raccourcis clavier.

Attribuer un raccourci clavier

Pour attribuer ou modifier le raccourci clavier d’une commande Codex :

1. Ouvrez la palette de commandes (Cmd+Maj+P sur macOS ou Ctrl+Maj+P sur Windows et Linux).
2. Exécutez Préférences : ouvrir les raccourcis clavier.
3. Recherchez Codex ou l’identifiant de la commande (par exemple, chatgpt.newChat).
4. Sélectionnez l’icône en forme de crayon, puis saisissez le raccourci souhaité.

Commandes de l’extension

Les commandes slash permettent de piloter Codex sans quitter la zone de saisie. Utilisez-les pour vérifier l’état de la discussion, passer du mode local au mode cloud ou inversement, ou envoyer des commentaires.

Utiliser une commande slash

1. Dans la zone de saisie de Codex, saisissez /.
2. Sélectionnez une commande dans la liste ou continuez à saisir son nom pour filtrer les résultats (par exemple, /status).
3. Appuyez sur Entrée.

Commandes slash disponibles