Commandes pour les développeurs

Commandes de ChatGPT web

ChatGPT web dispose de son propre menu de commandes dans la zone de saisie. Saisissez / pour afficher les actions disponibles dans la conversation actuelle. Il ne donne pas accès au jeu de commandes de l’application de bureau ChatGPT ni à celui de la CLI ; les commandes slash, sous-commandes CLI et options de Codex présentées dans cette référence ne s’appliquent pas à ChatGPT web.

Commandes de l’application de bureau ChatGPT

La page générale Commandes couvre la navigation dans l’application, les raccourcis de conversation, la personnalisation du clavier et les liens profonds vers les conversations, les paramètres, les skills, les tâches planifiées, les plugins et les animaux de compagnie.

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

Référence des commandes de Codex CLI

Comment lire 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 si l’option est stable ou expérimentale et signale les combinaisons risquées.

Options globales

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

Vue d’ensemble des commandes

Détails des commandes

codex (interactif)

L’exécution de codex sans sous-commande lance l’interface utilisateur interactive du terminal (TUI). L’agent accepte les options globales ci-dessus ainsi que des images jointes. La recherche web utilise le mode cache par défaut ; utilisez --search pour passer à la navigation en direct. Pour simplifier le travail 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 app-server démarré avec codex app-server --listen ws://IP:PORT. Pour un socket Unix local, utilisez --remote unix:// pour le socket par défaut ou --remote unix://PATH pour un chemin explicite. Ajoutez --remote-auth-token-env <ENV_VAR> lorsque le serveur exige un jeton bearer pour l’authentification WebSocket.

codex app-server

Lancez l’app-server Codex localement. Cette commande est principalement destinée au développement et au débogage et peut changer sans préavis.

codex app-server --listen stdio:// conserve le comportement JSONL via stdio par défaut, et codex app-server --stdio est un alias de ce transport. --listen ws://IP:PORT active le transport WebSocket pour les clients app-server. Le serveur accepte les URL d’écoute ws:// ; utilisez une terminaison TLS ou un proxy sécurisé lorsque les clients se connectent avec wss://. Utilisez --listen unix:// pour accepter les négociations WebSocket sur le socket Unix par défaut de Codex, ou --listen unix:///absolute/path.sock pour choisir un chemin de socket. Si vous générez des schémas pour les liaisons clientes, ajoutez --experimental afin d’inclure les champs et méthodes soumis à restriction.

Ajoutez --code-mode-host wss://code-mode.example.com/host pour connecter app-server à un hôte Code Mode distant au lieu de démarrer un hôte local. Cette connexion sortante est distincte de --listen et partagée par chaque thread du processus app-server. Utilisez ws:// uniquement pour un hôte localhost ou transféré par SSH.

codex remote-control

Exécutez codex remote-control pour démarrer le contrôle à distance au premier plan. Utilisez codex remote-control start pour démarrer le démon app-server local avec le contrôle à distance activé, et codex remote-control stop pour l’arrêter. Les clients de contrôle à distance gérés et les workflows SSH distants utilisent ces commandes ; elles ne remplacent pas codex app-server --listen lorsque vous développez un client de protocole local.

Une fois le démon en cours d’exécution, utilisez codex remote-control pair pour créer et afficher un code d’association manuel de courte durée. Ajoutez --json à toute commande de contrôle à distance pour obtenir une sortie lisible par une machine. Pour pair, la réponse JSON comprend pairingCode, manualPairingCode, environmentId et expiresAt.

codex app

Lancez l’application de bureau ChatGPT depuis le terminal sous macOS ou Windows. Sous macOS, Codex peut ouvrir le chemin d’un espace de travail précis ; sous Windows, Codex affiche le chemin à ouvrir.

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

codex debug app-server send-message-v2

Envoyez un message via le flux thread/turn V2 d’app-server au moyen du client de test app-server intégré.

Ce flux de débogage s’initialise avec experimentalApi: true, démarre un thread, envoie un turn et diffuse les notifications du serveur. Utilisez-le pour reproduire et examiner localement le comportement du protocole app-server.

codex debug models

Affichez au format JSON le catalogue brut de modèles vu par Codex.

