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 redéfinir 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.*), complétez cette référence avec les sections Bac à sable et approbations, Chemins protégés dans les répertoires racines accessibles en écriture et Accès réseau. Pour les profils d’autorisations en bêta, consultez Autorisations.

Codex et ChatGPT Work ne prennent plus en charge approval_policy = "untrusted". Supprimez ce paramètre ou choisissez une politique prise en charge. Les entrées de projet avec trust_level = "untrusted" dans le fichier utilisateur ~/.codex/config.toml restent prises en charge. Consultez Migrez depuis l’ancienne politique d’approbation untrusted pour découvrir des exemples et les compromis liés aux approbations.

Key
agents
Type / Values
table
Details
Paramètres multi-agents et déclarations de rôles personnalisés. Les noms des 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 vers une couche de configuration TOML pour ce rôle ; les chemins relatifs sont résolus à partir du fichier de configuration qui déclare le rôle.
Key
agents.<name>.description
Type / Values
string
Details
Instructions sur le rôle présentées à Codex lorsqu’il choisit et crée un agent de ce type.
Key
agents.default_subagent_model
Type / Values
string
Details
Modèle par défaut des agents créés. Un modèle explicitement indiqué lors de la création a priorité.
Key
agents.default_subagent_reasoning_effort
Type / Values
string
Details
Effort de raisonnement par défaut des agents créés. Un effort explicitement indiqué lors de la création a priorité.
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 fils de discussion des agents créés pouvant être ouverts simultanément, à l’exclusion du fil 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 basés sur le shell à utiliser le comportement d’un shell de connexion. La valeur par défaut est true ; avec false, les demandes login = true sont rejetées et, si login est omis, les shells ne sont pas des shells de connexion.
Key
analytics.enabled
Type / Values
boolean
Details
Activez ou désactivez l’analyse d’utilisation 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
on-request | never | { granular = { sandbox_approval = bool, rules = bool, mcp_elicitations = bool, request_permissions = bool, skill_approval = bool } }
Details
Détermine quand Codex s’interrompt pour demander une approbation avant d’exécuter des commandes. Vous pouvez également utiliser approval_policy = { granular = { ... } } pour autoriser ou rejeter automatiquement certaines catégories de demandes tout en laissant les autres interactives. untrusted n’est pas pris en charge et 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
Avec la valeur 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
Avec la valeur true, les demandes de l’outil request_permissions peuvent s’afficher.
Key
approval_policy.granular.rules
Type / Values
boolean
Details
Avec la valeur 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
Avec la valeur true, les demandes d’approbation pour une élévation des autorisations du bac à sable peuvent s’afficher.
Key
approval_policy.granular.skill_approval
Type / Values
boolean
Details
Avec la valeur true, les demandes d’approbation des scripts de skills peuvent s’afficher.
Key
approvals_reviewer
Type / Values
user | auto_review
Details
Détermine qui examine les demandes d’approbation éligibles dans le cadre des politiques on-request ou granulaires. La valeur par défaut est user ; auto_review fait appel au sous-agent de révision. Ce paramètre ne modifie pas le 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 de la révision par défaut pour les demandes d’approbation des outils d’applications, sauf si un paramètre propre à une application le redéfinit. 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 pour les outils d’applications en l’absence de paramètres propres à l’application ou à l’outil.
Key
apps._default.destructive_enabled
Type / Values
boolean
Details
Autorisation ou interdiction par défaut pour les outils d’applications avec destructive_hint = true.
Key
apps._default.enabled
Type / Values
boolean
Details
État d’activation par défaut de toutes les applications, sauf si un paramètre propre à une application le redéfinit.
Key
apps._default.open_world_enabled
Type / Values
boolean
Details
Autorisation ou interdiction par défaut pour les outils d’applications avec open_world_hint = true.
Key
apps.<id>.approvals_reviewer
Type / Values
user | auto_review
Details
Responsable de la révision 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 un réglage propre à un outil le remplace.
Key
apps.<id>.default_tools_enabled
Type / Values
boolean
Details
État d’activation par défaut des outils de cette application, sauf si un réglage propre à un outil le remplace.
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 à l’aide de son identifiant (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
Réglage du comportement d’approbation propre à un outil de l’application.
Key
apps.<id>.tools.<tool>.enabled
Type / Values
boolean
Details
Réglage d’activation propre à un outil de l’application (par exemple repos/list).
Key
auto_review.policy
Type / Values
string
Details
Instructions de politique locales en Markdown pour la révision automatique. Le paramètre administré 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 d’interrogation write_stdin vides (interrogation du terminal en arrière-plan). Par défaut : 300000 (5 minutes). Remplace l’ancienne clé background_terminal_timeout.
Key
browser_use.allow_history_access
Type / Values
boolean
Details
Définissez ce paramètre sur false pour restreindre l’accès à l’historique du navigateur. Les exigences administrées peuvent imposer cette restriction.
Key
browser_use.default_origin_policy
Type / Values
table
Details
Restrictions par défaut pour les origines du navigateur. Les champs access, uploads, downloads et full_cdp_access sont pris en charge, chacun avec la valeur allow ou deny.
Key
browser_use.origins.<origin>
Type / Values
table
Details
Restrictions du navigateur par origine, avec les mêmes champs que browser_use.default_origin_policy. Incluez un schéma HTTP ou HTTPS et, éventuellement, un port ; omettez les chemins, les chaînes de requête et les fragments. Les valeurs locales ne peuvent pas assouplir les interdictions administrées.
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 (définissez ce paramètre sur 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 | ephemeral
Details
Définissez où la CLI stocke les identifiants mis en cache.
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.default_app_access
Type / Values
allow | deny
Details
Politique d’accès par défaut aux applications natives pour l’Utilisation de l’ordinateur. Des entrées propres à chaque application peuvent définir une politique ; la configuration locale ne peut pas assouplir les restrictions administrées.
Key
computer_use.macos.bundle_ids
Type / Values
map<string, allow | deny>
Details
Accès aux applications macOS natives, avec l’identifiant de bundle comme clé.
Key
computer_use.windows.always_allowed_app_ids
Type / Values
array<string>
Details
Identifiants des applications Windows que l’Utilisation de l’ordinateur peut ouvrir sans demander d’approbation. Les applications absentes de la liste nécessitent une approbation ; supprimez les entrées enregistrées dans les paramètres d’Utilisation de l’ordinateur de l’application de bureau ChatGPT.
Key
computer_use.windows.aumids
Type / Values
map<string, allow | deny>
Details
Accès aux applications Windows empaquetées, avec l’Application User Model ID (AUMID) comme clé.
Key
computer_use.windows.exes
Type / Values
array<table>
Details
Règles d’accès aux exécutables Windows. Chaque règle exige publisher_name, product_name et access (allow ou deny) ; binary_name est facultatif.
Key
default_permissions
Type / Values
string
Details
Nom du profil d’autorisations par défaut à appliquer aux appels d’outils exécutés en 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
Uniquement au niveau utilisateur. Définit une cible Ouvrir dans supplémentaire pour l’application de bureau ChatGPT. Consultez Ajouter des gestionnaires de fichiers personnalisés pour des exemples et 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 ; les sources non prises en charge utilisent l’icône VS Code par défaut.
Key
desktop.custom_file_handlers.<id>.input
Type / Values
path | json_argument | json_stdin
Details
Mode de transmission du fichier d’entrée par l’application au gestionnaire (par défaut : path).
Key
desktop.custom_file_handlers.<id>.label
Type / Values
string
Details
Nom affiché dans les menus Ouvrir dans. Obligatoire.
Key
desktop.custom_file_handlers.<id>.supports_ssh
Type / Values
boolean
Details
Proposez le gestionnaire pour les fichiers des espaces de travail SSH (par défaut : false).
Key
developer_instructions
Type / Values
string
Details
Instructions développeur supplémentaires injectées dans la session (facultatives).
Key
disable_paste_burst
Type / Values
boolean
Details
Désactivez la détection du collage en rafale dans la TUI.
Key
experimental_compact_prompt_file
Type / Values
string (path)
Details
Chargez le prompt de compactage de remplacement depuis un fichier (expérimental).
Key
experimental_use_unified_exec_tool
Type / Values
boolean
Details
Ancien nom du paramètre activant 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 contrôlé par le proxy réseau des commandes exécutées dans le bac à sable ni par 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 ne peut utiliser que par des appels d’outils directs.
Key
features.code_mode.enabled
Type / Values
boolean
Details
Activez la configuration de la fonctionnalité de 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 instructions sur les appels d’outils imbriqués en mode code et des outils accessibles à l’exécuteur.
Key
features.context_management.experimental_mode
Type / Values
boolean
Details
Activez la gestion expérimentale du contexte (désactivée par défaut). Au lieu de compresser à répétition le contexte en un seul résumé, elle utilise des notes et un historique consultable par recherche pour conserver les détails accumulés. Nécessite une connexion à ChatGPT avec un abonnement Plus, Pro ou Pro Lite.
Key
features.enable_request_compression
Type / Values
boolean
Details
Compressez les corps des requêtes en streaming avec zstd lorsque cette compression est prise en charge (stable ; activé par défaut).
Key
features.fast_mode
Type / Values
boolean
Details
Activez la sélection d’une offre du catalogue de modèles dans la TUI, y compris les commandes de l’offre Rapide lorsque le modèle actif les déclare disponibles (stable ; activé par défaut).
Key
features.goals
Type / Values
boolean
Details
Activez les objectifs persistants et la poursuite automatique (stable ; activé par défaut).
Key
features.hooks
Type / Values
boolean
Details
Activez les hooks de cycle de vie chargés depuis hooks.json ou depuis la configuration [hooks] intégrée. 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-agent (spawn_agent, send_input, resume_agent, wait_agent et close_agent) (stable ; activé par défaut).
Key
features.network_proxy
Type / Values
boolean | table
Details
Démarrez le proxy réseau pour les commandes exécutées dans le bac à sable (expérimental ; désactivé par défaut). Nécessaire pour appliquer les règles de domaine des profils de permissions, sauf si les exigences experimental_network activées et gérées par l’administrateur démarrent le proxy. Utilisez une table pour définir les options de politique propres à la fonctionnalité, telles que domains. 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 large au réseau local ou privé. Valeur par défaut : false ; des règles d’autorisation ciblant une adresse IP locale littérale exacte ou localhost peuvent toujours autoriser des destinations locales précises.
Key
features.network_proxy.allow_upstream_proxy
Type / Values
boolean
Details
Autorisez le chaînage via 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 hors boucle locale. Valeur par défaut : false ; l’activation de cette option peut exposer les points d’écoute du proxy au-delà de localhost.
Key
features.network_proxy.domains
Type / Values
map<string, allow | deny>
Details
Politique de domaine pour les accès réseau dans le bac à sable. Non définie par défaut : aucune destination externe n’est donc autorisée tant que vous n’ajoutez pas de règles allow. Prend en charge 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 d’autorisation globales * ; privilégiez les règles à portée limitée, car * ouvre largement les accès sortants au réseau public. Ajoutez des règles deny pour les destinations bloquées ; deny prévaut en cas de conflit.
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 l’accès réseau des commandes est activé. Valeur par défaut : false ; les règles de domaine des profils de permissions 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 les 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
Politique relative aux sockets Unix pour les accès réseau dans le bac à sable. Non définie par défaut ; ajoutez des entrées allow pour les sockets autorisés.
Key
features.personality
Type / Values
boolean
Details
Activez les commandes de sélection de la personnalité (stable ; activé par défaut).
Key
features.prevent_idle_sleep
Type / Values
boolean
Details
Empêchez la mise en veille de la machine pendant l’exécution d’un tour (expérimental ; désactivé par défaut).
Key
features.remote_plugin
Type / Values
boolean
Details
Activez le catalogue distant de plugins (stable ; activé 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, supérieur ou égal à zéro, appliqué aux tokens de préremplissage dans le calcul du budget d’exécution. La valeur par défaut est 1.0.
Key
features.rollout_budget.reminder_interval_tokens
Type / Values
integer
Details
Intervalle strictement positif, en tokens, entre les rappels du budget d’exécution. La valeur par défaut est de 10 % de limit_tokens, avec un minimum de 1 token.
Key
features.rollout_budget.sampling_token_weight
Type / Values
number
Details
Multiplicateur fini, supérieur ou égal à zéro, appliqué aux tokens échantillonnés dans le calcul du budget d’exécution. La valeur par défaut est 1.0.
Key
features.shell_snapshot
Type / Values
boolean
Details
Créez un instantané de l’environnement 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 par défaut pour exécuter des commandes (stable ; activé par défaut).
Key
features.skill_mcp_dependency_install
Type / Values
boolean
Details
Autorisez les demandes d’installation et l’installation des dépendances MCP manquantes pour les skills (stable ; activé par défaut).
Key
features.unified_exec
Type / Values
boolean
Details
Utilisez l’outil d’exécution unifié reposant sur un PTY (stable ; activé par défaut, sauf sur Windows).
Key
features.web_search
Type / Values
boolean
Details
Ancienne option d’activation obsolète ; privilégiez le paramètre web_search de premier niveau.
Key
features.web_search_cached
Type / Values
boolean
Details
Ancienne option d’activation obsolète. Lorsque web_search n’est pas défini, true correspond à web_search = "cached".
Key
features.web_search_request
Type / Values
boolean
Details
Ancienne option d’activation obsolète. Lorsque web_search n’est pas défini, true correspond à web_search = "live".
Key
feedback.enabled
Type / Values
boolean
Details
Activez l’envoi de commentaires via /feedback dans les clients locaux (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 présentes dans les réponses 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 précis.
Key
forced_login_method
Type / Values
chatgpt | api
Details
Limitez Codex à une méthode d’authentification précise.
Key
hide_agent_reasoning
Type / Values
boolean
Details
Masquez les événements de raisonnement dans la TUI et dans la sortie de codex exec.
Key
history.max_bytes
Type / Values
number
Details
Si ce paramètre est défini, il limite 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
Déterminez si Codex enregistre les transcriptions des sessions 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 des Hooks pour des exemples et la liste des événements pris en charge.
Key
hooks.<Event>
Type / Values
array<table>
Details
Groupes de critères de correspondance pour les événements de hooks tels que PreToolUse, PermissionRequest, PostToolUse, PreCompact, PostCompact, SessionStart, SessionEnd, SubagentStart, SubagentStop, UserPromptSubmit, Stop ou Interrupt.
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 un additionalContext trop volumineux est enregistré sur disque et un aperçu plus court est présenté au modèle. La valeur par défaut est 2500 ; 0 transmet directement l’intégralité du contexte 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. La valeur par défaut est false ; SessionEnd s’exécute toujours de manière synchrone. Consultez Exécutez les hooks en arrière-plan.
Key
hooks.<Event>[].hooks[].commandWindows
Type / Values
string
Details
Commande de remplacement réservée à 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 ; privilégiez model_instructions_file ou AGENTS.md.
Key
log_dir
Type / Values
string (path)
Details
Répertoire dans lequel Codex écrit les fichiers journaux ; la valeur par défaut est $CODEX_HOME/log. Définir explicitement ce paramètre active également le journal facultatif en texte brut de la TUI, codex-tui.log, dans ce répertoire.
Key
marketplaces.<name>.ref
Type / Values
string
Details
Branche, tag ou commit Git facultatif pour la marketplace.
Key
marketplaces.<name>.source
Type / Values
string
Details
Emplacement du dépôt Git ou répertoire racine de la marketplace locale. Utilisez un chemin absolu pour une source locale ; le répertoire contient .agents/plugins/marketplace.json.
Key
marketplaces.<name>.source_type
Type / Values
git | local
Details
Type de source d’une marketplace de plugins configurée. Les marketplaces peuvent être définies dans un fichier config.toml système, géré dans le cloud, utilisateur ou propre à un projet de confiance.
Key
marketplaces.<name>.sparse_paths
Type / Values
array<string>
Details
Chemins facultatifs d’extraction partielle (sparse checkout) pour une marketplace Git. Incluez le catalogue de la marketplace et tous les répertoires de plugins locaux qu’il référence.
Key
mcp_oauth_callback_port
Type / Values
integer
Details
Port fixe global facultatif pour le serveur HTTP local de rappel utilisé lors de la connexion OAuth MCP. Le paramètre oauth.callback_port propre à un serveur est prioritaire. Si aucun des deux n’est défini, Codex é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 de 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. Si l’identification de l’émetteur n’est pas prise en charge, tout serveur MCP préenregistré dont l’URL de rappel configurée ne contient pas l’identifiant requis utilise cette URL en y ajoutant l’identifiant. Les ports des URL de rappel ne déterminent pas le port d’écoute.
Key
mcp_oauth_credentials_store
Type / Values
auto | file | keyring
Details
Stockage privilégié pour les identifiants OAuth MCP.
Key
mcp_optional_startup_grace_ms
Type / Values
integer (milliseconds)
Details
Délai d’attente commun aux serveurs MCP facultatifs lors de la constitution du catalogue initial d’outils. La valeur par défaut est 1000. Définissez-le sur 0 pour utiliser à la place le délai startup_timeout_sec de chaque serveur.
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 MCP HTTP, après les tokens bearer et les en-têtes d’autorisation configurés. oauth (valeur par défaut) utilise les identifiants OAuth MCP enregistrés lorsqu’ils sont disponibles. chatgpt utilise la session ChatGPT actuelle pour l’origine officielle et de confiance de ChatGPT, puis se rabat sur les identifiants OAuth enregistrés. Les deux modes peuvent 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 fournissant le token bearer d’un serveur MCP HTTP.
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 réglage propre à un outil le remplace.
Key
mcp_servers.<id>.disabled_tools
Type / Values
array<string>
Details
Liste d’interdiction 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 des noms d’outils que le serveur MCP est autorisé à exposer.
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 MCP HTTP.
Key
mcp_servers.<id>.env_vars
Type / Values
array<string | { name = string, source = "local" | "remote" }>
Details
Variables d’environnement supplémentaires à autoriser pour un serveur MCP stdio. Les entrées sous forme de chaînes utilisent par défaut source = "local" ; utilisez source = "remote" uniquement avec un transport 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 ; l’exécution à distance des serveurs utilisant le transport HTTP en streaming n’est pas implémentée.
Key
mcp_servers.<id>.http_headers
Type / Values
map<string,string>
Details
En-têtes HTTP statiques inclus dans chaque requête MCP HTTP.
Key
mcp_servers.<id>.http_headers_helper
Type / Values
string (command)
Details
Commande locale qui affiche un objet JSON contenant les noms et les valeurs des en-têtes HTTP. Prise en charge uniquement pour les serveurs MCP HTTP connectés localement. Les tokens bearer explicites et les identifiants OAuth ont priorité sur les en-têtes Authorization fournis par l’utilitaire.
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 du rappel OAuth pour 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’ID de rappel propre au serveur. Sinon, Codex utilise l’URL de rappel globale ou par défaut, à laquelle il ajoute cet ID. Les clients sans ID préenregistré utilisent cette URL de rappel lors de leur enregistrement.
Key
mcp_servers.<id>.oauth.client_id
Type / Values
string
Details
ID 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 peut 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
Remplacez le délai d’attente de démarrage par défaut de 10 s d’un serveur MCP.
Key
mcp_servers.<id>.tool_timeout_sec
Type / Values
number
Details
Remplacez le délai d’attente par défaut de 60 s par outil d’un serveur MCP.
Key
mcp_servers.<id>.tools.<tool>.approval_mode
Type / Values
auto | prompt | writes | approve
Details
Réglage du comportement d’approbation propre à un outil MCP de ce serveur.
Key
mcp_servers.<id>.tools.<tool>.output_token_limit
Type / Values
integer (positive)
Details
Budget de tokens pour la sortie d’un outil MCP, avant la marge standard de 20 % pour la sérialisation. Remplace, pour cet outil, le budget de troncature des sorties défini par défaut par le modèle.
Key
mcp_servers.<id>.url
Type / Values
string
Details
Point de terminaison d’un serveur MCP utilisant le transport HTTP en streaming.
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 fils qui utilisent un contexte externe, comme 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 fil.
Key
memories.generate_memories
Type / Values
boolean
Details
Lorsque la valeur est false, les nouveaux fils de discussion ne sont pas enregistrés comme données d’entrée pour la génération de mémoires. La valeur par défaut est 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, plafonnée à 4096.
Key
memories.max_rollout_age_days
Type / Values
number
Details
Ancienneté maximale des fils pris en compte pour la génération de mémoires. Valeur par défaut : 30, bornée à l’intervalle 0-90.
Key
memories.max_rollouts_per_startup
Type / Values
number
Details
Nombre maximal de traces d’exécution candidates traitées par passe au démarrage. Valeur par défaut : 16, plafonnée à 128.
Key
memories.max_unused_days
Type / Values
number
Details
Nombre maximal de jours écoulés depuis la dernière utilisation d’une mémoire avant son exclusion de la consolidation. Valeur par défaut : 30, bornée à l’intervalle 0-365.
Key
memories.min_rate_limit_remaining_percent
Type / Values
number
Details
Pourcentage minimal restant requis dans les fenêtres de limite de débit de Codex avant le démarrage de la génération de mémoires. Valeur par défaut : 25, bornée à l’intervalle 0-100.
Key
memories.min_rollout_idle_hours
Type / Values
number
Details
Durée minimale d’inactivité avant qu’un fil soit pris en compte pour la génération de mémoires. Valeur par défaut : 6, bornée à l’intervalle 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.6-sol).
Key
model_auto_compact_token_limit
Type / Values
number
Details
Seuil de tokens déclenchant le compactage automatique de l’historique (si ce paramètre n’est pas défini, les valeurs par défaut du modèle s’appliquent).
Key
model_auto_compact_token_limit_scope
Type / Values
total | body_after_prefix
Details
Détermine si le seuil de compactage automatique prend en compte l’ensemble du contexte actif (total, la valeur par défaut) ou uniquement son accroissement 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 JSON chargé au démarrage. Le fichier de profil $CODEX_HOME/profile-name.config.toml sélectionné peut redéfinir ce chemin pour le profil concerné.
Key
model_context_window
Type / Values
number
Details
Nombre de tokens de la fenêtre de contexte disponibles pour le modèle actif.
Key
model_instructions_file
Type / Values
string (path)
Details
Remplacement des instructions intégrées, à utiliser plutôt que AGENTS.md.
Key
model_provider
Type / Values
string
Details
Identifiant du fournisseur défini dans model_providers (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 obtenu 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 d’obtention 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 d’obtention du token.
Key
model_providers.<id>.auth.refresh_interval_ms
Type / Values
number
Details
Intervalle auquel Codex actualise le token de manière proactive, en millisecondes (valeur par défaut : 300000). Définissez la valeur sur 0 pour ne l’actualiser qu’après une nouvelle tentative d’authentification.
Key
model_providers.<id>.auth.timeout_ms
Type / Values
number
Details
Durée maximale d’exécution de la commande d’obtention 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 de 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 renseigné 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 d’expiration pour inactivité des flux SSE, en millisecondes (valeur par défaut : 300000).
Key
model_providers.<id>.stream_max_retries
Type / Values
number
Details
Nombre de nouvelles tentatives en cas d’interruption du streaming SSE (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 de 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 l’API Responses.
Key
model_providers.<id>.wire_api
Type / Values
responses
Details
Protocole utilisé par le fournisseur. responses est la seule valeur prise en charge et s’applique par défaut si 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 compatibles (API Responses 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 des résumés de raisonnement ou désactivez-les complètement.
Key
model_supports_reasoning_summaries
Type / Values
boolean
Details
Forcez Codex à envoyer ou à ne pas envoyer les métadonnées de raisonnement.
Key
model_verbosity
Type / Values
low | medium | high
Details
Remplacement facultatif du niveau de détail des réponses de l’API Responses pour GPT-5 ; si ce paramètre n’est pas défini, 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 de lecture de l’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 le choix de désactiver le rappel de changement de modèle lié aux limites de débit.
Key
notice.hide_world_writable_warning
Type / Values
boolean
Details
Enregistrez la confirmation de lecture de l’avertissement relatif aux répertoires Windows accessibles en écriture à tous.
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 des données JSON de Codex.
Key
openai_base_url
Type / Values
string
Details
URL de base de remplacement pour le fournisseur de modèles intégré openai.
Key
oss_provider
Type / Values
lmstudio | ollama
Details
Fournisseur local utilisé par défaut lors d’une exécution avec --oss (si ce paramètre n’est pas défini, le choix est demandé à l’utilisateur).
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 du certificat d’autorité de certification pour les connexions TLS de l’exportateur OTEL.
Key
otel.exporter.<id>.tls.client-certificate
Type / Values
string
Details
Chemin du certificat client pour les connexions TLS de l’exportateur OTEL.
Key
otel.exporter.<id>.tls.client-private-key
Type / Values
string
Details
Chemin de la clé privée du client pour les connexions 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 du certificat d’autorité de certification pour les connexions TLS de l’exportateur de traces OTEL.
Key
otel.trace_exporter.<id>.tls.client-certificate
Type / Values
string
Details
Chemin du certificat client pour les connexions TLS de l’exportateur de traces OTEL.
Key
otel.trace_exporter.<id>.tls.client-private-key
Type / Values
string
Details
Chemin de la clé privée du client pour les connexions TLS de l’exportateur de traces OTEL.
Key
permissions.<name>.description
Type / Values
string
Details
Description lisible de ce profil nommé. Un profil n’hérite pas de la description de son parent via extends.
Key
permissions.<name>.extends
Type / Values
string
Details
Profil parent facultatif appliqué avant ce profil nommé. Choisissez un autre profil nommé, :read-only ou :workspace ; :danger-full-access, les parents non définis et les cycles sont refusés.
Key
permissions.<name>.filesystem
Type / Values
table
Details
Profil nommé d’autorisations du 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 défini relativement à chaque racine d’espace de travail effective. Utilisez "." pour la racine elle-même ; des sous-chemins 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 pour un chemin, un motif glob ou un token spécial, ou définissez la portée des entrées imbriquées sous 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 figent les correspondances avant le démarrage du bac à sable. La valeur doit être au moins égale à 1 lorsqu’elle est définie.
Key
permissions.<name>.network.allow_local_binding
Type / Values
boolean
Details
Autorisez un accès plus large aux réseaux locaux ou privés depuis le bac à sable. Des règles autorisant une adresse IP locale littérale exacte ou localhost peuvent toujours autoriser des cibles locales précises lorsque ce paramètre reste à false.
Key
permissions.<name>.network.allow_upstream_proxy
Type / Values
boolean
Details
Autorisez les connexions réseau en bac à sable à passer par un autre proxy en amont.
Key
permissions.<name>.network.dangerously_allow_all_unix_sockets
Type / Values
boolean
Details
Autorisez toutes les destinations de sockets Unix au lieu de l’ensemble restreint par défaut. Utilisez ce paramètre uniquement dans des environnements étroitement contrôlés.
Key
permissions.<name>.network.dangerously_allow_non_loopback_proxy
Type / Values
boolean
Details
Autorisez les services d’écoute réseau du bac à sable à se lier à des adresses autres que celles de bouclage. L’activation de ce paramètre peut les rendre accessibles au-delà de localhost.
Key
permissions.<name>.network.domains
Type / Values
table
Details
Règles de domaines pour les commandes exécutées en bac à sable. Elles ne sont appliquées que lorsque features.network_proxy ou des exigences réseau actives gérées par l’administrateur activent le proxy. Les hôtes exacts, *.example.com, **.example.com et les règles d’autorisation globales * sont pris en charge ; deny est prioritaire. Ces règles ne restreignent ni la recherche web, ni les applications, ni les serveurs MCP.
Key
permissions.<name>.network.domains.<pattern>
Type / Values
allow | deny
Details
Autorisez ou interdisez un hôte exact ou un motif à caractères génériques de portée limitée 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 en bac à sable.
Key
permissions.<name>.network.enable_socks5_udp
Type / Values
boolean
Details
Autorisez UDP via le service d’écoute SOCKS5 lorsqu’il 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. Sans features.network_proxy ni exigences réseau actives gérées par l’administrateur, l’accès réseau des commandes est direct et les règles de domaines 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 en 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
Surcharges de la liste d’autorisation des sockets Unix pour l’accès réseau en bac à sable. Utilisez les chemins des sockets 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, en plus des racines d’espace de travail définies à l’exécution pour la session.
Key
permissions.<name>.workspace_roots.<path>
Type / Values
boolean
Details
Ajoutez un chemin à l’ensemble des racines d’espace de travail du profil lorsque la valeur est true. Les entrées désactivées restent inactives.
Key
personality
Type / Values
none | friendly | pragmatic
Details
Style de communication par défaut pour les modèles qui déclarent supportsPersonality ; il 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
Réglage de raisonnement de remplacement propre au mode plan. S’il n’est pas défini, le mode plan utilise son préréglage intégré par défaut.
Key
plugins.<plugin>.enabled
Type / Values
boolean
Details
Activez ou désactivez un plugin d’une marketplace locale à l’aide d’une clé plugin-name@marketplace-name. Ce paramètre est lu dans la configuration fusionnée effective ; les paramètres d’un projet de confiance peuvent remplacer les valeurs par défaut utilisateur, gérées dans le cloud et système. L’actualisation de la marketplace peut installer ou actualiser les plugins configurés, même lorsqu’ils sont désactivés. Ce paramètre ne remplace pas les états d’activation gérés par l’espace de travail.
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 d’exclusion 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 inclus dans 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
Surcharge du comportement d’approbation pour un outil MCP fourni par un plugin.
Key
project_doc_fallback_filenames
Type / Values
array<string>
Details
Autres noms de fichiers à essayer 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 qui indiquent la racine du projet ; utilisée pour rechercher cette racine dans les répertoires parents.
Key
projects.<path>.trust_level
Type / Values
string
Details
Marquez un projet ou un arbre de travail comme fiable ou non fiable ("trusted" | "untrusted"). Pour les projets non fiables, les couches .codex/ propres au projet sont ignorées, y compris la configuration locale, les hooks et les règles du 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
Politique du bac à sable pour l’accès au système de fichiers et au réseau pendant l’exécution des commandes.
Key
sandbox_workspace_write.exclude_slash_tmp
Type / Values
boolean
Details
Excluez /tmp des répertoires racines accessibles en écriture en mode workspace-write.
Key
sandbox_workspace_write.exclude_tmpdir_env_var
Type / Values
boolean
Details
Excluez $TMPDIR des répertoires 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
Répertoires 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 priority dans la requête.
Key
shell_environment_policy.exclude
Type / Values
array<string>
Details
Anciens motifs d’exclusion des variables d’environnement. Utilisez shell_environment_policy.filters pour toute nouvelle configuration ; 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 shell de l’utilisateur lors de la création de sous-processus.
Key
shell_environment_policy.filters
Type / Values
map<string, include | exclude>
Details
Filtres canoniques par motif pour les variables d’environnement, insensibles à la casse. Les entrées d’inclusion créent une liste d’autorisation et ne peuvent pas rétablir les valeurs exclues. Les valeurs explicites de set sont appliquées 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 (par défaut : true). Définissez ce paramètre sur false pour appliquer les exclusions automatiques fondées sur les noms de secrets.
Key
shell_environment_policy.include_only
Type / Values
array<string>
Details
Ancienne liste d’autorisation de motifs de variables d’environnement. Utilisez shell_environment_policy.filters pour toute nouvelle configuration ; ne combinez pas les deux formes dans une même couche.
Key
shell_environment_policy.inherit
Type / Values
all | core | none
Details
Règles de base pour l’héritage de l’environnement lors de la création de sous-processus.
Key
shell_environment_policy.set
Type / Values
map<string,string>
Details
Valeurs d’environnement explicites injectées après les exclusions ; les filtres d’inclusion peuvent encore les supprimer.
Key
show_raw_agent_reasoning
Type / Values
boolean
Details
Affichez le contenu brut du raisonnement lorsque le modèle actif en émet.
Key
skills.config
Type / Values
array<object>
Details
Paramètres d’activation propres à chaque skill, enregistrés 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
skills.max_context_tokens
Type / Values
integer (positive)
Details
Budget de tokens pour le catalogue des skills disponibles. La valeur par défaut est de 2 % de la fenêtre de contexte du modèle. Les valeurs explicites sont plafonnées à 10000 tokens.
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 des agents et les autres états d’exécution permettant une reprise.
Key
suppress_unstable_features_warning
Type / Values
boolean
Details
Masquez l’avertissement qui apparaît 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 le stockage de chaque sortie d’outil ou de 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" et un id.
Key
tool_suggest.discoverables
Type / Values
array<table>
Details
Autorisez les suggestions d’outils provenant d’autres connecteurs ou plugins détectables. Chaque entrée utilise type = "connector" ou "plugin" et 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. La forme 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 des commandes exécutées en bac à sable et ne restreignent ni les connecteurs ni les serveurs MCP.
Key
tui
Type / Values
table
Details
Options propres à l’interface textuelle (TUI), comme l’activation des notifications de bureau intégrées.
Key
tui.alternate_screen
Type / Values
auto | always | never
Details
Déterminez l’utilisation de l’écran alternatif pour l’interface textuelle (par défaut : auto ; auto le désactive dans Zellij pour 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, indicateur de chargement) (par défaut : true).
Key
tui.keymap.<context>.<action>
Type / Values
string | array<string>
Details
Association d’un raccourci clavier à une action de l’interface textuelle. Les contextes pris en charge comprennent global, chat, composer, editor, vim_normal, vim_operator, vim_text_object, pager, list et approval. Certaines actions de la zone de saisie utilisent les associations correspondantes de tui.keymap.global comme solution de repli ; les associations propres au contexte sont prioritaires lorsqu’elles sont prises en charge.
Key
tui.keymap.<context>.<action> = []
Type / Values
empty array
Details
Supprimez l’association de l’action dans ce contexte de raccourcis clavier. Les noms des touches utilisent des chaînes normalisées telles que ctrl-a, shift-enter, page-down ou minus.
Key
tui.model_availability_nux.<model>
Type / Values
integer
Details
État interne des infobulles de démarrage, indexé par slug de modèle.
Key
tui.notification_condition
Type / Values
unfocused | always
Details
Déterminez si les notifications de l’interface textuelle se déclenchent uniquement lorsque le terminal n’a pas le focus ou indépendamment du focus. 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 l’interface textuelle ; vous pouvez les limiter à certains types d’événements.
Key
tui.raw_output_mode
Type / Values
boolean
Details
Démarrez l’interface textuelle 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 par défaut alt-r.
Key
tui.resume_cwd
Type / Values
current | session
Details
Répertoire de travail à utiliser pour reprendre ou forker une session. Si ce paramètre n’est pas défini, Codex vous demande de choisir lorsque votre répertoire actuel diffère du répertoire enregistré pour la session.
Key
tui.show_tooltips
Type / Values
boolean
Details
Affichez les infobulles de prise en main sur l’écran d’accueil de l’interface textuelle (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 en bas de l’interface textuelle. 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. Par défaut : ["spinner", "project"] ; null désactive les mises à jour du titre.
Key
tui.theme
Type / Values
string
Details
Remplacement du thème de coloration syntaxique (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 activer ou désactiver 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 maintenu par OpenAI sans accès au web externe ; indexed n’autorise l’accès externe que sous le contrôle de l’index de recherche ; 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 récupérer du contenu en direct sans restriction, ou "disabled" pour supprimer l’outil.
Key
windows_wsl_setup_acknowledged
Type / Values
boolean
Details
Enregistrez la confirmation du parcours de prise en main de Windows (Windows uniquement).
Key
windows.sandbox
Type / Values
unelevated | elevated
Details
Mode de bac à sable natif propre à Windows, utilisé lorsque Codex s’exécute nativement sur Windows.
Key
windows.sandbox_private_desktop
Type / Values
boolean
Details
Exécutez par défaut le processus enfant final placé dans le bac à sable sur un bureau privé lors d’une exécution native sur Windows. Définissez ce paramètre sur false uniquement pour assurer la compatibilité avec l’ancien comportement Winsta0\\Default.

Vous trouverez le dernier schéma JSON de config.toml 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 en tête de votre fichier config.toml :

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

Remarque : renommez experimental_instructions_file en model_instructions_file. L’ancienne clé est obsolète dans Codex ; mettez à jour les configurations existantes avec 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 les remplacer. Pour en savoir plus sur ces exigences, les emplacements du fichier et les exemples, consultez Exigences imposées par l’administrateur.

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

Utilisez [features] dans requirements.toml pour fixer les indicateurs de fonctionnalités à l’exécution à l’aide des mêmes clés canoniques que dans config.toml. Les exigences peuvent également inclure des clés documentées propres à l’application qui n’ont pas leur place dans config.toml. Les clés omises restent sans contrainte.

Certaines exigences gérées imposent une valeur de configuration précise plutôt qu’une liste de valeurs autorisées. 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 de retour d’expérience ou un paramètre de bureau privé Windows.

Les listes de profils d’autorisations autorisés gérées par l’administrateur nécessitent Codex 0.138.0 ou une version ultérieure. Codex 0.137.0 et les versions antérieures ignorent allowed_permission_profiles ainsi que 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.

Une entrée untrusted dans allowed_approval_policies reste valide pour le comportement d’approbation plus strict que Codex applique lorsqu’un projet utilise trust_level = "untrusted". Elle ne permet pas de définir explicitement approval_policy = "untrusted".

La table [models.new_thread] fournit des valeurs par défaut gérées, sans les imposer. Si vous remplacez explicitement le modèle ou l’effort de raisonnement avec --model, --config ou --profile, Codex ignore à la fois model et model_reasoning_effort dans [models.new_thread]. Le paramètre service_tier est indépendant.

Les exigences relatives au navigateur couvrent trois interfaces distinctes. in_app_browser contrôle le volet du navigateur qu’une personne ouvre et utilise directement. browser_use contrôle les actions effectuées par l’agent dans un navigateur. computer_use contrôle les actions effectuées par l’agent dans les applications de bureau natives.

Les valeurs imbriquées des politiques de Navigateur et d’Utilisation de l’ordinateur n’accordent pas d’accès à elles seules. Une valeur allow propre à une origine ou à une application peut remplacer la valeur de repli de la même source de politique, mais les vérifications habituelles des fonctionnalités, des approbations et des autres politiques continuent de s’appliquer. Lorsque les exigences gérées et config.toml s’appliquent tous deux, une valeur deny provenant de l’un ou de l’autre est prioritaire.

Key
allow_appshots
Type / Values
boolean
Details
Définissez ce paramètre sur false pour désactiver les captures d’application pour les utilisateurs gérés. S’il est omis, les exigences ne restreignent pas les captures d’application, qui restent soumises aux conditions habituelles de disponibilité du produit.
Key
allow_browser_and_computer_use
Type / Values
boolean
Details
Définissez ce paramètre sur false pour bloquer à la fois la fonctionnalité Navigateur pilotée par l’agent et l’Utilisation de l’ordinateur dans les applications natives. Le définir sur true ou l’omettre n’active aucune de ces fonctionnalités ; les autres vérifications relatives aux fonctionnalités, aux politiques et aux approbations continuent de s’appliquer.
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 ce paramètre vaut true, Codex ignore les hooks de l’utilisateur, du projet, de la session et des plugins, 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 ce paramètre sur false pour désactiver le contrôle à distance des appareils pour les utilisateurs gérés. S’il est omis, les exigences ne restreignent pas le contrôle à distance des appareils, qui reste soumis aux conditions habituelles de disponibilité du produit.
Key
allowed_approval_policies
Type / Values
array<string>
Details
Politiques d’approbation autorisées, telles que on-request, never et granular. Incluez untrusted pour autoriser la politique plus stricte découlant d’un projet non fiable ; celle-ci ne peut pas être sélectionnée directement avec approval_policy.
Key
allowed_approvals_reviewers
Type / Values
array<string>
Details
Valeurs autorisées pour approvals_reviewer, telles que user et auto_review.
Key
allowed_chatgpt_workspaces
Type / Values
array<string>
Details
Limitez la connexion ChatGPT, y compris les jetons d’accès Codex, aux identifiants d’espaces de travail répertoriés. Une liste vide désactive la connexion ChatGPT ; l’authentification par API reste disponible lorsqu’elle est autorisée. Définissez ce paramètre dans le fichier local d’exigences système ou via le MDM macOS ; les valeurs gérées dans le cloud sont ignorées.
Key
allowed_login_methods
Type / Values
array<string>
Details
Autorisez chatgpt, api ou les deux. Si ce paramètre est omis, les méthodes de connexion ne sont pas restreintes. S’il est défini, la liste doit contenir au moins une méthode. api autorise l’authentification par API, y compris avec Amazon Bedrock. Définissez ce paramètre dans le fichier local d’exigences système ou via le MDM macOS. Les valeurs gérées dans le cloud sont ignorées.
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. Les profils omis ou définis sur false sont interdits, y compris ceux ajoutés dans les versions futures. Lorsque plusieurs sources d’exigences sont combinées, les entrées sont associées par nom de profil.
Key
allowed_permission_profiles.<name>
Type / Values
boolean
Details
Autorisez ou interdisez un profil d’autorisations intégré ou personnalisé défini dans une source de configuration ou 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. Les exigences peuvent désactiver une application ou restreindre le comportement d’approbation de chaque outil.
Key
apps.<id>.enabled
Type / Values
boolean
Details
Définissez ce paramètre sur false pour désactiver une application. Une exigence de désactivation reste restrictive lors de la fusion de plusieurs sources d’exigences.
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’application.
Key
browser_use
Type / Values
table
Details
Exigences gérées pour la fonctionnalité Navigateur pilotée par l’agent.
Key
browser_use.allow_global_persistent_approval
Type / Values
boolean
Details
Définissez ce paramètre sur false pour empêcher la fonctionnalité Navigateur de créer ou d’appliquer des approbations Always allow couvrant tous les sites, par exemple pour autoriser les téléchargements depuis n’importe quel site. Les approbations déjà enregistrées sont ignorées, sans être supprimées. Le définir sur true ou l’omettre ne crée aucune approbation.
Key
browser_use.allow_history_access
Type / Values
boolean
Details
Définissez ce paramètre sur false pour empêcher la fonctionnalité Navigateur de lire l’historique de navigation. Le définir sur true ou l’omettre laisse en place les paramètres habituels de l’historique et les vérifications de disponibilité.
Key
browser_use.default_origin_policy
Type / Values
table
Details
Valeur de repli pour chaque paramètre de la fonctionnalité Navigateur lorsqu’aucune entrée correspondante sous browser_use.origins ne le définit. Une règle d’origine correspondante remplace la valeur de repli pour cette source. Codex applique ensuite le résultat le plus strict entre les exigences gérées et la configuration utilisateur.
Key
browser_use.default_origin_policy.access
Type / Values
allow | deny
Details
Utilisez deny pour bloquer la fonctionnalité Navigateur sur les origines utilisant la valeur de repli. Le refus d’accès à une origine bloque également les envois de fichiers, les téléchargements, l’accès complet au débogage du navigateur et la révision automatique sur cette origine. allow permet uniquement de poursuivre les vérifications habituelles d’approbation et de politique.
Key
browser_use.default_origin_policy.access_approval_lifetime
Type / Values
turn | thread
Details
Définissez la durée d’une approbation non persistante d’accès à un site : turn la limite au tour en cours, et thread la conserve jusqu’à la fin du fil de discussion en cours. persistent_approval détermine séparément si Always allow est disponible. La valeur par défaut du produit est thread.
Key
browser_use.default_origin_policy.auto_review
Type / Values
allow | deny
Details
Utilisez deny pour ne pas effectuer de révision automatique sur les origines utilisant la valeur de repli et demander à la place l’approbation de l’utilisateur. allow laisse la révision automatique disponible lorsque les autres paramètres l’autorisent.
Key
browser_use.default_origin_policy.downloads
Type / Values
allow | deny
Details
Utilisez deny pour bloquer les téléchargements de la fonctionnalité Navigateur sur les origines utilisant la valeur de repli. allow permet uniquement de poursuivre les vérifications habituelles d’approbation et de politique.
Key
browser_use.default_origin_policy.full_cdp_access
Type / Values
allow | deny
Details
Utilisez deny pour bloquer l’accès complet au Chrome DevTools Protocol (CDP) sur les origines utilisant la valeur de repli. allow permet uniquement de poursuivre les vérifications habituelles d’activation volontaire et d’approbation.
Key
browser_use.default_origin_policy.persistent_approval
Type / Values
boolean
Details
Définissez ce paramètre sur false pour empêcher la fonctionnalité Navigateur d’enregistrer ou d’appliquer une approbation Always allow sur les origines utilisant la valeur de repli. Les approbations valables pour le tour ou le fil en cours peuvent toujours s’appliquer. true rend Always allow disponible lorsque les autres conditions l’autorisent, mais ne crée aucune approbation.
Key
browser_use.default_origin_policy.uploads
Type / Values
allow | deny
Details
Utilisez deny pour bloquer les envois de fichiers de la fonctionnalité Navigateur sur les origines utilisant la valeur de repli. allow permet uniquement de poursuivre les vérifications habituelles d’approbation et de politique.
Key
browser_use.disable_auto_review
Type / Values
boolean
Details
Définissez ce paramètre sur true pour ne pas effectuer de révision automatique pour la fonctionnalité Navigateur et demander à la place l’approbation de l’utilisateur. Le définir sur false ou l’omettre laisse la révision automatique disponible lorsque les autres paramètres l’autorisent.
Key
browser_use.origins
Type / Values
map<string, table>
Details
Politiques de la fonctionnalité Navigateur propres à chaque origine. Les clés utilisent <scheme>://<host-pattern>[:<port>] avec http ou https. Utilisez un hôte exact, *.example.com pour les sous-domaines uniquement, ou **.example.com pour le domaine de base et ses sous-domaines. Les autres caractères génériques * peuvent couvrir des points : region*.example.com correspond donc aussi à region.api.example.com ; un hôte * correspond à tous les hôtes pour ce schéma. Les schémas et les ports autres que ceux par défaut sont pris en compte ; les ports par défaut explicitement indiqués sont supprimés lors de la normalisation. Les chemins, les chaînes de requête, les noms d’utilisateur ou mots de passe intégrés, ainsi que les schémas ou ports contenant des caractères génériques ne sont pas valides. Placez le motif entre guillemets dans TOML, par exemple [browser_use.origins."https://**.example.com"].
Key
browser_use.origins.<pattern>
Type / Values
table
Details
Politique applicable aux origines correspondant à ce motif. Si plusieurs motifs correspondent, Codex utilise la valeur la plus restrictive pour chaque capacité : deny prévaut sur allow, false sur true et turn sur thread.
Key
browser_use.origins.<pattern>.access
Type / Values
allow | deny
Details
Utilisez deny pour bloquer la fonctionnalité Navigateur sur les origines correspondantes. Ce refus y bloque aussi les téléversements, les téléchargements, l’accès complet au débogage du navigateur et la révision automatique. allow permet uniquement de poursuivre les vérifications habituelles d’approbation et de conformité aux politiques.
Key
browser_use.origins.<pattern>.access_approval_lifetime
Type / Values
turn | thread
Details
Définissez la durée d’une approbation non persistante d’accès à un site pour les origines correspondantes : turn la limite au tour en cours, et thread la conserve jusqu’à la fin du fil de discussion en cours. persistent_approval détermine séparément si Always allow est disponible.
Key
browser_use.origins.<pattern>.auto_review
Type / Values
allow | deny
Details
Utilisez deny pour ignorer la révision automatique sur les origines correspondantes et demander l’approbation de l’utilisateur à la place. allow laisse la révision automatique disponible lorsque les autres paramètres le permettent.
Key
browser_use.origins.<pattern>.downloads
Type / Values
allow | deny
Details
Utilisez deny pour bloquer les téléchargements de la fonctionnalité Navigateur sur les origines correspondantes. allow permet uniquement de poursuivre les vérifications habituelles d’approbation et de conformité aux politiques.
Key
browser_use.origins.<pattern>.full_cdp_access
Type / Values
allow | deny
Details
Utilisez deny pour bloquer l’accès complet au Chrome DevTools Protocol (CDP) sur les origines correspondantes. allow permet uniquement de poursuivre les vérifications habituelles d’activation volontaire et d’approbation.
Key
browser_use.origins.<pattern>.persistent_approval
Type / Values
boolean
Details
Définissez la valeur sur false pour empêcher la fonctionnalité Navigateur d’enregistrer ou d’appliquer une approbation Always allow sur les origines correspondantes. Les approbations pour le tour ou le fil de discussion en cours peuvent toujours s’appliquer. true rend Always allow disponible lorsque les autres conditions le permettent, mais ne crée aucune approbation.
Key
browser_use.origins.<pattern>.uploads
Type / Values
allow | deny
Details
Utilisez deny pour bloquer les téléversements de la fonctionnalité Navigateur sur les origines correspondantes. allow permet uniquement de poursuivre les vérifications habituelles d’approbation et de conformité aux politiques.
Key
chatgpt_base_url
Type / Values
string
Details
Imposez l’URL de base du service ChatGPT avant l’authentification et la récupération des politiques cloud. Ce paramètre ne configure pas toutes les destinations réseau de Codex. Définissez-le dans le fichier local d’exigences système ou via le MDM macOS ; les valeurs gérées dans le cloud sont ignorées.
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
cli_auth_credentials_store
Type / Values
file | keyring | auto | ephemeral
Details
Imposez le magasin d’identifiants de la CLI avant le chargement de l’authentification. file utilise CODEX_HOME/auth.json ; keyring nécessite le magasin d’identifiants du système d’exploitation ; auto utilise un fichier si ce magasin est indisponible ; ephemeral conserve les identifiants en mémoire pour le processus en cours. Définissez ce paramètre dans le fichier local d’exigences système ou via le MDM macOS ; les valeurs gérées dans le cloud sont ignorées.
Key
computer_use
Type / Values
table
Details
Exigences gérées pour le travail effectué par un agent dans les applications de bureau natives. Les règles gérées relatives aux applications et celles de config.toml sont toutes appliquées ; chaque source de politique doit autoriser l’application.
Key
computer_use.allow_locked_computer_use
Type / Values
boolean
Details
Définissez la valeur sur false pour empêcher les utilisateurs d’activer l’utilisation en mode verrouillé sur un appareil macOS géré. Cette exigence supprime les commandes d’activation ; elle ne désactive pas l’utilisation en mode verrouillé si celle-ci est déjà activée. Si ce paramètre est omis, la disponibilité habituelle du produit s’applique.
Key
computer_use.allow_persistent_approval
Type / Values
boolean
Details
Définissez la valeur sur false pour supprimer la possibilité de conserver les approbations d’application d’une session à l’autre. Les approbations pour la session en cours restent disponibles. Définir la valeur sur true ou omettre ce paramètre n’accorde aucune approbation à une application.
Key
computer_use.default_app_access
Type / Values
allow | deny
Details
Règle d’accès de repli pour les applications natives qui ne correspondent à aucune règle propre à la plateforme. deny bloque l’accès. allow permet uniquement de poursuivre les vérifications habituelles d’approbation et de conformité aux politiques. La valeur par défaut du produit est allow.
Key
computer_use.macos
Type / Values
table
Details
Règles relatives aux applications macOS pour la fonctionnalité Utilisation de l’ordinateur.
Key
computer_use.macos.bundle_ids
Type / Values
map<string, allow | deny>
Details
Associez les identifiants de bundle macOS exacts à allow ou deny. Une règle correspondante remplace computer_use.default_app_access au sein de la même source de politique. Un refus provenant des exigences gérées ou de la configuration utilisateur bloque toujours l’accès.
Key
computer_use.macos.bundle_ids.<bundle-id>
Type / Values
allow | deny
Details
Utilisez deny pour bloquer l’identifiant de bundle exact. allow remplace uniquement la valeur par défaut de cette source de politique ; l’application doit toujours être autorisée par toutes les autres sources de politique et par le processus d’approbation habituel.
Key
computer_use.windows
Type / Values
table
Details
Règles relatives aux applications Windows avec ou sans package pour la fonctionnalité Utilisation de l’ordinateur.
Key
computer_use.windows.aumids
Type / Values
map<string, allow | deny>
Details
Associez les identifiants Application User Model ID (AUMID) exacts et enregistrés des applications signées avec package à allow ou deny. Une règle correspondante remplace computer_use.default_app_access au sein de la même source de politique.
Key
computer_use.windows.aumids.<aumid>
Type / Values
allow | deny
Details
Utilisez deny pour bloquer l’identité exacte de l’application avec package. allow remplace uniquement la valeur par défaut de cette source de politique ; l’application doit toujours être autorisée par toutes les autres sources de politique et par le processus d’approbation habituel.
Key
computer_use.windows.exes
Type / Values
array<table>
Details
Règles pour les exécutables Windows signés sans package. La correspondance repose sur l’éditeur vérifié et les informations de version signées de l’exécutable, et non sur son chemin ou son nom de fichier actuel. Une règle de refus correspondante prévaut sur les règles d’autorisation correspondantes. Les exécutables non signés utilisent computer_use.default_app_access ; les exécutables dont l’identité signée ne peut pas être vérifiée sans ambiguïté sont bloqués.
Key
computer_use.windows.exes[].access
Type / Values
allow | deny
Details
Décision d’accès obligatoire pour les exécutables correspondants. deny bloque l’accès. allow remplace uniquement la valeur par défaut de cette source de politique ; l’application doit toujours être autorisée par toutes les autres sources de politique et par le processus d’approbation habituel.
Key
computer_use.windows.exes[].binary_name
Type / Values
string
Details
Valeur facultative de OriginalFilename, issue des informations de version signées de l’exécutable. La comparaison ne tient pas compte de la casse. Si une règle correspondant à l’éditeur et au produit exige cette valeur, mais que l’exécutable ne la fournit pas, la fonctionnalité Utilisation de l’ordinateur bloque l’exécutable.
Key
computer_use.windows.exes[].product_name
Type / Values
string
Details
Valeur exacte obligatoire de ProductName, issue des informations de version signées de l’exécutable.
Key
computer_use.windows.exes[].publisher_name
Type / Values
string
Details
Nom exact obligatoire de l’éditeur, issu du certificat de signature de confiance de l’exécutable, au format de nom distinctif X.500 de Windows.
Key
default_permissions
Type / Values
string
Details
Profil d’autorisations par défaut géré. Le profil doit être autorisé par allowed_permission_profiles. Définissez ce paramètre explicitement pour obtenir un comportement prévisible ; s’il est omis, Codex utilise :workspace par défaut uniquement si :workspace et :read-only sont tous deux explicitement autorisés.
Key
enforce_residency
Type / Values
string
Details
Exigez que le trafic des services Codex respecte une 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 le bac à sable, appliquées à partir de requirements.toml. Lorsqu’elles sont activées, ces exigences peuvent démarrer le proxy réseau des commandes sans features.network_proxy. Les outils de navigateur vérifient séparément les règles gérées de refus d’accès réseau et les listes d’autorisation exclusives. Ces exigences n’acheminent pas le trafic du navigateur via le proxy et ne contrôlent ni la recherche web, ni les applications, ni les serveurs MCP, ni le trafic des applications natives, ni les connexions réseau de Codex Cloud.
Key
experimental_network.allow_local_binding
Type / Values
boolean
Details
Autorisez un accès plus large au réseau local ou privé depuis le bac à sable. Des règles d’autorisation portant sur une adresse IP locale littérale exacte ou sur localhost peuvent toujours autoriser des cibles locales précises lorsque ce paramètre reste sur false.
Key
experimental_network.allow_upstream_proxy
Type / Values
boolean
Details
Autorisez les connexions réseau du bac à sable à passer par un proxy en amont défini dans l’environnement.
Key
experimental_network.allowed_domains
Type / Values
array<string>
Details
Règles d’autorisation de 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 ce paramètre avec experimental_network.domains.
Key
experimental_network.dangerously_allow_all_unix_sockets
Type / Values
boolean
Details
Autorisez toutes les destinations de sockets Unix au lieu de limiter l’accès à celles de la liste d’autorisation. Utilisez ce paramètre 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 bouclage pour les exigences [experimental_network]. L’activation de ce paramètre 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 de l’administrateur, sous forme de liste, pour les connexions réseau du bac à sable. Ne combinez pas ce paramètre avec experimental_network.domains.
Key
experimental_network.domains
Type / Values
map<string, allow | deny>
Details
Politique de domaines de l’administrateur, sous forme de table de correspondance, pour les connexions réseau du bac à sable. Elle prend en charge 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 d’autorisation globales * ; privilégiez les règles à portée limitée, car * ouvre largement l’accès sortant au réseau public. deny prévaut en cas de conflit. Ne combinez pas ce paramètre avec experimental_network.allowed_domains ou experimental_network.denied_domains.
Key
experimental_network.enabled
Type / Values
boolean
Details
Activez les exigences réseau du bac à sable. Cela n’accorde pas d’accès 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 réseau du bac à sable sont actives ; les ajouts de l’utilisateur à la liste d’autorisation sont ignorés. Même en l’absence de règles d’autorisation gérées, les règles d’autorisation de domaines ajoutées par l’utilisateur ne s’appliquent pas.
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 les connexions réseau du bac à sable.
Key
features
Type / Values
table
Details
Valeurs imposées pour les 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 l’activation ou la désactivation de l’intégration des applications pour les utilisateurs gérés.
Key
features.browser_use
Type / Values
boolean
Details
Définissez ce paramètre sur false dans requirements.toml pour désactiver la fonctionnalité Navigateur pilotée par l’agent.
Key
features.browser_use_external
Type / Values
boolean
Details
Définissez ce paramètre sur false dans requirements.toml pour empêcher Codex de piloter les navigateurs pris en charge via l’extension de navigateur ChatGPT, y compris les onglets existants et les sessions connectées.
Key
features.browser_use_full_cdp_access
Type / Values
boolean
Details
Définissez ce paramètre sur false dans requirements.toml pour désactiver l’accès complet au 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. S’il est omis, les conditions habituelles de disponibilité du produit s’appliquent.
Key
features.computer_use
Type / Values
boolean
Details
Définissez ce paramètre 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é des approbations Guardian pour les utilisateurs gérés.
Key
features.in_app_browser
Type / Values
boolean
Details
Définissez ce paramètre sur false dans requirements.toml pour désactiver le volet du navigateur intégré que les utilisateurs ouvrent et contrôlent directement.
Key
features.in_app_updates
Type / Values
boolean
Details
Définissez ce paramètre sur false dans requirements.toml pour désactiver les mises à jour depuis l’application. Les mises à jour restent activées par défaut lorsque cette exigence est omise.
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é des fonctionnalités multi-agents pour les utilisateurs gérés.
Key
features.plugin_sharing
Type / Values
boolean
Details
Définissez ce paramètre sur false dans le fichier requirements.toml géré dans le cloud pour désactiver le partage au sein de l’espace de travail des plugins créés localement.
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, pour les utilisateurs gérés, la disponibilité ou l’indisponibilité de l’environnement d’exécution fourni pour les dépendances de l’espace de travail.
Key
feedback
Type / Values
table
Details
Paramètres gérés pour l’envoi de commentaires.
Key
feedback.enabled
Type / Values
boolean
Details
Imposez l’autorisation ou l’interdiction pour les utilisateurs d’envoyer des commentaires depuis les différents clients Codex.
Key
guardian_policy_config
Type / Values
string
Details
Instructions de politique gérées, au format Markdown, pour la révision automatique. Elles prévalent sur le paramètre local [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és et utilisent le même schéma d’événements que la section [hooks] définie directement dans config.toml.
Key
hooks.<Event>
Type / Values
array<table>
Details
Groupes de critères de correspondance pour un événement de hook tel 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 pas exécutés.
Key
hooks.<Event>[].hooks[].additionalContextLimit
Type / Values
integer
Details
Seuil approximatif de tokens par gestionnaire au-delà duquel un contenu additionalContext trop volumineux est enregistré sur disque et présenté au modèle sous forme d’un aperçu plus court. La valeur par défaut est 2500 ; 0 transmet directement tout le contexte 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. La valeur par défaut est false ; SessionEnd s’exécute toujours de manière synchrone. Consultez Exécution de 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. Codex vérifie que son chemin est absolu et qu’il existe avant de charger les hooks gérés.
Key
hooks.windows_managed_dir
Type / Values
string (absolute path)
Details
Répertoire contenant les scripts de hooks gérés sur Windows. Codex vérifie que son chemin est absolu et qu’il existe avant de charger les hooks gérés.
Key
in_app_browser
Type / Values
table
Details
Exigences relatives au volet du navigateur intégré. Ces paramètres ne contrôlent pas la fonctionnalité Navigateur pilotée par l’agent.
Key
in_app_browser.allow_external_browser_settings_import
Type / Values
boolean
Details
Définissez ce paramètre sur false pour empêcher les utilisateurs d’importer des paramètres ou des données de navigation d’un navigateur externe vers le navigateur intégré. Le définir sur true ou l’omettre laisse l’importation disponible lorsque les autres vérifications du produit l’autorisent. Ce paramètre relève exclusivement de la configuration gérée et ne peut pas être remplacé dans config.toml.
Key
log_dir
Type / Values
string (path)
Details
Imposez le répertoire où Codex écrit les fichiers journaux locaux.
Key
marketplaces
Type / Values
table
Details
Exigences de l’administrateur concernant les sources de Marketplace de plugins. Les règles prennent effet lorsque restrict_to_allowed_sources vaut true.
Key
marketplaces.allowed_sources
Type / Values
table
Details
Sources de Marketplace autorisées, indexées par nom de règle choisi par l’administrateur. Les règles portant des noms distincts se cumulent entre les couches d’exigences ; les champs regroupés sous 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. La valeur finale de source après la fusion des exigences 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 la compare au nom d’hôte en minuscules extrait d’une source Git HTTPS, SSH ou de type SCP. Utilisez ^ et $ pour exiger une correspondance avec le nom d’hôte complet.
Key
marketplaces.allowed_sources.<name>.path
Type / Values
string (absolute path)
Details
Répertoire local de 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 du dépôt correspondant.
Key
marketplaces.allowed_sources.<name>.source
Type / Values
git | host_pattern | local
Details
Type de critère de correspondance pour une source de Marketplace. Utilisez git pour un dépôt, host_pattern pour des hôtes Git correspondant à 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 les URL configurées et autorisées, puis exige une correspondance exacte du dépôt.
Key
marketplaces.restrict_to_allowed_sources
Type / Values
boolean
Details
Lorsque ce paramètre vaut true, les sources de Marketplace configurées doivent correspondre à allowed_sources lors de l’ajout d’une Marketplace, de l’installation d’un plugin, de l’actualisation et du chargement à l’exécution. Les catalogues Git sélectionnés par OpenAI, y compris le catalogue pour les clés API, doivent également correspondre à la liste d’autorisation. Les plugins d’espace de travail intégrés et ceux installés à distance sont distincts de cette politique relative aux sources Git sélectionnées.
Key
mcp_servers
Type / Values
table
Details
Liste d’autorisation des serveurs MCP pouvant être activés. Le nom du serveur (<id>) et son identité doivent tous deux correspondre pour que le serveur MCP puisse être activé. Tout serveur MCP configuré qui ne figure pas dans la liste d’autorisation 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 (HTTP en streaming).
Key
mcp_servers.<id>.identity.command
Type / Values
string | table
Details
Autorisez un serveur MCP stdio à partir 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. La forme chaîne de caractères n’examine ni les arguments, ni cwd, ni env, ni env_vars.
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 commande n’examinent ni cwd, ni 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. L’expression doit être valide et correspondre à la valeur entière 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 HTTP en streaming à partir d’une chaîne d’URL exacte, ou utilisez une table de critères de correspondance de valeur de type 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. L’expression doit être valide et correspondre à l’URL entière.
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 JSON utilisé par Codex au démarrage.
Key
models
Type / Values
table
Details
Contient la table [models.new_thread].
Key
models.new_thread
Type / Values
table
Details
Valeurs par défaut facultatives à appliquer au démarrage d’un nouveau fil local. Elles prévalent sur les valeurs par défaut de l’utilisateur et du projet, mais peuvent être remplacées par des valeurs explicitement définies.
Key
models.new_thread.model
Type / Values
string
Details
Modèle par défaut pour les nouveaux fils. Si le modèle ou l’effort de raisonnement est explicitement remplacé, les deux champs sont ignorés.
Key
models.new_thread.model_reasoning_effort
Type / Values
string
Details
Effort de raisonnement par défaut pour les nouveaux fils. Si le modèle ou l’effort de raisonnement est explicitement remplacé, les deux champs sont ignorés.
Key
models.new_thread.service_tier
Type / Values
string
Details
Offre par défaut pour les nouveaux fils. Si l’offre est explicitement remplacée, ce champ est ignoré.
Key
permissions
Type / Values
table
Details
Profils d’autorisations définis par l’administrateur, 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 :, être le nom réservé filesystem ni reprendre le nom d’un profil d’une configuration chargée. Il utilise les mêmes champs de profil que config.toml ; consultez le guide des autorisations pour connaître le schéma complet des profils.
Key
permissions.filesystem.deny_read
Type / Values
array<string>
Details
Interdictions de lecture du 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 les assouplir avec une configuration locale.
Key
plugins
Type / Values
table
Details
Listes d’autorisation de serveurs MCP propres à chaque plugin, indexées par identifiant de plugin. Lorsque cette table est présente, les serveurs fournis avec un plugin 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 premier niveau.
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 (HTTP en streaming).
Key
plugins.<plugin>.mcp_servers.<server>.identity.command
Type / Values
string | table
Details
Autorisez le serveur MCP stdio d’un plugin à partir 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.
Key
plugins.<plugin>.mcp_servers.<server>.identity.command.args
Type / Values
array<table>
Details
Critères de correspondance ordonnés pour les arguments d’un serveur stdio fourni par un plugin. La liste d’arguments configurée doit avoir la même longueur, et chaque argument doit satisfaire le critère à sa position.
Key
plugins.<plugin>.mcp_servers.<server>.identity.command.args[].expression
Type / Values
string
Details
Expression régulière utilisée par un critère de correspondance d’argument regex. L’expression doit correspondre à la valeur complète 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 un critère 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 pour le 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 son URL exacte, ou utilisez une table définissant un critère de correspondance de valeur exact, prefix ou regex.
Key
plugins.<plugin>.mcp_servers.<server>.identity.url.expression
Type / Values
string
Details
Expression régulière utilisée par un critère de correspondance d’URL regex. L’expression doit correspondre à l’URL complète.
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 par le plugin.
Key
plugins.<plugin>.mcp_servers.<server>.identity.url.value
Type / Values
string
Details
Valeur utilisée par un critère de correspondance d’URL exact ou prefix.
Key
remote_sandbox_config
Type / Values
array<table>
Details
Exigences de bac à sable propres à un hôte. La première entrée dont les hostname_patterns correspondent au nom d’hôte résolu remplace le paramètre allowed_sandbox_modes de premier niveau pour cette source d’exigences. Les entrées propres à un hôte ne remplacent actuellement 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 correspond à l’hôte.
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 une approbation ou interdire une action (pas l’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 refus.
Key
rules.prefix_rules[].pattern
Type / Values
array<table>
Details
Préfixe de commande exprimé sous forme de tokens de motif. Chaque token définit soit token, soit any_of.
Key
rules.prefix_rules[].pattern[].any_of
Type / Values
array<string>
Details
Liste des tokens autorisés comme alternatives à 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 relatives au 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. Si 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 le démarrage du processus enfant du bac à sable natif de Windows.