For the complete documentation index, see llms.txt. Markdown versions of documentation pages are available by appending .md to the page URL.
Navigation principale

Suggestions

Personnalisation

Fichier de configuration

Configuration des agents

Étendez les capacités de ChatGPT et de Codex

Linux

Windows

API Dashboard
Essayer ChatGPT

Référence de configuration

Référence complète des fichiers config.toml et requirements.toml de Codex

Utilisez cette page comme référence pour rechercher des informations sur les fichiers de configuration de Codex. Pour comprendre les concepts et consulter des exemples, commencez par les pages Principes de configuration et Configuration avancée.

config.toml

La configuration utilisateur se trouve dans ~/.codex/config.toml. Vous pouvez également redéfinir certains paramètres pour un projet dans des fichiers .codex/config.toml. Codex ne charge les fichiers de configuration propres au projet que si vous faites confiance au projet.

La configuration propre au projet ne peut pas remplacer les clés locales à la machine relatives au fournisseur, à l’authentification, aux métadonnées de requêtes d’applications gérées par l’hôte, aux notifications, à la sélection du profil de configuration ou au routage de la télémétrie. Codex ignore openai_base_url, chatgpt_base_url, apps_mcp_product_sku, model_provider, model_providers, notify, profile, profiles, experimental_realtime_ws_base_url et otel lorsqu’elles figurent dans un fichier .codex/config.toml propre au projet ; définissez plutôt les clés de fournisseur, de notification et de télémétrie dans la configuration utilisateur. Les fichiers de profil de configuration se trouvent à côté de config.toml sous la forme $CODEX_HOME/profile-name.config.toml ; sélectionnez-en un avec --profile profile-name.

Pour les clés relatives au bac à sable et aux approbations (approval_policy, sandbox_mode et sandbox_workspace_write.*), consultez également Bac à sable et approbations, Chemins protégés dans les racines accessibles en écriture et Accès réseau. Pour les profils d’autorisations en version bêta, consultez Autorisations.