Utilisez --bundled lorsque vous souhaitez examiner uniquement le catalogue intégré au binaire actuel, sans l’actualiser depuis le point de terminaison distant des modèles.

codex debug prompt-input

Restituez au format JSON la liste exacte des entrées de prompt visibles par le modèle. Utilisez cette commande pour déboguer la découverte des instructions, le contexte de session ou la construction du prompt.

codex apply

Appliquez à votre dépôt local le diff le plus récent d’une conversation Codex cloud. Vous devez être authentifié et avoir accès à la conversation.

Codex affiche les fichiers corrigés et se termine avec un code différent de zéro si git apply échoue (par exemple en raison de conflits).

codex review

Exécutez une revue de code de manière non interactive. Choisissez exactement une cible de revue ou transmettez des instructions de revue personnalisées sous forme de prompt.

--uncommitted, --base, --commit et une instruction PROMPT personnalisée sont incompatibles entre eux. Utilisez --title uniquement avec --commit.

codex archive et codex unarchive

Archivez ou restaurez une session interactive enregistrée à l’aide de son ID ou de son nom. Utilisez ces commandes pour nettoyer le sélecteur de sessions sans supprimer la transcription. Les ID de session sont prioritaires sur les noms de session.

codex archive <SESSION>
codex unarchive <SESSION>

codex delete

Supprimez définitivement une session interactive enregistrée à l’aide de son ID ou de son nom. Utilisez cette commande uniquement pour supprimer la transcription au lieu de la masquer dans les listes de sessions actives.

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

Utilisez --force uniquement avec l’UUID d’une session. Les sessions nommées nécessitent toujours une confirmation afin que Codex ne supprime pas sans demande de confirmation un nom répété ou ambigu.

codex cloud

Interagissez avec les conversations Codex cloud depuis le terminal. La commande par défaut ouvre un sélecteur interactif ; codex cloud exec envoie directement une tâche et codex cloud list renvoie les conversations récentes pour les scripts ou une consultation rapide.

L’authentification utilise les mêmes identifiants que la CLI principale. Codex se termine avec un code différent de zéro si l’envoi de la tâche échoue.

codex cloud list

Répertoriez les conversations cloud récentes avec filtrage et pagination facultatifs.

La sortie en texte brut affiche l’URL d’une tâche, suivie des détails de son état. Utilisez --json pour l’automatisation. La charge utile JSON contient un tableau tasks ainsi qu’une valeur cursor facultative. Chaque tâche comprend id, url, title, status, updated_at, environment_id, environment_label, summary, is_review et attempt_total.

codex completion

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

codex doctor

Générez un rapport de diagnostic local avant de soumettre un problème au support ou lorsque vous recherchez la cause d’une installation Codex défaillante. Le rapport vérifie l’état de l’installation, de la configuration, de l’authentification, de l’exécution, de Git, du terminal, d’app-server et de l’inventaire des threads.

codex features

Gérez les indicateurs de fonctionnalité stockés dans $CODEX_HOME/config.toml. Les commandes enable et disable enregistrent durablement les modifications afin qu’elles s’appliquent aux sessions futures. La sous-commande features n’accepte pas --profile.

codex exec

Utilisez codex exec (ou la forme courte codex e) pour les exécutions scriptées ou de type CI qui doivent se terminer sans interaction humaine.

Codex produit une sortie mise en forme par défaut. Ajoutez --json pour recevoir des événements JSON délimités par des sauts de ligne (un par changement d’état). La sous-commande facultative resume permet de poursuivre des 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 effectuer une recherche dans toutes les sessions :

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, des fichiers sous ~/.codex/rules) et produit du JSON indiquant la décision la plus stricte et les règles correspondantes. Ajoutez --pretty pour mettre en forme la sortie. La commande execpolicy est actuellement en préversion.

codex login

Authentifiez la CLI avec un compte ChatGPT, une API key ou un jeton d’accès. Sans option, Codex ouvre un navigateur pour le flux ChatGPT OAuth.

codex login status se termine avec 0 lorsque des identifiants sont présents, ce qui est utile dans les scripts d’automatisation.

codex logout

Supprimez les identifiants enregistrés pour l’API key et l’authentification ChatGPT. Cette commande ne possède aucune option.

codex mcp

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

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

