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 voir les actions disponibles dans la conversation en cours. Il ne donne pas accès au jeu de commandes de l’application de bureau ChatGPT ni 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 présente 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 dans 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 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 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 par défaut le mode mis en cache ; utilisez --search pour passer à la navigation en direct. Pour travailler localement avec peu de contraintes, 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 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 localement le serveur d’application Codex. Cette fonctionnalité 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 sur 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 à autorisation.

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 tous les threads 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 à courte durée de vie. 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 l’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 à l’aide du client de test app-server intégré.

Ce flux de débogage s’initialise avec experimentalApi: true, démarre un thread, envoie un tour 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 des modèles vus 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

Générez 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 renvoie un code de sortie non nul 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 un PROMPT personnalisé 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 alléger 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 un UUID de session. Les sessions nommées nécessitent toujours une confirmation afin que Codex ne supprime pas sans avertissement 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 renvoie un code de sortie non nul 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 et éventuellement une valeur cursor. 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 signaler un problème à l’assistance ou lorsque vous recherchez la cause d’une installation Codex défectueuse. 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 s’achever sans intervention humaine.

Codex écrit par défaut une sortie mise en forme. 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 la 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 un JSON indiquant 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 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 renvoie 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 comporte 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 avec flux :

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

codex plugin

Installez, répertoriez 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 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 une notation abrégée GitHub telle que owner/repo ou owner/repo@ref, des URL Git HTTP ou HTTPS, des URL Git SSH et des 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 avec les dépôts de marketplaces adossés à Git.

codex plugin marketplace list affiche les noms et racines des marketplaces dans le périmètre, y compris les marketplaces par défaut découvertes implicitement et les instantanés de marketplaces configurés.

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

codex mcp-server

Pour les intégrations existantes, la commande exécute Codex comme serveur MCP via stdio afin que d’autres outils puissent s’y connecter. Elle 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" pour réutiliser ce choix sans demander de confirmation. Un remplacement explicite --cd (-C) prévaut sur tui.resume_cwd.

codex fork

Créez une nouvelle conversation à partir d’une session interactive précédente. Par défaut, codex fork ouvre le sélecteur de sessions ; ajoutez --last pour créer plutôt une branche depuis 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 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.

Seatbelt macOS

Landlock Linux

Windows

codex update

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

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 pour 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 une correspondance 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 en cours.
• Appuyez deux fois sur Esc lorsque la zone de saisie est vide pour modifier le message utilisateur précédent et créer une branche de la conversation à partir de ce point.
• Appuyez sur Ctrl+C ou exécutez /exit pour fermer la session.

Ressources connexes

• Présentation 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 : présentation conceptuelle des capacités des agents Codex et des bonnes pratiques.

Les commandes slash vous permettent de contrôler Codex rapidement et entièrement au clavier. Saisissez / dans la zone de saisie pour ouvrir le menu 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 montre 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 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 au moment de leur exécution ; les menus de commandes et les erreurs apparaissent donc une fois le tour en cours terminé. La complétion des commandes slash reste disponible avant leur mise en file d’attente.

/quit et /exit quittent tous deux la CLI. Ne les utilisez qu’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 l’examen 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 dans la fenêtre contextuelle un modèle tel que gpt-5.6-luna ou gpt-5.6-terra.

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

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 de 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 garde l’objectif associé au chat actif pendant la poursuite du travail.

Les objectifs doivent être non vides et comporter 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 l’invite vous le demande.

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

Approuver un refus de l’examen automatique avec /approve

Utilisez /approve lorsque l’outil d’examen 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 une fois cette 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 les fonctionnalités de mémoire 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 que Codex doit appliquer.

Résultat attendu : Codex insère le contexte du skill sélectionné afin que la prochaine requête respecte ses instructions.

Importer la configuration de Claude Code ou Cursor avec /import

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

Résultat attendu : Codex ouvre le sélecteur d’importation d’agent externe et importe les artefacts pris en charge 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 lorsque vous êtes connecté 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 dès 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 ces deux actions lorsqu’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 supprime également les sessions descendantes créées.

/delete est indisponible pendant l’exécution d’un chat 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 à votre niveau de confort, 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 mise à jour de la politique. 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 de la sélection actuelle ou des fichiers ouverts dans l’IDE.

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 la modification 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 n’apparaît que 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 plutôt que la réponse en cours. La commande est indisponible avant la première sortie terminée de Codex et juste après un retour en arrière.

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 conserver ce réglage 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 directement sous Windows.

1. Saisissez /sandbox-add-read-dir C:\absolute\directory\path et appuyez sur Entrée.
2. Vérifiez 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. Examinez les informations relatives au modèle actif, à la politique d’approbation, aux 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écapitulatif confirmant qu’il fonctionne à l’endroit prévu.

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 relatives à l’utilisation ou affiche l’activité des tokens du compte pour la vue sélectionnée. Si la session ne dispose pas d’une authentification de compte de service Codex, Codex affiche une demande de connexion.

Examiner les couches de configuration avec /debug-config

1. Saisissez /debug-config.
2. Examinez l’ordre des couches de configuration (de la priorité la plus faible à la plus élevée), leur état activé/désactivé et les sources des politiques.

Résultat attendu : Codex affiche les diagnostics des couches ainsi que des détails sur les politiques tels que allowed_approval_policies, allowed_sandbox_modes, mcp_servers, rules 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 au sein de config.toml.

Les éléments disponibles pour 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 au sein de config.toml.

Les éléments disponibles pour le titre comprennent le nom de l’app, le projet, l’indicateur de chargement, 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 depuis le sélecteur, puis confirmez.

Résultat attendu : Codex met à jour la coloration syntaxique et enregistre ce choix dans tui.theme au sein de config.toml.

Choisir un animal de compagnie du 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 animaux.

Résultat attendu : Codex affiche l’animal d’ambiance sélectionné dans les terminaux pris en charge 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 conserver les associations de raccourcis clavier de la TUI.

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

Résultat attendu : Codex met à jour le mappage de touches actif et écrit l’association personnalisée dans tui.keymap au sein de config.toml.

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

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

1. Saisissez /ps.
2. Examinez 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 que vous puissiez é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’à présent.

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. 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, 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, ce qui vous permet de changer de chat sans quitter votre terminal.

Pour nommer le nouveau chat dès 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 nommage.
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 des 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 demandant de l’installer ou de la lancer.

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

Démarrer un chat latéral avec /side

Utilisez /side pour créer une branche éphémère à partir du 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. 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 en mode examen.

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 un examen de l’arborescence de travail avec /review

1. Saisissez /review.
2. Enchaînez 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 arborescence de travail, en se concentrant sur 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. Examinez 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 pendant 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 la marketplace, puis sélectionnez un plugin pour examiner ses fonctionnalités ou les actions disponibles.

Résultat attendu : Codex ouvre le navigateur de plugins afin que vous puissiez examiner les plugins installés, les plugins détectables autorisés par votre configuration et l’état des plugins installés. Appuyez sur Espace sur un plugin installé pour modifier 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 de l’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 invites 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 attribuer des raccourcis clavier.

Attribuer un raccourci clavier

Pour attribuer ou modifier un raccourci clavier d’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 les modes local et 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