Key
agents
Type / Values
table
Details
Paramètres multi-agents et déclarations de rôles personnalisés. Les noms de paramètres scalaires sont réservés et ne peuvent pas servir de noms de rôles personnalisés.
Key
agents.<name>.config_file
Type / Values
string (path)
Details
Chemin d’une couche de configuration TOML pour ce rôle ; les chemins relatifs sont résolus par rapport au fichier de configuration qui déclare le rôle.
Key
agents.<name>.description
Type / Values
string
Details
Consignes relatives au rôle présentées à Codex lorsqu’il choisit et lance ce type d’agent.
Key
agents.default_subagent_model
Type / Values
string
Details
Modèle par défaut des agents lancés. Un modèle spécifié explicitement au lancement est prioritaire.
Key
agents.default_subagent_reasoning_effort
Type / Values
string
Details
Effort de raisonnement par défaut des agents lancés. Un effort spécifié explicitement au lancement est prioritaire.
Key
agents.enabled
Type / Values
boolean
Details
Activez ou désactivez les outils multi-agents (valeur par défaut : true).
Key
agents.interrupt_message
Type / Values
boolean
Details
Enregistrez un message visible par le modèle lorsqu’un tour d’agent est interrompu (valeur par défaut : true).
Key
agents.max_concurrent_threads_per_session
Type / Values
number
Details
Nombre maximal de threads d’agents lancés pouvant être ouverts simultanément, sans compter le thread principal. Si ce paramètre n’est pas défini, Codex choisit la valeur par défaut.
Key
agents.max_threads
Type / Values
number
Details
Ancien alias de agents.max_concurrent_threads_per_session.
Key
allow_login_shell
Type / Values
boolean
Details
Autorisez les outils reposant sur un shell à utiliser la sémantique des shells de connexion. Valeur par défaut : true ; avec false, les requêtes login = true sont rejetées et, si login est omis, les shells utilisés par défaut ne sont pas des shells de connexion.
Key
analytics.enabled
Type / Values
boolean
Details
Activez ou désactivez la collecte de données analytiques pour cette machine ou ce profil. Si ce paramètre n’est pas défini, la valeur par défaut du client s’applique.
Key
approval_policy
Type / Values
untrusted | on-request | never | { granular = { sandbox_approval = bool, rules = bool, mcp_elicitations = bool, request_permissions = bool, skill_approval = bool } }
Details
Détermine quand Codex se met en pause pour demander une approbation avant d’exécuter des commandes. Vous pouvez également utiliser approval_policy = { granular = { ... } } pour autoriser l’affichage de certaines catégories de demandes ou les rejeter automatiquement, tout en gardant les autres demandes interactives. on-failure est obsolète ; utilisez on-request pour les exécutions interactives ou never pour les exécutions non interactives.
Key
approval_policy.granular.mcp_elicitations
Type / Values
boolean
Details
Lorsque la valeur est true, les demandes d’élicitation MCP peuvent s’afficher au lieu d’être rejetées automatiquement.
Key
approval_policy.granular.request_permissions
Type / Values
boolean
Details
Lorsque la valeur est true, les demandes de l’outil request_permissions peuvent s’afficher.
Key
approval_policy.granular.rules
Type / Values
boolean
Details
Lorsque la valeur est true, les demandes d’approbation déclenchées par les règles prompt d’execpolicy peuvent s’afficher.
Key
approval_policy.granular.sandbox_approval
Type / Values
boolean
Details
Lorsque la valeur est true, les demandes d’approbation liées à l’élévation des autorisations du bac à sable peuvent s’afficher.
Key
approval_policy.granular.skill_approval
Type / Values
boolean
Details
Lorsque la valeur est true, les demandes d’approbation des scripts de skill peuvent s’afficher.
Key
approvals_reviewer
Type / Values
user | auto_review
Details
Détermine qui examine les demandes d’approbation admissibles dans le cadre des stratégies on-request ou des stratégies d’approbation granulaires. Valeur par défaut : user ; auto_review utilise le sous-agent de révision. Ce paramètre ne modifie pas le fonctionnement du bac à sable et ne soumet pas à révision les actions qui y sont déjà autorisées.
Key
apps._default.approvals_reviewer
Type / Values
user | auto_review
Details
Responsable par défaut de l’examen des demandes d’approbation des outils d’application, sauf si une autre valeur est définie pour l’application. Si ce paramètre est omis, les applications héritent de la valeur approvals_reviewer de premier niveau.
Key
apps._default.default_tools_approval_mode
Type / Values
auto | prompt | writes | approve
Details
Comportement d’approbation par défaut des outils d’application en l’absence de valeurs de remplacement propres à l’application ou à l’outil.
Key
apps._default.destructive_enabled
Type / Values
boolean
Details
Règle d’autorisation ou de refus appliquée par défaut aux outils d’application avec destructive_hint = true.
Key
apps._default.enabled
Type / Values
boolean
Details
État d’activation par défaut de toutes les applications, sauf si une autre valeur est définie pour une application.
Key
apps._default.open_world_enabled
Type / Values
boolean
Details
Règle d’autorisation ou de refus appliquée par défaut aux outils d’application avec open_world_hint = true.
Key
apps.<id>.approvals_reviewer
Type / Values
user | auto_review
Details
Responsable de l’examen des demandes d’approbation des outils de cette application. Remplace apps._default.approvals_reviewer.
Key
apps.<id>.default_tools_approval_mode
Type / Values
auto | prompt | writes | approve
Details
Comportement d’approbation par défaut des outils de cette application, sauf si une autre valeur est définie pour un outil.
Key
apps.<id>.default_tools_enabled
Type / Values
boolean
Details
État d’activation par défaut des outils de cette application, sauf si une autre valeur est définie pour un outil.
Key
apps.<id>.destructive_enabled
Type / Values
boolean
Details
Autorisez ou bloquez les outils de cette application qui déclarent destructive_hint = true.
Key
apps.<id>.enabled
Type / Values
boolean
Details
Activez ou désactivez une application ou un connecteur spécifique selon son identifiant (valeur par défaut : true).
Key
apps.<id>.open_world_enabled
Type / Values
boolean
Details
Autorisez ou bloquez les outils de cette application qui déclarent open_world_hint = true.
Key
apps.<id>.tools.<tool>.approval_mode
Type / Values
auto | prompt | writes | approve
Details
Valeur de remplacement du comportement d’approbation d’un seul outil d’application.
Key
apps.<id>.tools.<tool>.enabled
Type / Values
boolean
Details
Valeur de remplacement de l’état d’activation d’un outil d’application donné (par exemple, repos/list).
Key
auto_review.policy
Type / Values
string
Details
Instructions locales en Markdown définissant les règles de révision automatique. Le paramètre géré guardian_policy_config est prioritaire. Les valeurs vides sont ignorées.
Key
background_terminal_max_timeout
Type / Values
number
Details
Durée maximale d’attente en millisecondes pour les appels à vide à write_stdin (interrogation du terminal en arrière-plan). Valeur par défaut : 300000 (5 minutes). Remplace l’ancienne clé background_terminal_timeout.
Key
chatgpt_base_url
Type / Values
string
Details
Remplacez l’URL de base utilisée lors du processus de connexion à ChatGPT.
Key
check_for_update_on_startup
Type / Values
boolean
Details
Recherchez les mises à jour de Codex au démarrage (utilisez la valeur false uniquement si les mises à jour sont gérées de manière centralisée).
Key
cli_auth_credentials_store
Type / Values
file | keyring | auto
Details
Contrôlez l’emplacement où la CLI stocke les identifiants mis en cache (fichier auth.json ou trousseau de clés du système d’exploitation).
Key
compact_prompt
Type / Values
string
Details
Prompt de remplacement pour le compactage de l’historique, défini directement dans la configuration.
Key
computer_use.windows.always_allowed_app_ids
Type / Values
array<string>
Details
Identifiants des applications Windows que la fonctionnalité Utilisation de l’ordinateur peut ouvrir sans demander d’approbation. Les applications absentes de cette liste nécessitent une approbation ; supprimez les entrées enregistrées dans les paramètres de la fonctionnalité Utilisation de l’ordinateur de l’application de bureau ChatGPT.
Key
default_permissions
Type / Values
string
Details
Nom du profil d’autorisations par défaut à appliquer aux appels d’outils exécutés dans le bac à sable. Les profils intégrés sont :read-only, :workspace et :danger-full-access ; les noms de profils personnalisés nécessitent des tables [permissions.<name>] correspondantes. Ne combinez pas ce paramètre avec sandbox_mode ou [sandbox_workspace_write].
Key
desktop.custom_file_handlers.<id>
Type / Values
table
Details
Au niveau utilisateur uniquement. Définit une cible Ouvrir dans supplémentaire pour l’application de bureau ChatGPT. Consultez Ajouter des gestionnaires de fichiers personnalisés pour obtenir des exemples et connaître les contraintes relatives aux identifiants des gestionnaires.
Key
desktop.custom_file_handlers.<id>.args
Type / Values
array<string>
Details
Arguments insérés entre la commande et le fichier fourni en entrée (par défaut : []).
Key
desktop.custom_file_handlers.<id>.command
Type / Values
string
Details
Chemin de l’exécutable ou nom de la commande à détecter et à lancer. Obligatoire.
Key
desktop.custom_file_handlers.<id>.icon
Type / Values
string
Details
Chemin d’une ressource intégrée, URL data:image/... encodée en Base64, URI de fichier ou chemin local absolu pour l’icône du gestionnaire. Obligatoire ; l’icône VS Code par défaut est utilisée si la source n’est pas prise en charge.
Key
desktop.custom_file_handlers.<id>.input
Type / Values
path | json_argument | json_stdin
Details
Méthode utilisée par l’application pour transmettre le fichier au gestionnaire (par défaut : path).
Key
desktop.custom_file_handlers.<id>.label
Type / Values
string
Details
Nom d’affichage indiqué dans les menus Ouvrir dans. Obligatoire.
Key
desktop.custom_file_handlers.<id>.supports_ssh
Type / Values
boolean
Details
Proposez le gestionnaire pour les fichiers situés dans des espaces de travail SSH (par défaut : false).
Key
developer_instructions
Type / Values
string
Details
Instructions de développeur supplémentaires injectées dans la session (facultatives).
Key
disable_paste_burst
Type / Values
boolean
Details
Désactivez la détection des collages en rafale dans la TUI.
Key
experimental_compact_prompt_file
Type / Values
string (path)
Details
Chargez le prompt de remplacement pour le compactage depuis un fichier (expérimental).
Key
experimental_use_unified_exec_tool
Type / Values
boolean
Details
Ancien nom permettant d’activer l’exécution unifiée ; privilégiez [features].unified_exec ou codex --enable unified_exec.
Key
features.apps
Type / Values
boolean
Details
Activez les intégrations d’applications (connecteurs) (fonctionnalité stable ; activée par défaut). Le trafic des applications et des connecteurs n’est pas soumis au proxy réseau des commandes exécutées dans le bac à sable ni à sa liste de domaines autorisés.
Key
features.code_mode.direct_only_tool_namespaces
Type / Values
array<string>
Details
Espaces de noms d’outils que le mode code peut utiliser uniquement au moyen d’appels directs à ces outils.
Key
features.code_mode.enabled
Type / Values
boolean
Details
Activez la configuration du mode code. Cette fonctionnalité est en cours de développement et désactivée par défaut.
Key
features.code_mode.excluded_tool_namespaces
Type / Values
array<string>
Details
Espaces de noms d’outils que le mode code exclut des consignes sur les outils imbriqués en mode code et ne rend pas accessibles à l’exécuteur.
Key
features.enable_request_compression
Type / Values
boolean
Details
Compressez avec zstd les corps des requêtes en streaming lorsque cette compression est prise en charge (fonctionnalité stable ; activée par défaut).
Key
features.fast_mode
Type / Values
boolean
Details
Activez dans la TUI la sélection d’une offre du catalogue de modèles, y compris les commandes de l’offre Rapide lorsque le modèle actif indique qu’il les prend en charge (fonctionnalité stable ; activée par défaut).
Key
features.goals
Type / Values
boolean
Details
Activez la persistance des objectifs et la poursuite automatique (fonctionnalité stable ; activée par défaut).
Key
features.hooks
Type / Values
boolean
Details
Activez les hooks de cycle de vie chargés depuis hooks.json ou configurés directement dans [hooks]. features.codex_hooks est un alias obsolète.
Key
features.memories
Type / Values
boolean
Details
Activez les Mémoires (désactivées par défaut).
Key
features.multi_agent
Type / Values
boolean
Details
Activez les outils de collaboration multi-agents (spawn_agent, send_input, resume_agent, wait_agent et close_agent) (stables ; activés par défaut).
Key
features.network_proxy
Type / Values
boolean | table
Details
Démarrez le proxy réseau des commandes exécutées dans le bac à sable (fonctionnalité expérimentale ; désactivée par défaut). Cette option est nécessaire pour appliquer les règles de domaine des profils d’autorisations, sauf si des exigences experimental_network activées et gérées par un administrateur démarrent le proxy. Utilisez une table pour définir des options de stratégie propres à cette fonctionnalité, telles que domains. Ce proxy ne filtre pas la recherche web, les applications, MCP ni les autres outils hébergés.
Key
features.network_proxy.allow_local_binding
Type / Values
boolean
Details
Autorisez un accès plus étendu aux réseaux locaux et privés. Valeur par défaut : false ; des règles d’autorisation ciblant exactement une adresse IP locale ou localhost peuvent néanmoins autoriser des cibles locales précises.
Key
features.network_proxy.allow_upstream_proxy
Type / Values
boolean
Details
Autorisez le chaînage avec un proxy en amont défini dans l’environnement. Valeur par défaut : true.
Key
features.network_proxy.dangerously_allow_all_unix_sockets
Type / Values
boolean
Details
Autorisez n’importe quelle destination de socket Unix au lieu de limiter l’accès à la liste d’autorisation. Valeur par défaut : false ; utilisez cette option uniquement dans des environnements strictement contrôlés.
Key
features.network_proxy.dangerously_allow_non_loopback_proxy
Type / Values
boolean
Details
Autorisez les adresses d’écoute autres que celles de la boucle locale. Valeur par défaut : false ; l’activation de cette option peut rendre les points d’écoute du proxy accessibles au-delà de localhost.
Key
features.network_proxy.domains
Type / Values
map<string, allow | deny>
Details
Stratégie relative aux domaines pour l’accès réseau dans le bac à sable. Par défaut, aucune valeur n’est définie ; aucune destination externe n’est donc autorisée tant que vous n’ajoutez pas de règles allow. La stratégie accepte les noms d’hôte exacts, *.example.com uniquement pour les sous-domaines, **.example.com pour le domaine racine et ses sous-domaines, ainsi que les règles d’autorisation globales * ; privilégiez les règles ciblées, car * ouvre largement l’accès sortant au réseau public. Ajoutez des règles deny pour bloquer certaines destinations ; en cas de conflit, deny l’emporte.
Key
features.network_proxy.enable_socks5
Type / Values
boolean
Details
Activez la prise en charge de SOCKS5. Valeur par défaut : true.
Key
features.network_proxy.enable_socks5_udp
Type / Values
boolean
Details
Autorisez UDP via SOCKS5. Valeur par défaut : true.
Key
features.network_proxy.enabled
Type / Values
boolean
Details
Démarrez le proxy réseau des commandes exécutées dans le bac à sable lorsque leur accès réseau est activé. Valeur par défaut : false ; les règles de domaine des profils d’autorisations ne sont pas appliquées lorsque le proxy est désactivé.
Key
features.network_proxy.proxy_url
Type / Values
string
Details
URL d’écoute HTTP pour l’accès réseau dans le bac à sable. Valeur par défaut : "http://127.0.0.1:3128".
Key
features.network_proxy.socks_url
Type / Values
string
Details
URL d’écoute SOCKS5. Valeur par défaut : "http://127.0.0.1:8081".
Key
features.network_proxy.unix_sockets
Type / Values
map<string, allow | deny>
Details
Stratégie relative aux sockets Unix pour l’accès réseau dans le bac à sable. Par défaut, aucune valeur n’est définie ; ajoutez des entrées allow pour les sockets autorisés.
Key
features.personality
Type / Values
boolean
Details
Activez les options de sélection de la personnalité (fonctionnalité stable ; activée par défaut).
Key
features.prevent_idle_sleep
Type / Values
boolean
Details
Empêchez la machine de se mettre en veille pendant l’exécution d’un tour (fonctionnalité expérimentale ; désactivée par défaut).
Key
features.remote_plugin
Type / Values
boolean
Details
Activez le catalogue distant de plugins (fonctionnalité stable ; activée par défaut).
Key
features.rollout_budget.enabled
Type / Values
boolean
Details
Activez le suivi du budget d’exécution. Cette fonctionnalité est en cours de développement et désactivée par défaut. Lorsqu’elle est activée, features.rollout_budget.limit_tokens est obligatoire.
Key
features.rollout_budget.limit_tokens
Type / Values
integer
Details
Limite strictement positive de tokens pour le suivi du budget d’exécution. Obligatoire lorsque le budget d’exécution est activé.
Key
features.rollout_budget.prefill_token_weight
Type / Values
number
Details
Multiplicateur fini, positif ou nul, appliqué aux tokens de préremplissage lors de la comptabilisation du budget d’exécution. Valeur par défaut : 1.0.
Key
features.rollout_budget.reminder_interval_tokens
Type / Values
integer
Details
Intervalle strictement positif, exprimé en tokens, entre les rappels du budget d’exécution. Par défaut, il correspond à 10 % de limit_tokens, avec un minimum de 1 token.
Key
features.rollout_budget.sampling_token_weight
Type / Values
number
Details
Multiplicateur fini, positif ou nul, appliqué aux tokens échantillonnés lors de la comptabilisation du budget d’exécution. Valeur par défaut : 1.0.
Key
features.shell_snapshot
Type / Values
boolean
Details
Enregistrez un instantané de l’environnement du shell pour accélérer les commandes répétées (stable ; activé par défaut).
Key
features.shell_tool
Type / Values
boolean
Details
Activez l’outil shell fourni par défaut pour exécuter des commandes (fonctionnalité stable ; activée par défaut).
Key
features.skill_mcp_dependency_install
Type / Values
boolean
Details
Autorisez Codex à proposer l’installation des dépendances MCP manquantes pour les Skills et à les installer (fonctionnalité stable ; activée par défaut).
Key
features.unified_exec
Type / Values
boolean
Details
Utilisez l’outil exec unifié reposant sur un PTY (stable ; activé par défaut, sauf sur Windows).
Key
features.web_search
Type / Values
boolean
Details
Ancienne option désormais obsolète ; préférez le paramètre de premier niveau web_search.
Key
features.web_search_cached
Type / Values
boolean
Details
Ancienne option désormais obsolète. Lorsque web_search n’est pas défini, true équivaut à web_search = "cached".
Key
features.web_search_request
Type / Values
boolean
Details
Ancienne option désormais obsolète. Lorsque web_search n’est pas défini, true équivaut à web_search = "live".
Key
feedback.enabled
Type / Values
boolean
Details
Activez l’envoi de commentaires via /feedback dans tous les clients locaux (valeur par défaut : true).
Key
file_opener
Type / Values
vscode | vscode-insiders | windsurf | cursor | none
Details
Schéma d’URI utilisé pour ouvrir les citations depuis la sortie de Codex (par défaut : vscode).
Key
forced_chatgpt_workspace_id
Type / Values
string (uuid)
Details
Limitez les connexions à ChatGPT à un identifiant d’espace de travail spécifique.
Key
forced_login_method
Type / Values
chatgpt | api
Details
Restreignez Codex à une méthode d’authentification spécifique.
Key
hide_agent_reasoning
Type / Values
boolean
Details
Masquez les événements de raisonnement dans la TUI comme dans la sortie de codex exec.
Key
history.max_bytes
Type / Values
number
Details
Si ce paramètre est défini, il plafonne la taille du fichier d’historique en octets en supprimant les entrées les plus anciennes.
Key
history.persistence
Type / Values
save-all | none
Details
Choisissez si Codex enregistre les transcriptions de session dans history.jsonl.
Key
hooks
Type / Values
table
Details
Hooks de cycle de vie configurés directement dans config.toml. Ils utilisent le même schéma d’événements que hooks.json ; consultez le guide Hooks pour voir des exemples et les événements pris en charge.
Key
hooks.<Event>
Type / Values
array<table>
Details
Groupes de critères de correspondance pour les événements de hook tels que PreToolUse, PermissionRequest, PostToolUse, PreCompact, PostCompact, SessionStart, SessionEnd, SubagentStart, SubagentStop, UserPromptSubmit ou Stop.
Key
hooks.<Event>[].hooks
Type / Values
array<table>
Details
Gestionnaires de hooks pour un groupe de critères de correspondance. Les hooks de commande et d’outil MCP sont pris en charge, tandis que les gestionnaires de hooks de prompt et d’agent sont analysés, mais ne sont pas exécutés.
Key
hooks.<Event>[].hooks[].additionalContextLimit
Type / Values
integer
Details
Seuil approximatif de tokens par gestionnaire au-delà duquel une valeur additionalContext trop volumineuse est enregistrée sur disque et un aperçu plus court est présenté au modèle. Valeur par défaut : 2500 ; 0 transmet directement le contexte complet au modèle. Consultez Sorties volumineuses des hooks.
Key
hooks.<Event>[].hooks[].async
Type / Values
boolean
Details
Exécutez un hook de commande en arrière-plan sans retarder l’opération qui le déclenche. Valeur par défaut : false ; SessionEnd s’exécute toujours de façon synchrone. Consultez Exécutez les hooks en arrière-plan.
Key
hooks.<Event>[].hooks[].commandWindows
Type / Values
string
Details
Commande de remplacement propre à Windows pour les hooks de commande. L’alias TOML command_windows est également accepté.
Key
instructions
Type / Values
string
Details
Réservé à un usage futur ; utilisez plutôt model_instructions_file ou AGENTS.md.
Key
log_dir
Type / Values
string (path)
Details
Répertoire dans lequel Codex écrit les fichiers journaux ; par défaut, $CODEX_HOME/log. Définir explicitement ce paramètre active également le journal TUI facultatif en texte brut codex-tui.log dans ce répertoire.
Key
mcp_oauth_callback_port
Type / Values
integer
Details
Port fixe global facultatif pour le serveur de rappel HTTP local utilisé lors de la connexion OAuth MCP. Le paramètre oauth.callback_port propre à un serveur est prioritaire. Si aucun de ces paramètres n’est défini, Codex se met à l’écoute sur un port éphémère choisi par le système d’exploitation.
Key
mcp_oauth_callback_url
Type / Values
string
Details
URL de base de rappel facultative pour la connexion OAuth MCP, par exemple une URL d’entrée d’une devbox. Les clients préenregistrés nouvellement ajoutés utilisent cette URL telle quelle lorsque le serveur d’autorisation prend en charge l’identification de l’émetteur ; les clients existants sans URL de rappel enregistrée y ajoutent un identifiant de rappel propre au serveur. En l’absence de prise en charge de l’identification de l’émetteur, tout serveur MCP préenregistré dont l’URL de rappel configurée ne contient pas l’identifiant requis utilise à la place cette URL en y ajoutant cet identifiant. Les ports indiqués dans les URL de rappel ne déterminent pas le port d’écoute.
Key
mcp_oauth_credentials_store
Type / Values
auto | file | keyring
Details
Emplacement de stockage privilégié pour les identifiants OAuth MCP.
Key
mcp_servers.<id>.args
Type / Values
array<string>
Details
Arguments transmis à la commande du serveur MCP stdio.
Key
mcp_servers.<id>.auth
Type / Values
oauth | chatgpt
Details
Méthode d’authentification de secours pour un serveur HTTP MCP, utilisée après les tokens bearer et les en-têtes d’autorisation configurés. oauth (par défaut) utilise les identifiants OAuth MCP enregistrés lorsqu’ils sont disponibles. chatgpt utilise la session ChatGPT actuelle pour l’origine officielle de confiance de ChatGPT, puis se rabat sur les identifiants OAuth enregistrés. Les deux modes permettent de se connecter sans authentification si aucune source ne fournit d’identifiants.
Key
mcp_servers.<id>.bearer_token_env_var
Type / Values
string
Details
Variable d’environnement qui fournit le token bearer d’un serveur HTTP MCP.
Key
mcp_servers.<id>.command
Type / Values
string
Details
Commande de lancement d’un serveur MCP stdio.
Key
mcp_servers.<id>.cwd
Type / Values
string
Details
Répertoire de travail du processus du serveur MCP stdio.
Key
mcp_servers.<id>.default_tools_approval_mode
Type / Values
auto | prompt | writes | approve
Details
Comportement d’approbation par défaut des outils MCP de ce serveur, sauf si un outil dispose d’un paramètre spécifique.
Key
mcp_servers.<id>.disabled_tools
Type / Values
array<string>
Details
Liste de refus appliquée après enabled_tools pour le serveur MCP.
Key
mcp_servers.<id>.enabled
Type / Values
boolean
Details
Désactivez un serveur MCP sans supprimer sa configuration.
Key
mcp_servers.<id>.enabled_tools
Type / Values
array<string>
Details
Liste d’autorisation des noms d’outils exposés par le serveur MCP.
Key
mcp_servers.<id>.env
Type / Values
map<string,string>
Details
Variables d’environnement transmises au serveur MCP stdio.
Key
mcp_servers.<id>.env_http_headers
Type / Values
map<string,string>
Details
En-têtes HTTP renseignés à partir de variables d’environnement pour un serveur HTTP MCP.
Key
mcp_servers.<id>.env_vars
Type / Values
array<string | { name = string, source = "local" | "remote" }>
Details
Variables d’environnement supplémentaires à ajouter à la liste d’autorisation d’un serveur MCP stdio. Les entrées sous forme de chaîne utilisent par défaut source = "local" ; utilisez source = "remote" uniquement avec un serveur stdio distant pris en charge par un exécuteur.
Key
mcp_servers.<id>.experimental_environment
Type / Values
local | remote
Details
Emplacement d’exécution expérimental d’un serveur MCP. remote démarre les serveurs stdio via un environnement d’exécution distant ; le placement distant des serveurs utilisant le transport streamable HTTP n’est pas implémenté.
Key
mcp_servers.<id>.http_headers
Type / Values
map<string,string>
Details
En-têtes HTTP statiques inclus dans chaque requête HTTP MCP.
Key
mcp_servers.<id>.oauth_resource
Type / Values
string
Details
Paramètre de ressource OAuth facultatif, défini par la RFC 8707, à inclure lors de la connexion MCP.
Key
mcp_servers.<id>.oauth.callback_port
Type / Values
integer
Details
Port d’écoute fixe pour le rappel OAuth de ce serveur MCP. Remplace mcp_oauth_callback_port. Pour un rappel direct sur l’interface de bouclage dont l’URL contient un port explicite, configurez le même port d’écoute.
Key
mcp_servers.<id>.oauth.callback_url
Type / Values
string
Details
URL de rappel OAuth propre au serveur. Les clients préenregistrés la réutilisent lorsque l’identification de l’émetteur est prise en charge ou que l’URL se termine déjà par l’identifiant de rappel propre au serveur. Sinon, Codex utilise l’URL de rappel globale ou par défaut en y ajoutant cet identifiant. Les clients sans identifiant préenregistré utilisent cette URL de rappel lors de leur enregistrement.
Key
mcp_servers.<id>.oauth.client_id
Type / Values
string
Details
Identifiant client OAuth préenregistré utilisé pour l’autorisation et l’échange de tokens avec ce serveur MCP.
Key
mcp_servers.<id>.required
Type / Values
boolean
Details
Lorsque la valeur est true, le démarrage ou la reprise échoue si ce serveur MCP activé ne parvient pas à s’initialiser.
Key
mcp_servers.<id>.scopes
Type / Values
array<string>
Details
Portées OAuth à demander lors de l’authentification auprès de ce serveur MCP.
Key
mcp_servers.<id>.startup_timeout_ms
Type / Values
number
Details
Alias de startup_timeout_sec exprimé en millisecondes.
Key
mcp_servers.<id>.startup_timeout_sec
Type / Values
number
Details
Redéfinissez le délai d’expiration par défaut de 10 s au démarrage d’un serveur MCP.
Key
mcp_servers.<id>.tool_timeout_sec
Type / Values
number
Details
Redéfinissez le délai d’expiration par défaut de 60 s applicable à chaque outil d’un serveur MCP.
Key
mcp_servers.<id>.tools.<tool>.approval_mode
Type / Values
auto | prompt | writes | approve
Details
Remplacement du comportement d’approbation pour un outil MCP spécifique de ce serveur.
Key
mcp_servers.<id>.url
Type / Values
string
Details
Point de terminaison d’un serveur MCP utilisant le transport streamable HTTP.
Key
memories.consolidation_model
Type / Values
string
Details
Modèle de remplacement facultatif pour la consolidation globale des mémoires.
Key
memories.disable_on_external_context
Type / Values
boolean
Details
Lorsque la valeur est true, les threads qui utilisent un contexte externe, notamment des appels d’outils MCP, la recherche web ou la recherche d’outils, sont exclus de la génération de mémoires. Valeur par défaut : false. Ancien alias : memories.no_memories_if_mcp_or_web_search.
Key
memories.extract_model
Type / Values
string
Details
Modèle de remplacement facultatif pour l’extraction des mémoires de chaque thread.
Key
memories.generate_memories
Type / Values
boolean
Details
Lorsque la valeur est false, les threads nouvellement créés ne sont pas conservés comme données d’entrée pour la génération de mémoires. Valeur par défaut : true.
Key
memories.max_raw_memories_for_consolidation
Type / Values
number
Details
Nombre maximal de mémoires brutes récentes conservées pour la consolidation globale. Valeur par défaut : 256 ; cette valeur est plafonnée à 4096.
Key
memories.max_rollout_age_days
Type / Values
number
Details
Âge maximal des threads pris en compte pour la génération de mémoires. Valeur par défaut : 30 ; la valeur est limitée à la plage 0-90.
Key
memories.max_rollouts_per_startup
Type / Values
number
Details
Nombre maximal d’exécutions candidates traitées à chaque passe au démarrage. Valeur par défaut : 16 ; cette valeur est plafonnée à 128.
Key
memories.max_unused_days
Type / Values
number
Details
Nombre maximal de jours pouvant s’écouler depuis la dernière utilisation d’une mémoire avant qu’elle ne soit exclue de la consolidation. Valeur par défaut : 30 ; la valeur est limitée à la plage 0-365.
Key
memories.min_rate_limit_remaining_percent
Type / Values
number
Details
Pourcentage minimal devant rester disponible dans les fenêtres de limite de débit de Codex pour que la génération de mémoires puisse commencer. Valeur par défaut : 25 ; la valeur est limitée à la plage 0-100.
Key
memories.min_rollout_idle_hours
Type / Values
number
Details
Durée d’inactivité minimale avant qu’un thread ne soit pris en compte pour la génération de mémoires. Valeur par défaut : 6 ; la valeur est limitée à la plage 1-48.
Key
memories.use_memories
Type / Values
boolean
Details
Lorsque la valeur est false, Codex n’injecte pas les mémoires existantes dans les sessions futures. Valeur par défaut : true.
Key
model
Type / Values
string
Details
Modèle à utiliser (par exemple, gpt-5.5).
Key
model_auto_compact_token_limit
Type / Values
number
Details
Seuil de tokens qui déclenche le compactage automatique de l’historique (s’il n’est pas défini, les valeurs par défaut du modèle sont utilisées).
Key
model_auto_compact_token_limit_scope
Type / Values
total | body_after_prefix
Details
Détermine si le seuil de compactage automatique comptabilise tout le contexte actif (total, valeur par défaut) ou uniquement l’augmentation après le préfixe conservé de la fenêtre de compactage (body_after_prefix).
Key
model_catalog_json
Type / Values
string (path)
Details
Chemin facultatif vers un catalogue de modèles au format JSON chargé au démarrage. Le fichier de profil sélectionné $CODEX_HOME/profile-name.config.toml peut remplacer cette valeur pour le profil concerné.
Key
model_context_window
Type / Values
number
Details
Nombre de tokens disponibles dans la fenêtre de contexte du modèle actif.
Key
model_instructions_file
Type / Values
string (path)
Details
Instructions qui remplacent les instructions intégrées, à utiliser à la place de AGENTS.md.
Key
model_provider
Type / Values
string
Details
Identifiant du fournisseur défini dans model_providers (valeur par défaut : openai).
Key
model_providers.<id>
Type / Values
table
Details
Définition d’un fournisseur personnalisé. Les identifiants des fournisseurs intégrés (openai, ollama et lmstudio) sont réservés et ne peuvent pas être redéfinis.
Key
model_providers.<id>.auth
Type / Values
table
Details
Configuration d’un token bearer fourni par une commande pour un fournisseur personnalisé. Ne la combinez pas avec env_key, experimental_bearer_token ou requires_openai_auth.
Key
model_providers.<id>.auth.args
Type / Values
array<string>
Details
Arguments transmis à la commande de récupération du token.
Key
model_providers.<id>.auth.command
Type / Values
string
Details
Commande à exécuter lorsque Codex a besoin d’un token bearer. La commande doit écrire le token sur stdout.
Key
model_providers.<id>.auth.cwd
Type / Values
string (path)
Details
Répertoire de travail de la commande de récupération du token.
Key
model_providers.<id>.auth.refresh_interval_ms
Type / Values
number
Details
Intervalle entre les actualisations proactives du token par Codex, en millisecondes (valeur par défaut : 300000). Définissez cette valeur sur 0 pour n’actualiser le token qu’après une nouvelle tentative d’authentification.
Key
model_providers.<id>.auth.timeout_ms
Type / Values
number
Details
Durée d’exécution maximale de la commande de récupération du token, en millisecondes (valeur par défaut : 5000).
Key
model_providers.<id>.base_url
Type / Values
string
Details
URL de base de l’API du fournisseur de modèles.
Key
model_providers.<id>.env_http_headers
Type / Values
map<string,string>
Details
En-têtes HTTP renseignés à partir des variables d’environnement lorsqu’elles sont présentes.
Key
model_providers.<id>.env_key
Type / Values
string
Details
Variable d’environnement fournissant la clé API du fournisseur.
Key
model_providers.<id>.env_key_instructions
Type / Values
string
Details
Instructions facultatives pour configurer la clé API du fournisseur.
Key
model_providers.<id>.experimental_bearer_token
Type / Values
string
Details
Token bearer du fournisseur défini directement (déconseillé ; utilisez env_key).
Key
model_providers.<id>.http_headers
Type / Values
map<string,string>
Details
En-têtes HTTP statiques ajoutés aux requêtes envoyées au fournisseur.
Key
model_providers.<id>.name
Type / Values
string
Details
Nom d’affichage d’un fournisseur de modèles personnalisé.
Key
model_providers.<id>.query_params
Type / Values
map<string,string>
Details
Paramètres de requête supplémentaires ajoutés aux requêtes envoyées au fournisseur.
Key
model_providers.<id>.request_max_retries
Type / Values
number
Details
Nombre de nouvelles tentatives pour les requêtes HTTP envoyées au fournisseur (valeur par défaut : 4).
Key
model_providers.<id>.requires_openai_auth
Type / Values
boolean
Details
Le fournisseur utilise l’authentification OpenAI (valeur par défaut : false).
Key
model_providers.<id>.stream_idle_timeout_ms
Type / Values
number
Details
Délai maximal d’inactivité des flux SSE en millisecondes (valeur par défaut : 300000).
Key
model_providers.<id>.stream_max_retries
Type / Values
number
Details
Nombre de tentatives de reprise des flux SSE après une interruption (valeur par défaut : 5).
Key
model_providers.<id>.supports_standalone_web_search
Type / Values
boolean
Details
Déclarez la prise en charge d’un point de terminaison compatible pour la recherche web autonome (valeur par défaut : false). La recherche autonome reste en cours de développement et désactivée par défaut ; la compatibilité du fournisseur ne suffit pas à l’activer.
Key
model_providers.<id>.supports_websockets
Type / Values
boolean
Details
Indique si ce fournisseur prend en charge le transport WebSocket de la Responses API.
Key
model_providers.<id>.wire_api
Type / Values
responses
Details
Protocole utilisé par le fournisseur. responses est la seule valeur prise en charge et constitue la valeur par défaut lorsque ce paramètre est omis.
Key
model_providers.amazon-bedrock.aws.profile
Type / Values
string
Details
Nom du profil AWS utilisé par le fournisseur intégré amazon-bedrock.
Key
model_providers.amazon-bedrock.aws.region
Type / Values
string
Details
Région AWS utilisée par le fournisseur intégré amazon-bedrock.
Key
model_reasoning_effort
Type / Values
minimal | low | medium | high | xhigh
Details
Ajustez l’effort de raisonnement pour les modèles pris en charge (Responses API uniquement ; xhigh dépend du modèle).
Key
model_reasoning_summary
Type / Values
auto | concise | detailed | none
Details
Sélectionnez le niveau de détail du résumé du raisonnement ou désactivez entièrement les résumés.
Key
model_supports_reasoning_summaries
Type / Values
boolean
Details
Forcez Codex à envoyer ou non les métadonnées de raisonnement.
Key
model_verbosity
Type / Values
low | medium | high
Details
Valeur de remplacement facultative du niveau de verbosité de la Responses API pour GPT-5 ; si elle n’est pas définie, la valeur par défaut du modèle ou du préréglage sélectionné est utilisée.
Key
notice.hide_full_access_warning
Type / Values
boolean
Details
Enregistrez la confirmation du message d’avertissement relatif à l’accès complet.
Key
notice.hide_gpt-5.1-codex-max_migration_prompt
Type / Values
boolean
Details
Enregistrez la confirmation du message de migration vers gpt-5.1-codex-max.
Key
notice.hide_gpt5_1_migration_prompt
Type / Values
boolean
Details
Enregistrez la confirmation du message de migration vers GPT-5.1.
Key
notice.hide_rate_limit_model_nudge
Type / Values
boolean
Details
Enregistrez la désactivation du rappel de changement de modèle lié à la limite de débit.
Key
notice.hide_world_writable_warning
Type / Values
boolean
Details
Enregistrez la confirmation de l’avertissement concernant les répertoires accessibles en écriture à tous sous Windows.
Key
notice.model_migrations
Type / Values
map<string,string>
Details
Enregistrez les migrations de modèles confirmées sous forme de correspondances ancien->nouveau.
Key
notify
Type / Values
array<string>
Details
Commande exécutée pour les notifications ; elle reçoit une charge utile JSON de Codex.
Key
openai_base_url
Type / Values
string
Details
URL de base personnalisée pour le fournisseur de modèles openai intégré.
Key
oss_provider
Type / Values
lmstudio | ollama
Details
Fournisseur local par défaut utilisé lors de l’exécution avec --oss (s’il n’est pas défini, Codex vous demande de le choisir).
Key
otel.environment
Type / Values
string
Details
Étiquette d’environnement appliquée aux événements OpenTelemetry émis (par défaut : dev).
Key
otel.exporter
Type / Values
none | otlp-http | otlp-grpc
Details
Sélectionnez l’exportateur OpenTelemetry et fournissez les éventuelles métadonnées du point de terminaison.
Key
otel.exporter.<id>.endpoint
Type / Values
string
Details
Point de terminaison de l’exportateur pour les journaux OTEL.
Key
otel.exporter.<id>.headers
Type / Values
map<string,string>
Details
En-têtes statiques inclus dans les requêtes de l’exportateur OTEL.
Key
otel.exporter.<id>.protocol
Type / Values
binary | json
Details
Protocole utilisé par l’exportateur OTLP/HTTP.
Key
otel.exporter.<id>.tls.ca-certificate
Type / Values
string
Details
Chemin d’accès au certificat de l’autorité de certification (CA) pour la connexion TLS de l’exportateur OTEL.
Key
otel.exporter.<id>.tls.client-certificate
Type / Values
string
Details
Chemin d’accès au certificat client pour la connexion TLS de l’exportateur OTEL.
Key
otel.exporter.<id>.tls.client-private-key
Type / Values
string
Details
Chemin d’accès à la clé privée du client pour la connexion TLS de l’exportateur OTEL.
Key
otel.log_user_prompt
Type / Values
boolean
Details
Activez l’exportation des prompts utilisateur bruts avec les journaux OpenTelemetry.
Key
otel.metrics_exporter
Type / Values
none | statsig | otlp-http | otlp-grpc
Details
Sélectionnez l’exportateur de métriques OpenTelemetry (par défaut : statsig).
Key
otel.trace_exporter
Type / Values
none | otlp-http | otlp-grpc
Details
Sélectionnez l’exportateur de traces OpenTelemetry et fournissez les éventuelles métadonnées du point de terminaison.
Key
otel.trace_exporter.<id>.endpoint
Type / Values
string
Details
Point de terminaison de l’exportateur de traces pour les journaux OTEL.
Key
otel.trace_exporter.<id>.headers
Type / Values
map<string,string>
Details
En-têtes statiques inclus dans les requêtes de l’exportateur de traces OTEL.
Key
otel.trace_exporter.<id>.protocol
Type / Values
binary | json
Details
Protocole utilisé par l’exportateur de traces OTLP/HTTP.
Key
otel.trace_exporter.<id>.tls.ca-certificate
Type / Values
string
Details
Chemin d’accès au certificat de l’autorité de certification (CA) pour la connexion TLS de l’exportateur de traces OTEL.
Key
otel.trace_exporter.<id>.tls.client-certificate
Type / Values
string
Details
Chemin d’accès au certificat client pour la connexion TLS de l’exportateur de traces OTEL.
Key
otel.trace_exporter.<id>.tls.client-private-key
Type / Values
string
Details
Chemin d’accès à la clé privée du client pour la connexion TLS de l’exportateur de traces OTEL.
Key
permissions.<name>.description
Type / Values
string
Details
Description lisible par l’utilisateur de ce profil nommé. Un profil n’hérite pas de la description de son profil parent via extends.
Key
permissions.<name>.extends
Type / Values
string
Details
Profil parent facultatif appliqué avant ce profil nommé. Indiquez un autre profil nommé, :read-only ou :workspace ; :danger-full-access, les parents non définis et les cycles sont rejetés.
Key
permissions.<name>.filesystem
Type / Values
table
Details
Profil d’autorisations nommé pour le système de fichiers. Chaque clé est un chemin absolu ou un token spécial tel que :minimal ou :workspace_roots.
Key
permissions.<name>.filesystem.":workspace_roots".<subpath-or-glob>
Type / Values
"read" | "write" | "deny"
Details
Accès au système de fichiers dont la portée est définie par rapport à chaque racine effective de l’espace de travail. Utilisez "." pour la racine elle-même ; des sous-chemins avec motif glob tels que "**/*.env" peuvent interdire la lecture avec "deny".
Key
permissions.<name>.filesystem.<path-or-glob>
Type / Values
"read" | "write" | "deny" | table
Details
Accordez un accès direct à un chemin, à un motif glob ou à un token spécial, ou limitez la portée des entrées imbriquées à cette racine. Utilisez "deny" pour interdire la lecture des chemins correspondants.
Key
permissions.<name>.filesystem.glob_scan_max_depth
Type / Values
number
Details
Profondeur maximale d’expansion des motifs glob d’interdiction de lecture sur les plateformes qui prennent un instantané des correspondances avant le démarrage du bac à sable. Si elle est définie, elle doit être au moins égale à 1.
Key
permissions.<name>.network.allow_local_binding
Type / Values
boolean
Details
Autorisez, depuis le bac à sable, un accès plus étendu aux réseaux locaux ou privés. Même si cette option reste définie sur false, des règles d’autorisation visant une adresse IP locale littérale exacte ou localhost peuvent toujours autoriser des cibles locales précises.
Key
permissions.<name>.network.allow_upstream_proxy
Type / Values
boolean
Details
Autorisez le trafic réseau du bac à sable à passer par un autre proxy en amont.
Key
permissions.<name>.network.dangerously_allow_all_unix_sockets
Type / Values
boolean
Details
Autorisez des destinations de socket Unix arbitraires plutôt que l’ensemble restreint par défaut. Utilisez cette option uniquement dans des environnements étroitement contrôlés.
Key
permissions.<name>.network.dangerously_allow_non_loopback_proxy
Type / Values
boolean
Details
Autorisez les adresses de liaison autres que les adresses de bouclage pour les écouteurs réseau du bac à sable. L’activation de cette option peut rendre les écouteurs accessibles au-delà de localhost.
Key
permissions.<name>.network.domains
Type / Values
table
Details
Règles de domaine applicables aux commandes exécutées dans le bac à sable. Elles ne sont appliquées que lorsque features.network_proxy ou des exigences réseau actives gérées par un administrateur activent le proxy. Les hôtes exacts, *.example.com, **.example.com et les règles d’autorisation globales * sont pris en charge ; deny prévaut. Ces règles ne limitent ni la recherche web, ni les applications, ni les serveurs MCP.
Key
permissions.<name>.network.domains.<pattern>
Type / Values
allow | deny
Details
Autorisez ou refusez un hôte exact ou un motif générique à portée définie, tel que *.example.com ou **.example.com.
Key
permissions.<name>.network.enable_socks5
Type / Values
boolean
Details
Activez la prise en charge de SOCKS5 lorsque ce profil d’autorisations active l’accès réseau dans le bac à sable.
Key
permissions.<name>.network.enable_socks5_udp
Type / Values
boolean
Details
Autorisez le protocole UDP via l’écouteur SOCKS5 lorsque celui-ci est activé.
Key
permissions.<name>.network.enabled
Type / Values
boolean
Details
Activez l’accès réseau pour les commandes de ce profil d’autorisations. Cela ne démarre pas le proxy réseau. Si features.network_proxy n’est pas activé et qu’aucune exigence réseau gérée par un administrateur n’est activée, l’accès réseau des commandes est direct et les règles de domaine du profil ne sont pas appliquées.
Key
permissions.<name>.network.mode
Type / Values
limited | full
Details
Mode du proxy réseau utilisé pour le trafic des sous-processus.
Key
permissions.<name>.network.proxy_url
Type / Values
string
Details
URL d’écoute HTTP utilisée lorsque ce profil d’autorisations active l’accès réseau dans le bac à sable.
Key
permissions.<name>.network.socks_url
Type / Values
string
Details
Point de terminaison du proxy SOCKS5 utilisé par ce profil d’autorisations.
Key
permissions.<name>.network.unix_sockets
Type / Values
table
Details
Règles de remplacement de la liste d’autorisation des sockets Unix pour l’accès réseau dans le bac à sable. Utilisez les chemins de socket comme clés ; allow ajoute un chemin et deny le refuse.
Key
permissions.<name>.network.unix_sockets.<path>
Type / Values
allow | deny
Details
Ajoutez un chemin absolu de socket Unix à la liste d’autorisation effective avec allow, ou refusez-le avec deny. Les entrées refusées sont exclues de la liste d’autorisation effective.
Key
permissions.<name>.workspace_roots
Type / Values
table
Details
Racines d’espace de travail définies par le profil, auxquelles s’appliquent les règles de système de fichiers :workspace_roots, au même titre que les racines d’espace de travail de la session définies à l’exécution.
Key
permissions.<name>.workspace_roots.<path>
Type / Values
boolean
Details
Incluez un chemin dans l’ensemble des racines d’espace de travail du profil en définissant cette option sur true. Les entrées désactivées restent inactives.
Key
personality
Type / Values
none | friendly | pragmatic
Details
Style de communication par défaut des modèles qui déclarent la capacité supportsPersonality ; peut être redéfini pour chaque fil de discussion ou tour, ou via /personality.
Key
plan_mode_reasoning_effort
Type / Values
none | minimal | low | medium | high | xhigh
Details
Valeur de remplacement de l’effort de raisonnement propre au mode plan. En l’absence de valeur, le mode plan utilise la valeur par défaut de son préréglage intégré.
Key
plugins.<plugin>.mcp_servers.<server>.default_tools_approval_mode
Type / Values
auto | prompt | writes | approve
Details
Comportement d’approbation par défaut pour les outils d’un serveur MCP fourni par un plugin.
Key
plugins.<plugin>.mcp_servers.<server>.disabled_tools
Type / Values
array<string>
Details
Liste de refus appliquée après enabled_tools pour un serveur MCP fourni par un plugin.
Key
plugins.<plugin>.mcp_servers.<server>.enabled
Type / Values
boolean
Details
Activez ou désactivez un serveur MCP fourni avec un plugin installé sans modifier le manifeste du plugin.
Key
plugins.<plugin>.mcp_servers.<server>.enabled_tools
Type / Values
array<string>
Details
Liste d’autorisation des outils exposés par un serveur MCP fourni par un plugin.
Key
plugins.<plugin>.mcp_servers.<server>.tools.<tool>.approval_mode
Type / Values
auto | prompt | writes | approve
Details
Remplacement du comportement d’approbation pour un outil MCP donné fourni par un plugin.
Key
project_doc_fallback_filenames
Type / Values
array<string>
Details
Noms de fichiers supplémentaires à rechercher lorsque AGENTS.md est absent.
Key
project_doc_max_bytes
Type / Values
number
Details
Nombre maximal d’octets lus dans AGENTS.md lors de la préparation des instructions du projet.
Key
project_root_markers
Type / Values
array<string>
Details
Liste des noms de fichiers marquant la racine du projet, utilisée lors de la recherche de cette racine dans les répertoires parents.
Key
projects.<path>.trust_level
Type / Values
string
Details
Définissez un projet ou un arbre de travail comme fiable ou non fiable ("trusted" | "untrusted"). Les projets non fiables ignorent les couches .codex/ propres au projet, notamment la configuration, les hooks et les règles locales au projet.
Key
review_model
Type / Values
string
Details
Modèle de remplacement facultatif utilisé par /review (par défaut, le modèle de la session en cours).
Key
sandbox_mode
Type / Values
read-only | workspace-write | danger-full-access
Details
Stratégie du bac à sable pour l’accès au système de fichiers et au réseau lors de l’exécution des commandes.
Key
sandbox_workspace_write.exclude_slash_tmp
Type / Values
boolean
Details
Excluez /tmp des racines accessibles en écriture en mode workspace-write.
Key
sandbox_workspace_write.exclude_tmpdir_env_var
Type / Values
boolean
Details
Excluez $TMPDIR des racines accessibles en écriture en mode workspace-write.
Key
sandbox_workspace_write.network_access
Type / Values
boolean
Details
Autorisez l’accès réseau sortant dans le bac à sable workspace-write.
Key
sandbox_workspace_write.writable_roots
Type / Values
array<string>
Details
Racines supplémentaires accessibles en écriture lorsque sandbox_mode = "workspace-write".
Key
service_tier
Type / Values
string
Details
Offre privilégiée pour les nouveaux tours. Utilisez fast ou une autre offre déclarée par le modèle actif ; fast correspond à la valeur de requête priority.
Key
shell_environment_policy.exclude
Type / Values
array<string>
Details
Motifs d’exclusion des variables d’environnement au format historique. Pour les nouvelles configurations, utilisez shell_environment_policy.filters ; ne combinez pas les deux formes dans une même couche.
Key
shell_environment_policy.experimental_use_profile
Type / Values
boolean
Details
Utilisez le profil du shell de l’utilisateur lors du lancement de sous-processus.
Key
shell_environment_policy.filters
Type / Values
map<string, include | exclude>
Details
Filtres canoniques de variables d’environnement utilisant des motifs insensibles à la casse. Les entrées d’inclusion constituent une liste d’autorisation et ne peuvent pas rétablir les valeurs exclues. Les valeurs définies explicitement avec set s’appliquent après les exclusions. Ne combinez pas ces filtres avec les anciens tableaux exclude ou include_only dans une même couche.
Key
shell_environment_policy.ignore_default_excludes
Type / Values
boolean
Details
Conservez les variables dont le nom contient KEY, SECRET ou TOKEN avant l’application des autres filtres (valeur par défaut : true). Définissez cette option sur false pour appliquer les exclusions automatiques fondées sur les noms de variables associés à des secrets.
Key
shell_environment_policy.include_only
Type / Values
array<string>
Details
Liste d’autorisation historique fondée sur des motifs de noms de variables d’environnement. Pour les nouvelles configurations, utilisez shell_environment_policy.filters ; ne combinez pas les deux formes dans une même couche.
Key
shell_environment_policy.inherit
Type / Values
all | core | none
Details
Mode d’héritage de base de l’environnement lors du lancement de sous-processus.
Key
shell_environment_policy.set
Type / Values
map<string,string>
Details
Valeurs de variables d’environnement définies explicitement et injectées après les exclusions ; les filtres d’inclusion peuvent néanmoins les supprimer.
Key
show_raw_agent_reasoning
Type / Values
boolean
Details
Affichez le contenu brut du raisonnement lorsque le modèle actif en produit.
Key
skills.config
Type / Values
array<object>
Details
Valeurs de remplacement des paramètres d’activation de chaque skill, stockées dans config.toml.
Key
skills.config.<index>.enabled
Type / Values
boolean
Details
Activez ou désactivez le skill référencé.
Key
skills.config.<index>.path
Type / Values
string (path)
Details
Chemin vers un dossier de skill contenant SKILL.md.
Key
sqlite_home
Type / Values
string (path)
Details
Répertoire dans lequel Codex stocke la base de données d’état SQLite utilisée pour les tâches d’agents et les autres états d’exécution permettant une reprise.
Key
suppress_unstable_features_warning
Type / Values
boolean
Details
Masquez l’avertissement qui s’affiche lorsque des indicateurs de fonctionnalités en cours de développement sont activés.
Key
tool_output_token_limit
Type / Values
number
Details
Budget de tokens pour stocker les sorties de chaque outil ou fonction dans l’historique.
Key
tool_suggest.disabled_tools
Type / Values
array<table>
Details
Désactivez les suggestions pour certains connecteurs ou plugins détectables. Chaque entrée utilise type = "connector" ou "plugin", ainsi qu’un id.
Key
tool_suggest.discoverables
Type / Values
array<table>
Details
Autorisez les suggestions d’outils pour des connecteurs ou plugins supplémentaires détectables. Chaque entrée utilise type = "connector" ou "plugin", ainsi qu’un id.
Key
tools.view_image
Type / Values
boolean
Details
Activez l’outil view_image permettant de joindre des images locales.
Key
tools.web_search
Type / Values
boolean | { context_size = "low|medium|high", allowed_domains = [string], location = { country, region, city, timezone } }
Details
Configuration facultative de l’outil de recherche web. Le format objet permet de définir la taille du contexte de recherche, les domaines de recherche autorisés et la localisation approximative de l’utilisateur. Ces filtres de domaines de recherche sont distincts des règles de domaines réseau applicables aux commandes exécutées dans le bac à sable et ne limitent ni les connecteurs ni les serveurs MCP.
Key
tui
Type / Values
table
Details
Options propres à la TUI, comme l’activation des notifications de bureau intégrées.
Key
tui.alternate_screen
Type / Values
auto | always | never
Details
Contrôlez l’utilisation de l’écran alternatif par la TUI (par défaut : auto ; en mode auto, il n’est pas utilisé dans Zellij afin de préserver l’historique de défilement).
Key
tui.animations
Type / Values
boolean
Details
Activez les animations du terminal (écran d’accueil, effet de scintillement et indicateur de chargement rotatif) (par défaut : true).
Key
tui.keymap.<context>.<action>
Type / Values
string | array<string>
Details
Association d’un raccourci clavier à une action de la TUI. Les contextes pris en charge incluent global, chat, composer, editor, vim_normal, vim_operator, vim_text_object, pager, list et approval. Pour certaines actions de la zone de saisie, les associations correspondantes de tui.keymap.global s’appliquent à défaut ; lorsqu’elles sont prises en charge, les associations propres au contexte sont prioritaires.
Key
tui.keymap.<context>.<action> = []
Type / Values
empty array
Details
Supprimez le raccourci de cette action dans ce contexte de mappage clavier. Les noms de touches utilisent des chaînes normalisées comme ctrl-a, shift-enter, page-down ou minus.
Key
tui.model_availability_nux.<model>
Type / Values
integer
Details
État interne de l’info-bulle de démarrage, indexé par le slug du modèle.
Key
tui.notification_condition
Type / Values
unfocused | always
Details
Indiquez si les notifications de la TUI se déclenchent uniquement lorsque le terminal n’a pas le focus ou indépendamment du focus. Valeur par défaut : unfocused.
Key
tui.notification_method
Type / Values
auto | osc9 | bel
Details
Méthode utilisée pour les notifications du terminal (par défaut : auto).
Key
tui.notifications
Type / Values
boolean | array<string>
Details
Activez les notifications de la TUI et, si nécessaire, limitez-les à certains types d’événements.
Key
tui.raw_output_mode
Type / Values
boolean
Details
Démarrez la TUI en mode d’historique de défilement brut pour faciliter la sélection et la copie dans le terminal (par défaut : false). Vous pouvez activer ou désactiver ce mode avec /raw ou le raccourci clavier alt-r par défaut.
Key
tui.resume_cwd
Type / Values
current | session
Details
Répertoire de travail à utiliser lorsque vous reprenez ou forkez une session. S’il n’est pas défini, Codex vous demande de choisir un répertoire si votre répertoire actuel diffère du répertoire enregistré pour la session.
Key
tui.show_tooltips
Type / Values
boolean
Details
Affichez les info-bulles de prise en main sur l’écran d’accueil de la TUI (par défaut : true).
Key
tui.status_line
Type / Values
array<string> | null
Details
Liste ordonnée des identifiants des éléments de la ligne d’état au bas de la TUI. null désactive la ligne d’état.
Key
tui.terminal_title
Type / Values
array<string> | null
Details
Liste ordonnée des identifiants des éléments du titre de la fenêtre ou de l’onglet du terminal. Valeur par défaut : ["spinner", "project"] ; null désactive les mises à jour du titre.
Key
tui.theme
Type / Values
string
Details
Thème de coloration syntaxique à utiliser en remplacement (nom du thème en kebab-case).
Key
tui.vim_mode_default
Type / Values
boolean
Details
Démarrez la zone de saisie en mode normal de Vim plutôt qu’en mode insertion (par défaut : false). Vous pouvez toujours modifier ce réglage pour chaque session avec /vim.
Key
web_search
Type / Values
disabled | cached | indexed | live
Details
Mode de recherche web (par défaut : "cached" ; cached utilise un index géré par OpenAI sans accès externe au Web ; indexed n’autorise l’accès externe que si l’index de recherche le permet ; si vous utilisez --yolo ou un autre paramètre de bac à sable avec accès complet, la valeur par défaut est "live"). Utilisez "live" pour une récupération de contenu en direct sans restriction, ou "disabled" pour supprimer l’outil.
Key
windows_wsl_setup_acknowledged
Type / Values
boolean
Details
Enregistrez la confirmation de la prise en main sous Windows (Windows uniquement).
Key
windows.sandbox
Type / Values
unelevated | elevated
Details
Mode de bac à sable natif réservé à Windows lorsque Codex s’exécute nativement sur Windows.
Key
windows.sandbox_private_desktop
Type / Values
boolean
Details
Lors d’une exécution native sur Windows, exécutez par défaut le processus enfant final placé en bac à sable sur un bureau privé. Définissez false uniquement pour assurer la compatibilité avec l’ancien comportement Winsta0\\Default.