Les actions OAuth (login, logout) fonctionnent uniquement avec les serveurs HTTP streamable (et seulement lorsque le serveur prend en charge OAuth).

codex plugin

Installez, répertoriez et supprimez des plugins provenant des 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 comprennent pluginId, name, marketplaceName, version, installed, enabled, source, installPolicy, authPolicy et, lorsqu’il est disponible, marketplaceSource avec le type et la valeur de la source de marketplace configurée. codex plugin remove --json affiche pluginId, name et marketplaceName.

codex plugin marketplace

Gérez les sources de marketplaces de plugins que Codex peut parcourir et depuis lesquelles il peut effectuer des installations.

codex plugin marketplace add accepte les notations abrégées GitHub telles que owner/repo ou owner/repo@ref, les URL Git HTTP ou HTTPS, les URL Git SSH et les répertoires racines de marketplaces locales. Utilisez --ref pour épingler une référence Git et répétez --sparse PATH pour utiliser un checkout partiel pour les dépôts de marketplaces adossés à Git.

codex plugin marketplace list affiche les noms et racines des marketplaces concernées, y compris les marketplaces par défaut découvertes implicitement et les instantanés des marketplaces configurées.

Ajoutez --json aux commandes d’ajout, de liste, de mise à niveau ou de suppression de marketplace pour obtenir une sortie adaptée à l’automatisation. Le JSON d’ajout d’une marketplace comprend marketplaceName, installedRoot et alreadyAdded ; le JSON de la liste comprend un tableau marketplaces avec name, root et marketplaceSource facultatif ; le JSON de mise à niveau comprend selectedMarketplaces, upgradedRoots et errors ; le JSON de suppression comprend marketplaceName et installedRoot.

codex mcp-server

Exécutez Codex en tant que serveur MCP via stdio afin que d’autres outils puissent s’y connecter. Cette commande hérite des remplacements de configuration globaux et se termine lorsque le client en aval ferme la connexion.

codex resume

Poursuivez une session interactive à l’aide de son ID ou reprenez la conversation la plus récente. codex resume limite --last au répertoire de travail actuel, sauf si vous transmettez --all. Cette commande accepte les mêmes options globales que codex, y compris les remplacements du modèle et du bac à sable.

Si le répertoire de travail actuel diffère du répertoire enregistré de la session, Codex vous demande quel répertoire utiliser. Définissez tui.resume_cwd sur "current" ou "session" afin de réutiliser ce choix sans demande de confirmation. Un remplacement explicite --cd (-C) est prioritaire sur tui.resume_cwd.

codex fork

Dupliquez une session interactive précédente dans une nouvelle conversation. Par défaut, codex fork ouvre le sélecteur de sessions ; ajoutez --last pour dupliquer plutôt votre session la plus récente.

Lorsque les répertoires de la session actuelle et de la session enregistrée diffèrent, codex fork utilise la même demande de choix du répertoire de travail et le même paramètre tui.resume_cwd que codex resume.

codex sandbox

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

macOS seatbelt

Linux Landlock

Windows

codex update

Recherchez et appliquez une mise à jour de Codex CLI lorsque la version installée prend en charge la mise à jour automatique. Les builds de débogage affichent un message vous invitant à installer plutôt un build de production.

Combinaisons d’options et conseils de sécurité

• Utilisez --sandbox workspace-write pour les tâches locales sans surveillance qui peuvent rester dans l’espace de travail, et évitez --dangerously-bypass-approvals-and-sandbox sauf si vous vous trouvez dans une VM dédiée faisant office de bac à sable.
• Lorsque vous devez accorder à Codex un accès en écriture à d’autres répertoires, préférez --add-dir plutôt que de forcer --sandbox danger-full-access.
• Associez --json à --output-last-message dans la CI afin de capturer une progression lisible par une 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 Up ou Down pour restaurer l’historique des brouillons.
• Appuyez sur Ctrl+R pour rechercher dans l’historique des prompts, puis sur Enter pour utiliser un résultat ou sur Esc pour annuler.
• Appuyez sur Ctrl+O ou exécutez /copy pour copier la dernière sortie terminée de Codex.
• Préfixez une ligne avec ! pour exécuter une commande shell locale avec les paramètres actuels d’approbation et de bac à sable.
• Appuyez sur Tab pendant que Codex travaille pour mettre en file d’attente un prompt de suivi, une commande slash ou une commande shell pour le tour suivant.
• Appuyez sur Enter pendant que Codex travaille pour injecter de nouvelles instructions dans le tour actuel.
• Appuyez deux fois sur Esc lorsque la zone de saisie est vide pour modifier le message utilisateur précédent et dupliquer la conversation à partir de ce point.
• Appuyez sur Ctrl+C ou exécutez /exit pour fermer la session.

