Paramètres pour les développeurs
Paramètres pour les développeurs
Configurez les paramètres de développement dans les clients ChatGPT et Codex
- Application de bureau ChatGPT Projets, fichiers et tâches plus longues sur ordinateur.
- ChatGPT sur le web Conversations, projets et Work dans votre navigateur.
- Codex CLI Codex dans votre terminal.
- Extension IDE Codex Codex dans votre éditeur.
ChatGPT web enregistre les préférences du produit et de l’espace de travail dans les paramètres de ChatGPT. Les conversations ChatGPT Work s’exécutent dans un environnement géré et ne lisent pas les fichiers de configuration Codex locaux. Utilisez les contrôles mis à disposition par votre espace de travail dans les paramètres de ChatGPT ; les administrateurs de l’espace de travail peuvent gérer certains paramètres à votre place.
La page générale Paramètres couvre les préférences de l’application, notamment le profil, les raccourcis clavier, les notifications, l’apparence, la personnalisation, les mémoires et les conversations archivées.
Comportement des projets et du terminal
Choisissez où ouvrir les fichiers, quelle quantité de sortie de commande afficher dans les conversations et où ouvrir les onglets du terminal par défaut.
Revue de code
Sous Paramètres > Git, utilisez Transmission de la revue pour choisir En ligne afin d’exécuter
/review dans la conversation actuelle lorsque cela est possible, ou Détachée afin de démarrer une conversation
de revue distincte.
Synchronisation avec l’extension IDE
Lorsque l’application de bureau ChatGPT et l’extension IDE sont ouvertes dans le même projet, elles partagent les conversations actives et le contexte de l’éditeur. Activez Contexte IDE depuis la zone de rédaction de l’application pour permettre à Codex d’utiliser les fichiers actuellement ouverts dans votre éditeur. Désactivez cette option lorsque vous souhaitez que le prompt de l’application exclue ce contexte d’éditeur.
Vous pouvez ouvrir une conversation de l’application depuis l’extension IDE et poursuivre une conversation de l’IDE dans l’application. Les deux interfaces utilisent le même projet pour déterminer les conversations et le contexte à partager.
Configuration des agents
Les agents Codex de l’application héritent de la même configuration que l’extension IDE et la
CLI. Utilisez les commandes intégrées à l’application pour les paramètres courants, ou modifiez config.toml pour
accéder aux options avancées. Consultez Approbations des agents et sécurité
et Principes de base de la configuration pour en savoir plus.
Git
Utilisez les paramètres Git pour uniformiser la dénomination des branches et choisir si Codex utilise des poussées forcées. Vous pouvez également définir les prompts que Codex utilise pour générer les messages de commit et les descriptions de pull request.
Intégrations et MCP
Connectez des outils externes via Model Context Protocol (MCP). Activez les
serveurs recommandés ou ajoutez les vôtres. Si un serveur nécessite OAuth, l’application lance le
flux d’authentification. Ces paramètres s’appliquent également à la Codex CLI et à l’extension
IDE, car la configuration MCP se trouve dans config.toml. Consultez
Model Context Protocol pour en savoir plus.
Mode développeur du navigateur
Sous Mode développeur, activez Activer l’accès CDP complet pour permettre à ChatGPT d’utiliser le Chrome DevTools Protocol à des fins de profilage des performances et de débogage plus approfondi du navigateur. Si votre organisation a désactivé l’accès CDP complet, vous ne pouvez pas l’activer localement. Consultez Mode développeur pour connaître les exigences de configuration, de gestion des risques, d’approbation et d’administration.
Codex CLI lit vos paramètres personnels par défaut dans ~/.codex/config.toml. Ajoutez un fichier
.codex/config.toml à un projet ou sous-dossier approuvé lorsque vous avez besoin de
remplacements propres au projet. La CLI et l’extension IDE partagent ces couches de
configuration.
Examinez vos paramètres
Utilisez ces commandes pour connaître les paramètres effectifs de la session en cours :
- Exécutez
/statuspour afficher le modèle actif, la politique d’approbation, les racines accessibles en écriture et l’utilisation des jetons. - Exécutez
/debug-configpour afficher les couches de configuration par ordre de priorité ainsi que la source des exigences de la politique gérée. - Démarrez Codex avec
--strict-configpour traiter les clésconfig.tomlnon reconnues comme des erreurs au lieu de les ignorer.
Consultez la Référence des commandes pour développeurs pour obtenir la liste complète des commandes interactives.
Modifiez les paramètres pour une seule exécution
Utilisez une option dédiée lorsqu’elle existe. Parmi les exemples courants figurent --model,
--sandbox, --ask-for-approval, --profile et --search. Utilisez -c ou
--config pour remplacer la valeur de toute clé de configuration prise en charge pour une seule exécution.
Le changement de modèle ci-dessous nécessite un accès à GPT-6.1 Sol. Si ce modèle n’est pas disponible pour
votre compte ou votre espace de travail, omettez --model ou choisissez un modèle proposé par /model.
Consultez Disponibilité de GPT-6.1 Sol selon l’offre.
codex --model gpt-6.1-sol
codex --profile deep-review
codex --config model_reasoning_effort='"medium"'Les options de ligne de commande et les valeurs de --config ont la priorité la plus élevée. Pour obtenir la
liste complète des options, consultez la Référence des commandes pour développeurs.
Couches de configuration
La CLI applique les options de ligne de commande et les remplacements --config avant les paramètres du projet,
du profil, de l’utilisateur, du système et les paramètres intégrés. Utilisez cet ordre de priorité pour conserver les valeurs
par défaut partagées dans les fichiers de configuration et les modifications ponctuelles sur la ligne de commande.
Pour connaître l’ordre complet et les options courantes, consultez les Principes de base de la configuration.
Modifiez les paramètres dans la TUI
L’interface interactive du terminal propose des sélecteurs pour les paramètres courants de session et d’affichage :
| Objectif | Commande | Configuration associée |
|---|---|---|
| Choisir un mode de terminal | /tui |
tui.fullscreen_transcript (redémarrage requis) |
| Choisir un modèle | /model |
model, model_reasoning_effort |
| Modifier les autorisations | /permissions |
Paramètres d’approbation et de sandbox |
| Configurer les outils facultatifs | /experimental, /memories |
Clés config.toml propres à chaque fonctionnalité |
| Personnaliser l’interface du terminal | /keymap, /statusline, /title, /theme |
Clés sous [tui] |
| Définir les paramètres d’édition par défaut | /vim, /raw |
tui.vim_mode_default, tui.raw_output_mode |
Certaines commandes ne s’appliquent qu’à la session en cours, tandis que certains sélecteurs proposent d’enregistrer le choix. Définissez la clé de configuration associée lorsque vous souhaitez appliquer une valeur par défaut aux sessions futures. Pour les workflows liés au thème du terminal, à l’éditeur, à la saisie semi-automatique et aux raccourcis, consultez la section Personnalisation de la CLI.
Documentation de référence des paramètres
- La Configuration avancée couvre les profils, les remplacements ponctuels et d’autres workflows avancés.
- La Référence de configuration répertorie les clés et valeurs disponibles.
- L’Exemple de configuration fournit un exemple de fichier complet.
- La page Variables d’environnement documente les variables utilisées par la CLI et le programme d’installation.
L’extension Codex pour IDE comporte deux couches de paramètres :
- Les paramètres Codex contrôlent le comportement de l’agent partagé avec Codex CLI, notamment le
modèle, l’effort de raisonnement, les autorisations, le bac à sable, les MCP servers et la
personnalisation. Codex lit ces paramètres dans
config.toml. - Les paramètres de l’éditeur contrôlent le comportement de l’extension dans VS Code et les
éditeurs compatibles. Ces paramètres utilisent des clés
chatgpt.*dans le système de paramètres de l’éditeur.
Ouvrez les paramètres de Codex
Sélectionnez l’icône d’engrenage dans la barre latérale Codex, puis Paramètres Codex. Utilisez le panneau des paramètres pour les contrôles courants de l’agent, ou sélectionnez Ouvrir config.toml pour modifier directement la couche de configuration active.
Pour connaître l’ordre des couches de configuration et les clés courantes, consultez les Principes de base de la
configuration. Pour toutes les clés config.toml prises en charge, consultez la
Référence de configuration.
Modifiez un paramètre de l’éditeur
Pour modifier un paramètre, procédez comme suit :
- Ouvrez les paramètres de votre éditeur.
- Recherchez
@ext:openai.chatgpt,Codexou le nom du paramètre. - Modifiez la valeur.
L’extension respecte également les paramètres de police de conversation intégrés à VS Code pour les surfaces de conversation Codex.
Référence des paramètres de l’éditeur
| Paramètre | Valeur par défaut | Description |
|---|---|---|
chatgpt.commentCodeLensEnabled |
true |
Affiche CodeLens au-dessus des commentaires TODO afin que Codex puisse les traiter. |
chatgpt.openOnStartup |
false |
Place le focus sur la barre latérale de Codex une fois le démarrage de l’extension terminé. |
chatgpt.followUpQueueMode |
queue |
Choisissez si les messages envoyés pendant une exécution attendent la suivante (queue) ou orientent l’exécution en cours (steer). L’extension interprète l’ancienne valeur interrupt comme steer. Appuyez sur Cmd/Ctrl+Maj+Entrée pour inverser ce comportement pour un message. |
chatgpt.composerEnterBehavior |
enter |
Choisissez si Entrée envoie toujours le message (enter), si Cmd/Ctrl+Entrée envoie les invites multilignes (cmdIfMultiline), ou si la touche de modification est toujours requise (cmdAlways). |
chatgpt.reviewDelivery |
inline |
Exécute /review dans la conversation actuelle lorsque cela est possible (inline), ou démarre une conversation de revue distincte (detached). |
chatgpt.localeOverride |
Auto | Définit la langue préférée de l’interface de Codex. Laissez ce champ vide pour qu’elle soit détectée automatiquement. |
chatgpt.runCodexInWindowsSubsystemForLinux |
false |
Windows uniquement : exécute Codex dans WSL lorsque WSL est disponible. Utilisez cette option si vos dépôts et outils se trouvent dans WSL2 ou si vous avez besoin d’outils natifs Linux. La modification de ce paramètre recharge VS Code. |
chatgpt.cliExecutable |
Non défini | Développement uniquement : définit le chemin de l’exécutable Codex CLI. Ce paramètre n’est utile que si vous développez Codex CLI ; le remplacement manuel de l’exécutable fourni peut empêcher certaines parties de l’extension de fonctionner. |
chat.fontSize |
Valeur par défaut de l’éditeur | Contrôle le texte des conversations dans la barre latérale de Codex, notamment leur contenu et la zone de rédaction. |
chat.editor.fontSize |
Valeur par défaut de l’éditeur | Contrôle le contenu affiché sous forme de code dans les conversations Codex, notamment les extraits de code et les diffs. |
Les clés chatgpt.* ci-dessus appartiennent à l’extension IDE et ne doivent pas figurer dans
config.toml. Pour les paramètres partagés de l’agent, consultez les principes de base de la
configuration, la configuration avancée
et la référence de configuration.