Le dernier schéma JSON de config.toml est disponible ici.

Pour bénéficier de l’autocomplétion et des diagnostics lors de la modification de config.toml dans VS Code ou Cursor, vous pouvez installer l’extension Even Better TOML et ajouter cette ligne au début de votre fichier config.toml :

#:schema https://developers.openai.com/codex/config-schema.json

Remarque : renommez experimental_instructions_file en model_instructions_file. Codex marque l’ancienne clé comme obsolète ; mettez à jour les configurations existantes afin d’utiliser le nouveau nom.

requirements.toml

requirements.toml est un fichier de configuration imposé par l’administrateur qui encadre les paramètres sensibles pour la sécurité, sans que les utilisateurs puissent déroger à ces contraintes. Consultez Exigences imposées par l’administrateur pour connaître les emplacements du fichier et obtenir des explications et des exemples.

Pour les utilisateurs de ChatGPT Business et ChatGPT Enterprise, Codex peut aussi appliquer des exigences récupérées depuis le cloud. Consultez la page sur la sécurité pour connaître les règles de priorité.

Utilisez [features] dans requirements.toml pour fixer les indicateurs de fonctionnalités de l’environnement d’exécution à l’aide des mêmes clés canoniques que dans config.toml. Les exigences peuvent aussi inclure des clés documentées propres à l’application et qui ne doivent pas figurer dans config.toml. Les clés omises restent sans contrainte.