Ressources connexes

• Vue d’ensemble de Codex CLI : installation, mises à niveau et conseils rapides.
• Principes de base de la configuration : enregistrez des valeurs par défaut telles que le modèle et le fournisseur.
• Configuration avancée : profils, fournisseurs, réglage du bac à sable et intégrations.
• AGENTS.md : vue d’ensemble conceptuelle des fonctionnalités des agents Codex et des bonnes pratiques.

Les commandes slash permettent de contrôler rapidement Codex au clavier. Saisissez / dans la zone de saisie pour ouvrir le menu contextuel des commandes slash, choisissez une commande, et Codex effectuera des actions telles que changer de modèle, ajuster les autorisations ou résumer de longues conversations sans quitter 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 telles que /model, /fast, /personality, /permissions, /approve, /raw, /agent et /status

Commandes slash de Codex CLI

Commandes slash intégrées

Codex est fourni avec les commandes suivantes. Ouvrez le menu contextuel des commandes slash et commencez à saisir le nom de la commande pour filtrer la liste.

Lorsqu’une conversation est déjà en cours, vous pouvez saisir une commande slash et appuyer sur Tab pour la mettre en file d’attente pour le tour suivant. Codex analyse les commandes slash en attente lorsqu’elles s’exécutent ; les menus de commandes et les erreurs apparaissent donc une fois le tour actuel terminé. La complétion des commandes slash continue de fonctionner avant leur mise en file d’attente.

/quit et /exit quittent tous deux la CLI. Utilisez-les uniquement après avoir enregistré ou commité tout travail important.

Utilisez /permissions pour ajuster ce que Codex peut faire sans demander d’abord. Utilisez /approve uniquement lorsque vous devez réessayer une action récente que la revue automatique a refusée.

Contrôler votre session avec les commandes slash

Les workflows suivants vous permettent de garder votre session sur la bonne voie sans redémarrer Codex.

Définir le modèle actif avec /model

1. Démarrez Codex et ouvrez la zone de saisie.
2. Saisissez /model et appuyez sur Entrée.
3. Choisissez un modèle tel que gpt-5.6-luna ou gpt-5.6-terra dans la fenêtre contextuelle.

Résultat attendu : Codex confirme le nouveau modèle dans la transcription. Exécutez /status pour vérifier la modification.

Activer ou désactiver le mode Fast avec /fast

1. Saisissez /fast pour activer le niveau de service Fast du modèle actuel.
2. Saisissez de nouveau /fast pour le désactiver.

Résultat attendu : Codex change le niveau et enregistre la sélection. Dans le pied de page de la TUI, vous pouvez également afficher un élément de ligne d’état pour le mode Fast avec /statusline.

Les commandes du niveau Fast dépendent du catalogue. Si le modèle actuel n’annonce pas de niveau Fast, Codex n’affiche pas /fast.

Définir un style de communication avec /personality

Utilisez /personality pour modifier la manière dont Codex communique sans réécrire votre invite.

1. Dans un chat actif, saisissez /personality et appuyez sur Entrée.
2. Choisissez un style dans la fenêtre contextuelle.

Résultat attendu : Codex confirme le nouveau style dans la transcription et l’utilise pour les réponses suivantes du chat.

Codex prend en charge les personnalités friendly, pragmatic et none. Utilisez none pour désactiver les instructions de personnalité.

Si le modèle actif ne prend pas en charge les instructions propres aux personnalités, Codex masque cette commande.

Passer en mode plan avec /plan

1. Saisissez /plan et appuyez sur Entrée pour faire passer le chat actif en mode plan.
2. Facultatif : fournissez le texte d’une invite en ligne (par exemple, /plan Propose a migration plan for this service).
3. Vous pouvez coller du contenu ou joindre des images lorsque vous utilisez des arguments /plan en ligne.

Résultat attendu : Codex passe en mode plan et utilise votre éventuelle invite en ligne comme première demande de planification.

Lorsque Codex travaille déjà, /plan est temporairement indisponible.

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

1. Saisissez /goal <objective> pour définir l’objectif, par exemple /goal Finish the migration and keep tests green.
2. Saisissez /goal pour afficher l’objectif actuel.
3. Utilisez /goal edit pour réviser 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 associé au chat actif pendant la poursuite du travail.

Les objectifs doivent être non vides et contenir au maximum 4 000 caractères. Pour des instructions plus longues, placez les détails dans un fichier et faites pointer l’objectif vers ce fichier.

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 (par exemple, Network proxy ou Prevent sleep while running), puis redémarrez Codex si vous y êtes invité.

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

Approuver un refus de la revue automatique avec /approve

Utilisez /approve lorsque le réviseur automatique a refusé une action récente et que vous souhaitez que Codex la réessaie une fois.

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

Résultat attendu : Codex réessaie cette action refusée une fois selon 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 le comportement des mémoires désactivé.

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

Utiliser des skills avec /skills

1. Saisissez /skills.
2. Choisissez le skill que Codex doit appliquer.

Résultat attendu : Codex insère le contexte du skill sélectionné afin que la prochaine demande suive les instructions de ce skill.

Importer la configuration de Claude Code avec /import

1. Saisissez /import.
2. Choisissez Claude Code.
3. Sélectionnez la configuration, les fichiers de projet ou les chats récents que vous souhaitez migrer.

Résultat attendu : Codex ouvre le sélecteur d’importation d’agent externe et importe les artefacts compatibles sélectionnés dans la configuration de Codex et les fichiers locaux. La détection des sessions inclut jusqu’à 50 chats des 30 derniers jours.

Exécutez /import depuis une session TUI locale. Cette commande est indisponible pendant l’exécution d’une tâche, dans les sessions distantes et lors d’une connexion au démon app-server local.

Pour connaître le workflow de l’app de bureau et les types d’artefacts pris en charge, consultez Importer depuis un autre agent.

Effacer le terminal et démarrer un nouveau chat avec /clear

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

Résultat attendu : Codex efface le terminal, réinitialise la transcription visible et démarre un nouveau chat dans la même session CLI.

Pour nommer le nouveau chat lors de sa création, exécutez /clear release prep.

Contrairement à Ctrl+L, /clear démarre un nouveau chat.

Ctrl+L efface uniquement l’affichage du terminal et conserve le chat actuel. Codex désactive les deux actions pendant qu’une tâche est en cours.

Archiver la session actuelle avec /archive

1. Saisissez /archive et appuyez sur Entrée.
2. Confirmez que vous souhaitez archiver la session actuelle et quitter Codex.

Résultat attendu : Codex archive la session actuelle et ferme la TUI interactive. Codex conserve la transcription de la session en local ; restaurez-la ultérieurement avec codex unarchive <SESSION>.

/archive est indisponible pendant l’exécution d’une tâche.

Supprimer la session actuelle avec /delete

1. Saisissez /delete et appuyez sur Entrée.
2. Confirmez que vous souhaitez supprimer la session actuelle et quitter Codex.

Résultat attendu : Codex supprime la transcription de la session actuelle et ferme la TUI interactive. La suppression est définitive et retire également les sessions descendantes créées.

/delete est indisponible lorsqu’un chat est en cours d’exécution ou dans un chat latéral.

Mettre à jour les autorisations avec /permissions

1. Saisissez /permissions et appuyez sur Entrée.
2. Sélectionnez le préréglage d’approbation correspondant au niveau de contrôle souhaité, par exemple Auto pour les exécutions autonomes ou Read Only pour examiner les modifications. Lorsque des profils d’autorisation nommés sont actifs, le sélecteur affiche également les profils personnalisés configurés et leur description.

Résultat attendu : Codex annonce la politique mise à jour. Les actions futures respectent le mode d’approbation mis à jour jusqu’à ce que vous le changiez de nouveau.

Inclure le contexte de l’IDE avec /ide