Certaines exigences gérées imposent une valeur de configuration exacte plutôt qu’une liste d’autorisation. Les utilisateurs ne peuvent pas remplacer les valeurs imposées pour un chemin, une préférence de mise à jour, une politique de shell de connexion, un paramètre d’envoi de commentaires ou un paramètre de bureau privé sous Windows.

Les listes d’autorisation gérées pour les profils d’autorisations nécessitent Codex 0.138.0 ou une version ultérieure. Codex 0.137.0 et les versions antérieures ignorent allowed_permission_profiles et le paramètre géré default_permissions.

Utilisez allowed_sandbox_modes avec sandbox_mode. Pour les déploiements utilisant des profils d’autorisations, utilisez allowed_permission_profiles avec le paramètre géré default_permissions.

La table [models.new_thread] fournit des valeurs par défaut gérées, sans les imposer. Les choix explicites au lancement effectués avec des options CLI dédiées ou des valeurs de remplacement via --config sont prioritaires. Un remplacement explicite du modèle ou de l’effort de raisonnement empêche l’application des deux champs gérés relatifs au modèle ; service_tier est indépendant.

Key
allow_appshots
Type / Values
boolean
Details
Définissez cette option sur false pour désactiver Appshots pour les utilisateurs gérés. Si cette option est omise, les exigences ne restreignent pas Appshots et les règles normales de disponibilité du produit s’appliquent.
Key
allow_login_shell
Type / Values
boolean
Details
Imposez l’autorisation ou l’interdiction, pour les outils shell, de démarrer un shell de connexion.
Key
allow_managed_hooks_only
Type / Values
boolean
Details
Lorsque la valeur est true, Codex ignore les hooks utilisateur, de projet, de session et de plugin, tout en autorisant les hooks gérés provenant de requirements.toml et d’autres couches de configuration gérées.
Key
allow_remote_control
Type / Values
boolean
Details
Définissez cette option sur false pour désactiver le contrôle à distance des appareils pour les utilisateurs gérés. Si cette option est omise, les exigences ne restreignent pas le contrôle à distance des appareils, qui reste soumis aux règles normales de disponibilité du produit.
Key
allowed_approval_policies
Type / Values
array<string>
Details
Valeurs autorisées pour approval_policy (par exemple untrusted, on-request, never et granular).
Key
allowed_approvals_reviewers
Type / Values
array<string>
Details
Valeurs autorisées pour approvals_reviewer, telles que user et auto_review.
Key
allowed_permission_profiles
Type / Values
table<boolean>
Details
Liste complète des profils d’autorisations autorisés. Les profils définis sur true sont autorisés. Ceux qui sont omis ou définis sur false sont refusés, y compris les profils ajoutés dans de futures versions. Lorsque des sources d’exigences sont combinées, les entrées sont mises en correspondance d’après le nom du profil.
Key
allowed_permission_profiles.<name>
Type / Values
boolean
Details
Autorisez ou refusez un profil d’autorisations intégré ou personnalisé défini dans une configuration ou une source d’exigences chargée. Une source d’exigences ultérieure, de priorité supérieure, peut utiliser false pour désactiver un profil autorisé par une source antérieure de priorité inférieure.
Key
allowed_sandbox_modes
Type / Values
array<string>
Details
Valeurs autorisées pour sandbox_mode.
Key
allowed_web_search_modes
Type / Values
array<string>
Details
Valeurs autorisées pour web_search (disabled, cached, indexed, live). disabled est toujours autorisé ; une liste vide n’autorise donc que disabled.
Key
apps
Type / Values
table
Details
Exigences gérées pour les applications, indexées par identifiant d’application. Elles peuvent désactiver une application ou restreindre le comportement d’approbation d’outils spécifiques.
Key
apps.<id>.enabled
Type / Values
boolean
Details
Définissez cette option sur false pour désactiver une application. Une exigence de désactivation reste contraignante lorsque plusieurs sources d’exigences sont fusionnées.
Key
apps.<id>.tools.<tool>.approval_mode
Type / Values
auto | prompt | writes | approve
Details
Définissez le mode d’approbation géré pour un outil d’une application.
Key
check_for_update_on_startup
Type / Values
boolean
Details
Imposez l’activation ou la désactivation de la recherche de mises à jour au démarrage de Codex.
Key
computer_use
Type / Values
table
Details
Exigences imposées via requirements.toml pour la fonctionnalité Utilisation de l’ordinateur.
Key
computer_use.allow_locked_computer_use
Type / Values
boolean
Details
Définissez cette option sur false pour empêcher la fonctionnalité Utilisation de l’ordinateur de fonctionner après le verrouillage d’un appareil macOS géré. Si cette option est omise, les exigences ne restreignent pas son utilisation après verrouillage.
Key
default_permissions
Type / Values
string
Details
Profil d’autorisations par défaut géré par l’administrateur. Le profil doit être autorisé par allowed_permission_profiles. Définissez-le explicitement pour obtenir un comportement prévisible ; si ce paramètre est omis, Codex ne choisit :workspace par défaut que si :workspace et :read-only sont tous deux explicitement autorisés.
Key
enforce_residency
Type / Values
string
Details
Exigez que le trafic du service Codex respecte une option de résidence des données prise en charge. La valeur us est actuellement acceptée.
Key
experimental_network
Type / Values
table
Details
Exigences réseau gérées par l’administrateur pour les commandes locales exécutées dans un bac à sable, imposées via requirements.toml. Lorsqu’elles sont activées, ces exigences peuvent démarrer le proxy réseau des commandes sans features.network_proxy. Elles ne régissent pas la recherche web, les applications, les serveurs MCP, les navigateurs ni l’accès réseau de Codex Cloud.
Key
experimental_network.allow_local_binding
Type / Values
boolean
Details
Autorisez un accès plus étendu aux réseaux locaux ou privés depuis le bac à sable. Des règles d’autorisation portant sur une adresse IP locale exacte indiquée littéralement ou sur localhost peuvent néanmoins autoriser des destinations locales précises lorsque cette option reste définie sur false.
Key
experimental_network.allow_upstream_proxy
Type / Values
boolean
Details
Autorisez le trafic réseau du bac à sable à passer par un proxy amont défini dans l’environnement.
Key
experimental_network.allowed_domains
Type / Values
array<string>
Details
Règles d’autorisation définies par l’administrateur pour l’accès réseau des commandes exécutées dans le bac à sable lorsque le proxy réseau géré est activé. Ces règles ne s’appliquent pas à la recherche web, aux applications ni aux serveurs MCP. Ne combinez pas cette option avec experimental_network.domains.
Key
experimental_network.dangerously_allow_all_unix_sockets
Type / Values
boolean
Details
Autorisez des destinations de sockets Unix arbitraires au lieu de limiter l’accès à une liste d’autorisation. Utilisez cette option uniquement dans des environnements strictement contrôlés.
Key
experimental_network.dangerously_allow_non_loopback_proxy
Type / Values
boolean
Details
Autorisez les adresses d’écoute hors de l’interface de bouclage pour les exigences [experimental_network]. L’activation de cette option peut rendre les services d’écoute accessibles au-delà de localhost.
Key
experimental_network.denied_domains
Type / Values
array<string>
Details
Règles de refus définies par l’administrateur sous forme de liste pour l’accès réseau dans le bac à sable. Ne combinez pas cette option avec experimental_network.domains.
Key
experimental_network.domains
Type / Values
map<string, allow | deny>
Details
Politique de domaines définie par l’administrateur, sous forme de table, pour l’accès réseau dans le bac à sable. Accepte les hôtes exacts, *.example.com pour les sous-domaines uniquement, **.example.com pour le domaine racine et ses sous-domaines, ainsi que les règles globales d’autorisation * ; préférez des règles ciblées, car * ouvre largement l’accès sortant vers les réseaux publics. En cas de conflit, deny prévaut. Ne combinez pas cette option avec experimental_network.allowed_domains ou experimental_network.denied_domains.
Key
experimental_network.enabled
Type / Values
boolean
Details
Activez les exigences d’accès réseau dans le bac à sable. Cela n’accorde pas d’accès au réseau lorsque le bac à sable actif maintient l’accès réseau des commandes désactivé.
Key
experimental_network.http_port
Type / Values
integer
Details
Port d’écoute HTTP sur l’interface de bouclage à utiliser pour les exigences [experimental_network].
Key
experimental_network.managed_allowed_domains_only
Type / Values
boolean
Details
Lorsque la valeur est true, seules les règles d’autorisation gérées par l’administrateur restent en vigueur tant que les exigences d’accès réseau dans le bac à sable sont actives ; les ajouts des utilisateurs à la liste d’autorisation sont ignorés. En l’absence de règles d’autorisation gérées, les règles d’autorisation de domaines ajoutées par les utilisateurs ne restent pas en vigueur.
Key
experimental_network.socks_port
Type / Values
integer
Details
Port d’écoute SOCKS5 sur l’interface de bouclage à utiliser pour les exigences [experimental_network].
Key
experimental_network.unix_sockets
Type / Values
map<string, allow | deny>
Details
Politique de sockets Unix gérée par l’administrateur pour l’accès réseau dans le bac à sable.
Key
features
Type / Values
table
Details
Valeurs imposées aux fonctionnalités. Utilisez les noms canoniques de config.toml pour les fonctionnalités de l’environnement d’exécution ; les clés d’exigences documentées propres à l’application sont également prises en charge ici.
Key
features.<name>
Type / Values
boolean
Details
Exigez qu’une fonctionnalité documentée de l’environnement d’exécution ou de l’application reste activée ou désactivée.
Key
features.apps
Type / Values
boolean
Details
Imposez la disponibilité ou l’indisponibilité de l’intégration des Applications pour les utilisateurs gérés.
Key
features.browser_use
Type / Values
boolean
Details
Définissez cette option sur false dans requirements.toml pour désactiver la fonctionnalité Utilisation de l’ordinateur dans les navigateurs et rendre l’agent de navigation indisponible.
Key
features.browser_use_external
Type / Values
boolean
Details
Définissez cette option sur false dans requirements.toml pour désactiver la fonctionnalité Utilisation de l’ordinateur dans les navigateurs externes.
Key
features.browser_use_full_cdp_access
Type / Values
boolean
Details
Définissez cette option sur false dans requirements.toml pour désactiver l’accès complet à Chrome DevTools Protocol dans l’environnement d’exécution local, y compris le mode développeur du navigateur, et empêcher l’application de bureau ChatGPT d’activer le paramètre correspondant. Si cette option est omise, les règles normales de disponibilité du produit s’appliquent.
Key
features.computer_use
Type / Values
boolean
Details
Définissez cette option sur false dans requirements.toml pour désactiver les fonctionnalités Utilisation de l’ordinateur et Enregistrer et rejouer, ainsi que les parcours d’installation ou d’activation associés.
Key
features.fast_mode
Type / Values
boolean
Details
Imposez l’activation ou la désactivation de la fonctionnalité canonique fast_mode pour les utilisateurs gérés.
Key
features.guardian_approval
Type / Values
boolean
Details
Imposez la disponibilité ou l’indisponibilité de l’approbation Guardian pour les utilisateurs gérés.
Key
features.in_app_browser
Type / Values
boolean
Details
Définissez cette option sur false dans requirements.toml pour désactiver le volet du navigateur intégré.
Key
features.in_app_updates
Type / Values
boolean
Details
Définissez cette option sur false dans requirements.toml pour désactiver les mises à jour intégrées à l’application. Si cette exigence est omise, les mises à jour restent activées par défaut.
Key
features.memories
Type / Values
boolean
Details
Imposez la disponibilité ou l’indisponibilité des Mémoires pour les utilisateurs gérés.
Key
features.multi_agent
Type / Values
boolean
Details
Imposez la disponibilité ou l’indisponibilité de la fonctionnalité multi-agent pour les utilisateurs gérés.
Key
features.plugin_sharing
Type / Values
boolean
Details
Définissez cette option sur false dans le fichier requirements.toml géré dans le cloud pour désactiver le partage des plugins créés localement au sein de l’espace de travail.
Key
features.plugins
Type / Values
boolean
Details
Imposez la disponibilité ou l’indisponibilité des plugins pour les utilisateurs gérés.
Key
features.remote_plugin
Type / Values
boolean
Details
Imposez la disponibilité ou l’indisponibilité du catalogue distant de plugins pour les utilisateurs gérés.
Key
features.workspace_dependencies
Type / Values
boolean
Details
Imposez la disponibilité ou l’indisponibilité de l’environnement d’exécution intégré pour les dépendances de l’espace de travail pour les utilisateurs gérés.
Key
feedback
Type / Values
table
Details
Paramètres d’envoi de commentaires gérés par l’administrateur.
Key
feedback.enabled
Type / Values
boolean
Details
Imposez le choix d’autoriser ou non les utilisateurs à envoyer des commentaires depuis les différents clients Codex.
Key
guardian_policy_config
Type / Values
string
Details
Instructions gérées au format Markdown pour la politique de révision automatique. Elles prévalent sur la politique locale [auto_review].policy. Les valeurs vides sont ignorées.
Key
hooks
Type / Values
table
Details
Hooks de cycle de vie gérés et imposés par l’administrateur. Ils nécessitent un répertoire de hooks géré et utilisent le même schéma d’événements que les [hooks] définis directement dans config.toml.
Key
hooks.<Event>
Type / Values
array<table>
Details
Groupes de critères de correspondance pour un événement de hook comme PreToolUse, PermissionRequest, PostToolUse, PreCompact, PostCompact, SessionStart, SessionEnd, SubagentStart, SubagentStop, UserPromptSubmit ou Stop.
Key
hooks.<Event>[].hooks
Type / Values
array<table>
Details
Gestionnaires de hooks pour un groupe de critères de correspondance. Les hooks de commande et d’outil MCP sont pris en charge ; les gestionnaires de hooks de prompt et d’agent sont analysés, mais ne sont pas exécutés.
Key
hooks.<Event>[].hooks[].additionalContextLimit
Type / Values
integer
Details
Seuil approximatif de tokens par gestionnaire au-delà duquel le contenu additionalContext trop volumineux est enregistré sur disque et un aperçu plus court est présenté au modèle. Valeur par défaut : 2500 ; avec 0, le contexte complet est transmis directement au modèle. Consultez Sorties de hooks volumineuses.
Key
hooks.<Event>[].hooks[].async
Type / Values
boolean
Details
Exécutez un hook de commande en arrière-plan sans retarder l’opération qui le déclenche. Valeur par défaut : false ; SessionEnd s’exécute toujours de façon synchrone. Consultez Exécutez les hooks en arrière-plan.
Key
hooks.<Event>[].hooks[].commandWindows
Type / Values
string
Details
Commande de remplacement propre à Windows pour les hooks de commande. L’alias TOML command_windows est également accepté.
Key
hooks.managed_dir
Type / Values
string (absolute path)
Details
Répertoire contenant les scripts de hooks gérés sur macOS et Linux. Avant de charger les hooks gérés, Codex vérifie que le chemin du répertoire est absolu et que le répertoire existe.
Key
hooks.windows_managed_dir
Type / Values
string (absolute path)
Details
Répertoire contenant les scripts de hooks gérés sur Windows. Avant de charger les hooks gérés, Codex vérifie que le chemin du répertoire est absolu et que le répertoire existe.
Key
log_dir
Type / Values
string (path)
Details
Imposez le répertoire dans lequel Codex écrit les fichiers journaux locaux.
Key
marketplaces
Type / Values
table
Details
Exigences définies par l’administrateur pour les sources des Marketplace de plugins. Ces règles s’appliquent lorsque restrict_to_allowed_sources est défini sur true.
Key
marketplaces.allowed_sources
Type / Values
table
Details
Sources de Marketplace autorisées, indexées par le nom de règle choisi par l’administrateur. Les noms distincts se cumulent d’une couche d’exigences à l’autre ; les champs associés à un même nom suivent l’ordre de priorité habituel des couches.
Key
marketplaces.allowed_sources.<name>
Type / Values
table
Details
Règle définissant une source autorisée. Après la fusion des exigences, la valeur finale de source détermine les champs de même niveau que Codex interprète.
Key
marketplaces.allowed_sources.<name>.host_pattern
Type / Values
string
Details
Expression régulière requise lorsque source = "host_pattern". Codex l’applique au nom d’hôte en minuscules extrait d’une source Git HTTPS, SSH ou au format SCP. Utilisez ^ et $ pour exiger que la correspondance porte sur l’intégralité du nom d’hôte.
Key
marketplaces.allowed_sources.<name>.path
Type / Values
string (absolute path)
Details
Répertoire local de la Marketplace requis lorsque source = "local". Codex exige un chemin absolu et compare les chemins après normalisation.
Key
marketplaces.allowed_sources.<name>.ref
Type / Values
string
Details
Référence Git exacte facultative pour une règle git. Si elle est omise, la règle autorise toute référence pour le dépôt correspondant.
Key
marketplaces.allowed_sources.<name>.source
Type / Values
git | host_pattern | local
Details
Type de règle de correspondance pour une source de Marketplace. Utilisez git pour un dépôt, host_pattern pour des hôtes Git identifiés par une expression régulière, ou local pour un répertoire.
Key
marketplaces.allowed_sources.<name>.url
Type / Values
string
Details
URL du dépôt Git requise lorsque source = "git". Codex normalise l’URL configurée et l’URL autorisée avant d’exiger qu’elles désignent exactement le même dépôt.
Key
marketplaces.restrict_to_allowed_sources
Type / Values
boolean
Details
Lorsque la valeur est true, les sources de Marketplace configurées par l’utilisateur doivent correspondre à allowed_sources lors de l’ajout d’une Marketplace, de l’installation d’un plugin ou de l’actualisation d’une Marketplace Git configurée. Les Marketplace OpenAI gérées par Codex restent autorisées si elles utilisent la source et le nom qui leur sont réservés. Ce paramètre ne filtre pas à l’exécution les Marketplace déjà configurées par l’utilisateur.
Key
mcp_servers
Type / Values
table
Details
Liste d’autorisation des serveurs MCP qui peuvent être activés. L’activation d’un serveur MCP exige une correspondance à la fois sur son nom (<id>) et sur son identité. Tout serveur MCP configuré absent de cette liste, ou dont l’identité ne correspond pas, est désactivé.
Key
mcp_servers.<id>.identity
Type / Values
table
Details
Règle d’identité pour un seul serveur MCP. Définissez soit command (stdio), soit url (streamable HTTP).
Key
mcp_servers.<id>.identity.command
Type / Values
string | table
Details
Autorisez un serveur MCP stdio au moyen d’une chaîne de commande exacte, ou utilisez une table de critères de correspondance pour exiger un exécutable exact et des critères ordonnés pour les arguments. Lorsqu’une chaîne est utilisée, les arguments, cwd, env et env_vars ne sont pas examinés.
Key
mcp_servers.<id>.identity.command.args
Type / Values
array<table>
Details
Critères de correspondance ordonnés pour les arguments d’un serveur stdio. La liste d’arguments configurée doit avoir la même longueur, et l’argument à chaque position doit satisfaire le critère correspondant. Les critères de correspondance de la commande n’examinent pas cwd, env ni env_vars.
Key
mcp_servers.<id>.identity.command.args[].expression
Type / Values
string
Details
Expression régulière utilisée par un critère de correspondance d’argument regex. Elle doit être valide et correspondre à l’intégralité de la valeur de l’argument.
Key
mcp_servers.<id>.identity.command.args[].match
Type / Values
exact | prefix | regex
Details
Opération de correspondance pour l’argument à cette position.
Key
mcp_servers.<id>.identity.command.args[].value
Type / Values
string
Details
Valeur utilisée par un critère de correspondance d’argument exact ou prefix.
Key
mcp_servers.<id>.identity.command.executable
Type / Values
string
Details
Exécutable auquel la valeur command configurée pour le serveur stdio doit correspondre exactement.
Key
mcp_servers.<id>.identity.url
Type / Values
string | table
Details
Autorisez un serveur MCP streamable HTTP au moyen d’une chaîne d’URL exacte, ou utilisez une table de critères de correspondance de valeur exact, prefix ou regex.
Key
mcp_servers.<id>.identity.url.expression
Type / Values
string
Details
Expression régulière utilisée par un critère de correspondance d’URL regex. Elle doit être valide et correspondre à l’intégralité de la valeur de l’URL.
Key
mcp_servers.<id>.identity.url.match
Type / Values
exact | prefix | regex
Details
Opération de correspondance pour l’URL configurée du serveur MCP.
Key
mcp_servers.<id>.identity.url.value
Type / Values
string
Details
Valeur utilisée par un critère de correspondance d’URL exact ou prefix.
Key
model_catalog_json
Type / Values
string (path)
Details
Imposez le catalogue de modèles au format JSON que Codex utilise au démarrage.
Key
models
Type / Values
table
Details
Paramètres de modèle par défaut gérés pour les nouveaux fils de discussion. Ces valeurs prévalent sur les valeurs par défaut de l’utilisateur et du projet, mais une sélection explicite pour le nouveau fil de discussion peut les remplacer.
Key
models.new_thread
Type / Values
table
Details
Valeurs par défaut à appliquer au démarrage d’un nouveau fil de discussion local. Chaque paramètre de modèle est facultatif.
Key
models.new_thread.model
Type / Values
string
Details
Modèle par défaut pour les nouveaux fils de discussion. Une option --model explicite ou un remplacement du modèle ou du raisonnement via --config est prioritaire.
Key
models.new_thread.model_reasoning_effort
Type / Values
string
Details
Effort de raisonnement par défaut pour les nouveaux fils de discussion. Un remplacement explicite du modèle ou de l’effort de raisonnement empêche l’application des deux champs gérés relatifs au modèle.
Key
models.new_thread.service_tier
Type / Values
string
Details
Offre par défaut pour les nouveaux fils de discussion. Un remplacement explicite de l’offre est prioritaire, indépendamment des champs relatifs au modèle.
Key
permissions
Type / Values
table
Details
Profils d’autorisations définis par l’administrateur et indexés par nom de profil. Ils utilisent les mêmes champs de profil que config.toml.
Key
permissions.<name>
Type / Values
table
Details
Profil d’autorisations défini par l’administrateur. Son nom ne peut pas commencer par :, reprendre le nom réservé filesystem, ni être identique à celui d’un profil provenant d’une configuration chargée. Les champs du profil sont les mêmes que dans config.toml ; consultez le guide Autorisations pour obtenir le schéma complet du profil.
Key
permissions.filesystem.deny_read
Type / Values
array<string>
Details
Interdictions de lecture dans le système de fichiers imposées par l’administrateur. Les entrées peuvent être des chemins ou des motifs glob, et les utilisateurs ne peuvent pas assouplir ces restrictions au moyen d’une configuration locale.
Key
plugins
Type / Values
table
Details
Listes d’autorisation de serveurs MCP propres aux plugins, indexées par identifiant de plugin. Lorsque cette table est présente, les serveurs fournis avec des plugins sont désactivés si aucune entrée ne correspond à la fois au plugin et au serveur.
Key
plugins.<plugin>.mcp_servers
Type / Values
table
Details
Liste d’autorisation des serveurs MCP fournis avec un plugin. Les exigences relatives aux serveurs de plugins utilisent les mêmes formes d’identité exacte et de critères de correspondance que les exigences mcp_servers de niveau supérieur.
Key
plugins.<plugin>.mcp_servers.<server>.identity
Type / Values
table
Details
Règle d’identité pour un serveur MCP fourni avec un plugin. Définissez soit command (stdio), soit url (streamable HTTP).
Key
plugins.<plugin>.mcp_servers.<server>.identity.command
Type / Values
string | table
Details
Autorisez le serveur MCP stdio d’un plugin en indiquant la chaîne exacte de sa commande, ou utilisez une table de correspondance pour imposer un exécutable précis et des règles de correspondance ordonnées pour les arguments.
Key
plugins.<plugin>.mcp_servers.<server>.identity.command.args
Type / Values
array<table>
Details
Règles de correspondance ordonnées pour les arguments d’un serveur stdio fourni avec un plugin. La liste d’arguments configurée doit avoir la même longueur, et chaque argument doit satisfaire la règle à sa position.
Key
plugins.<plugin>.mcp_servers.<server>.identity.command.args[].expression
Type / Values
string
Details
Expression régulière utilisée par une règle de correspondance d’argument regex. L’expression doit correspondre à l’intégralité de la valeur de l’argument.
Key
plugins.<plugin>.mcp_servers.<server>.identity.command.args[].match
Type / Values
exact | prefix | regex
Details
Opération de correspondance pour l’argument à cette position.
Key
plugins.<plugin>.mcp_servers.<server>.identity.command.args[].value
Type / Values
string
Details
Valeur utilisée par une règle de correspondance d’argument exact ou prefix.
Key
plugins.<plugin>.mcp_servers.<server>.identity.command.executable
Type / Values
string
Details
Exécutable auquel la commande configurée du serveur stdio fourni avec le plugin doit correspondre exactement.
Key
plugins.<plugin>.mcp_servers.<server>.identity.url
Type / Values
string | table
Details
Autorisez le serveur MCP HTTP streamable d’un plugin en indiquant la chaîne exacte de son URL, ou utilisez une table définissant une règle de correspondance de valeur de type exact, prefix ou regex.
Key
plugins.<plugin>.mcp_servers.<server>.identity.url.expression
Type / Values
string
Details
Expression régulière utilisée par une règle de correspondance d’URL regex. L’expression doit correspondre à l’intégralité de la valeur de l’URL.
Key
plugins.<plugin>.mcp_servers.<server>.identity.url.match
Type / Values
exact | prefix | regex
Details
Opération de correspondance pour l’URL du serveur MCP fourni avec le plugin.
Key
plugins.<plugin>.mcp_servers.<server>.identity.url.value
Type / Values
string
Details
Valeur utilisée par une règle de correspondance d’URL exact ou prefix.
Key
remote_sandbox_config
Type / Values
array<table>
Details
Exigences de bac à sable propres à chaque hôte. La première entrée dont les motifs hostname_patterns correspondent au nom d’hôte résolu remplace la valeur allowed_sandbox_modes de niveau supérieur pour cette source d’exigences. Actuellement, les entrées propres à un hôte ne remplacent que les modes de bac à sable.
Key
remote_sandbox_config[].allowed_sandbox_modes
Type / Values
array<string>
Details
Modes de bac à sable autorisés à appliquer lorsque cette entrée propre à l’hôte correspond.
Key
remote_sandbox_config[].hostname_patterns
Type / Values
array<string>
Details
Motifs de noms d’hôte insensibles à la casse. Ils prennent en charge * pour une séquence quelconque de caractères et ? pour un seul caractère.
Key
rules
Type / Values
table
Details
Règles de commande imposées par l’administrateur et fusionnées avec les fichiers .rules. Les règles définies dans les exigences doivent être restrictives.
Key
rules.prefix_rules
Type / Values
array<table>
Details
Liste des règles de préfixe imposées. Chaque règle doit inclure pattern et decision.
Key
rules.prefix_rules[].decision
Type / Values
prompt | forbidden
Details
Obligatoire. Les règles définies dans les exigences peuvent uniquement demander l’approbation ou interdire (et non autoriser).
Key
rules.prefix_rules[].justification
Type / Values
string
Details
Justification facultative non vide, affichée dans les demandes d’approbation ou les messages de rejet.
Key
rules.prefix_rules[].pattern
Type / Values
array<table>
Details
Préfixe de commande exprimé sous forme d’un motif composé de tokens. Chaque token définit soit token, soit any_of.
Key
rules.prefix_rules[].pattern[].any_of
Type / Values
array<string>
Details
Liste des tokens alternatifs autorisés à cette position.
Key
rules.prefix_rules[].pattern[].token
Type / Values
string
Details
Un seul token littéral à cette position.
Key
sqlite_home
Type / Values
string (path)
Details
Imposez le répertoire où Codex stocke l’état d’exécution dans SQLite.
Key
windows
Type / Values
table
Details
Exigences concernant le bac à sable natif de Windows.
Key
windows.allowed_sandbox_implementations
Type / Values
array<string>
Details
Implémentations du bac à sable natif de Windows autorisées pour windows.sandbox (elevated et unelevated). La liste ne doit pas être vide. Lorsque les deux sont autorisées et qu’aucun mode n’est sélectionné, Codex privilégie elevated.
Key
windows.sandbox_private_desktop
Type / Values
boolean
Details
Imposez l’utilisation ou non d’un bureau privé pour lancer le processus enfant du bac à sable natif Windows.