1. Saisissez /ide.
2. Ajoutez éventuellement du texte en ligne pour expliquer ce que Codex doit faire avec la sélection actuelle de l’IDE ou les fichiers ouverts.

Résultat attendu : Codex inclut le contexte disponible de l’IDE dans la prochaine invite.

Activer ou désactiver le mode Vim avec /vim

1. Saisissez /vim.
2. Continuez à modifier le texte 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 faire du mode Vim le mode par défaut des nouvelles sessions, définissez tui.vim_mode_default = true dans config.toml.

Configurer le bac à sable Windows avec privilèges élevés avec /setup-default-sandbox

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

1. Saisissez /setup-default-sandbox.
2. Suivez le processus de configuration administrateur.

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

Copier la dernière réponse avec /copy

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

Résultat attendu : Codex copie la dernière sortie terminée de Codex dans votre presse-papiers.

Si un tour est encore en cours, /copy utilise la dernière sortie terminée au lieu de la réponse en cours. La commande est indisponible avant la première sortie terminée de Codex et immédiatement après une restauration.

Vous pouvez également appuyer sur Ctrl+O depuis la TUI principale pour copier la dernière réponse terminée sans ouvrir le menu des commandes slash.

Activer ou désactiver le défilement brut avec /raw

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

Résultat attendu : Codex active ou désactive le mode de défilement brut, qui rend la sélection et la copie dans le terminal plus directes. Vous pouvez également utiliser le raccourci par défaut Alt+R ou enregistrer ce comportement par défaut avec tui.raw_output_mode = true.

Accorder un accès en lecture au bac à sable avec /sandbox-add-read-dir

Cette commande est disponible uniquement lorsque la CLI s’exécute nativement sous Windows.

1. Saisissez /sandbox-add-read-dir C:\absolute\directory\path et appuyez sur Entrée.
2. Confirmez que le chemin correspond à un répertoire absolu existant.

Résultat attendu : Codex actualise la politique du bac à sable Windows et accorde un accès en lecture à ce répertoire pour les commandes ultérieures exécutées dans le bac à sable.

Examiner la session avec /status

1. Dans n’importe quel chat, saisissez /status.
2. Consultez la sortie pour connaître le modèle actif, la politique d’approbation, les racines accessibles en écriture et l’utilisation actuelle des tokens. Lorsque la TUI se connecte à distance, la sortie affiche également l’adresse distante et la version du serveur.

Résultat attendu : Codex affiche un résumé confirmant qu’il fonctionne dans l’environnement attendu.

Afficher l’utilisation du compte avec /usage

1. Saisissez /usage pour ouvrir le menu d’utilisation.
2. Choisissez d’afficher l’activité des tokens ou d’utiliser une réinitialisation acquise disponible.
3. Pour ouvrir directement l’activité des tokens, saisissez /usage daily, /usage weekly ou /usage cumulative.

Résultat attendu : Codex ouvre les actions d’utilisation ou affiche l’activité des tokens du compte pour la vue sélectionnée. Si la session ne dispose pas de l’authentification du compte de service Codex, Codex affiche une demande de connexion.

Examiner les couches de configuration avec /debug-config

1. Saisissez /debug-config.
2. Consultez la sortie pour connaître l’ordre des couches de configuration (de la priorité la plus faible à la plus élevée), leur état actif/inactif et les sources des politiques.

Résultat attendu : Codex affiche les diagnostics des couches ainsi que les détails des politiques tels que allowed_approval_policies, allowed_sandbox_modes, mcp_servers, rules, enforce_residency et experimental_network lorsqu’ils sont configurés.

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

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

1. Saisissez /statusline.
2. Utilisez le sélecteur pour activer, désactiver et réorganiser les éléments, puis confirmez.

Résultat attendu : La ligne d’état du pied de page est immédiatement mise à jour et enregistrée dans tui.status_line dans config.toml.

Les éléments disponibles de la ligne d’état comprennent le modèle, le modèle et le raisonnement, les statistiques de 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, et la version de Codex.

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

1. Saisissez /title.
2. Utilisez le sélecteur pour activer, désactiver et réorganiser 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 et enregistré dans tui.terminal_title dans config.toml.

Les éléments de titre disponibles comprennent le nom de l’app, le projet, l’indicateur d’activité, l’état, le fil, la branche git, le modèle et la progression de la tâche.

Choisir un thème de syntaxe 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 le choix dans tui.theme dans config.toml.

Choisir un animal de compagnie dans le terminal avec /pets

1. Saisissez /pets (ou /pet) pour ouvrir le sélecteur d’animaux.
2. Choisissez un animal intégré ou personnalisé, ou désactivez-les.

Résultat attendu : Codex affiche l’animal d’ambiance sélectionné dans les terminaux compatibles et enregistre la sélection. Vous pouvez également saisir /pets off pour le masquer.

Réaffecter les raccourcis de la TUI avec /keymap

Utilisez /keymap pour examiner, mettre à jour et enregistrer les raccourcis clavier de la TUI.

1. Saisissez /keymap.
2. Choisissez le contexte du raccourci et l’action que vous souhaitez modifier.
3. Saisissez la nouvelle combinaison ou supprimez celle qui existe.

Résultat attendu : Codex met à jour le mappage de touches actif et écrit le raccourci personnalisé dans tui.keymap dans config.toml.

Les raccourcis utilisent des noms tels que ctrl-a, shift-enter et page-down. Les raccourcis propres à un contexte remplacent tui.keymap.global ; une liste de raccourcis vide dissocie l’action.

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 : Codex affiche la commande de chaque terminal en arrière-plan ainsi que jusqu’à trois lignes de sortie récentes et non vides afin de vous permettre d’évaluer la progression en un coup d’œil.

Les terminaux en arrière-plan apparaissent 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. Confirmez si Codex vous le demande avant d’arrêter les terminaux répertoriés.

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

Alléger les transcriptions avec /compact

1. Après un long échange, saisissez /compact.
2. Confirmez lorsque Codex propose de résumer le chat jusqu’à ce point.

Résultat attendu : Codex remplace les tours précédents par un résumé concis, libérant du contexte tout en conservant les détails essentiels.

Examiner les modifications avec /diff

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

Résultat attendu : Codex affiche les modifications que vous avez indexées, celles qui ne le sont pas encore et les fichiers que Git ne suit pas encore, afin que vous puissiez décider lesquels conserver.

Mettre des fichiers en évidence avec /mention

1. Saisissez /mention suivi d’un chemin, par exemple /mention src/lib/api.ts.
2. Sélectionnez le résultat correspondant dans la fenêtre contextuelle.

Résultat attendu : Codex ajoute le fichier au chat, afin que les tours suivants y fassent directement référence.

Démarrer un nouveau chat avec /new

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

Résultat attendu : Codex démarre un nouveau chat dans la même session CLI, afin que vous puissiez changer de chat sans quitter votre terminal.

Pour nommer le nouveau chat lors de sa création, exécutez /new bug bash.

Contrairement à /clear, /new n’efface pas d’abord l’affichage actuel du terminal.

Renommer le chat actuel avec /rename

1. Saisissez /rename <name>, ou saisissez /rename pour ouvrir l’invite de dénomination.
2. Saisissez un nom court qui vous aidera à retrouver le chat ultérieurement.

Résultat attendu : Codex met à jour le nom enregistré du chat sans modifier sa transcription.

Reprendre un chat enregistré avec /resume

1. Saisissez /resume et appuyez sur Entrée.
2. Choisissez la session souhaitée dans le sélecteur de sessions enregistrées.

Résultat attendu : Codex recharge la transcription du chat sélectionné afin que vous puissiez reprendre là où vous vous étiez arrêté, tout en conservant l’historique d’origine intact.

Dupliquer le chat actuel avec /fork

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

Résultat attendu : Codex clone le chat actuel dans un nouveau chat doté d’un nouvel ID, sans modifier la transcription d’origine, afin que vous puissiez explorer une autre approche en parallèle.

Si vous devez dupliquer une session enregistrée plutôt que la session actuelle, exécutez codex fork dans votre terminal pour ouvrir le sélecteur de sessions.

Poursuivre dans l’app de bureau avec /app

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

Résultat attendu : L’app de bureau ouvre le même chat enregistré afin que vous puissiez y poursuivre votre travail.

Démarrer un chat latéral avec /side

Utilisez /side pour démarrer une branche éphémère depuis le chat actuel sans quitter le chat principal.

1. Saisissez /side pour ouvrir un chat latéral.
2. Ajoutez éventuellement du texte en ligne, par exemple /side Check whether this plan has an obvious risk.
3. Revenez au chat parent une fois la parenthèse ciblée terminée.

Résultat attendu : Codex ouvre un chat latéral dont la transcription est distincte de celle du chat parent. Lorsque vous êtes en mode latéral, la TUI continue d’afficher l’état du chat parent afin que vous puissiez voir si le chat principal est toujours en cours d’exécution.

/side est indisponible dans un autre chat latéral et pendant le mode de revue.

Générer AGENTS.md avec /init

1. Exécutez /init dans le répertoire où vous souhaitez que Codex recherche des instructions persistantes.
2. Examinez le fichier AGENTS.md généré, puis modifiez-le pour l’adapter aux conventions de votre dépôt.

Résultat attendu : Codex crée une structure AGENTS.md que vous pouvez affiner et commiter pour les sessions futures.

Demander une revue du worktree avec /review

1. Saisissez /review.
2. Poursuivez avec /diff si vous souhaitez examiner les modifications exactes des fichiers.

Résultat attendu : Codex résume les problèmes détectés dans votre worktree, en privilégiant 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.

Répertorier 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 : Vous voyez les outils Model Context Protocol (MCP) configurés que Codex peut appeler dans cette session.

Utilisez /mcp verbose pour inclure des diagnostics détaillés sur les serveurs. Si vous transmettez autre chose que verbose, Codex affiche l’utilisation de la commande.

Parcourir les apps avec /apps

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

Résultat attendu : Codex insère la mention de l’app dans la zone de saisie sous la forme $app-slug, afin que vous puissiez immédiatement demander à Codex de l’utiliser.

Parcourir les plugins avec /plugins

1. Saisissez /plugins.
2. Choisissez un onglet de marketplace, puis sélectionnez un plugin pour examiner ses fonctionnalités ou ses actions disponibles.

Résultat attendu : Codex ouvre le navigateur de plugins afin que vous puissiez examiner les plugins installés, les plugins disponibles autorisés par votre configuration et l’état des plugins installés. Appuyez sur Espace sur un plugin installé pour activer ou désactiver son état d’activation.

Afficher et gérer les hooks de cycle de vie avec /hooks

1. Saisissez /hooks.
2. Choisissez un événement de hook pour examiner les gestionnaires correspondants.
3. Approuvez, désactivez ou réactivez les hooks non gérés selon vos besoins.

Résultat attendu : Codex ouvre le navigateur de hooks afin que vous puissiez examiner les hooks de cycle de vie configurés. Les hooks gérés sont indiqués comme tels et ne peuvent pas être désactivés depuis le navigateur de hooks utilisateur.

Changer de fil d’agent avec /agent

1. Saisissez /agent ou /subagents et appuyez sur Entrée.
2. Sélectionnez le fil souhaité dans le sélecteur.

Résultat attendu : Codex change le fil actif afin que vous puissiez examiner ou poursuivre le travail de cet agent.

Envoyer des commentaires avec /feedback

1. Saisissez /feedback et appuyez sur Entrée.
2. Suivez les instructions pour inclure des journaux ou des diagnostics.

Résultat attendu : Codex collecte les diagnostics demandés et les envoie aux responsables.

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. Enregistrez ou commitez d’abord tout travail important.

Commandes de l’extension IDE

Utilisez ces commandes pour contrôler 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 un raccourci clavier pour une commande Codex :

1. Ouvrez la palette de commandes (Cmd+Shift+P sous macOS ou Ctrl+Shift+P sous Windows/Linux).
2. Exécutez Preferences: Open Keyboard Shortcuts.
3. Recherchez Codex ou l’ID 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

Commandes slash de l’extension IDE

Les commandes slash vous permettent de contrôler Codex sans quitter la zone de saisie. Utilisez-les pour vérifier l’état, basculer entre le mode local et le mode cloud, 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 du texte pour filtrer (par exemple, /status).
3. Appuyez sur Entrée.

Commandes slash disponibles