Référence de configuration

Cette page vous permet de rechercher les paramètres des fichiers de configuration de Codex. Pour comprendre les principes de configuration et consulter des exemples, commencez par les Bases de la configuration, puis consultez la Configuration avancée.

Paramètres d’accès à l’ordinateur local avec Work Cloud

Lorsque l’accès à l’ordinateur local avec Work Cloud est activé, le cloud d’OpenAI coordonne la tâche et les outils pris en charge s’exécutent dans le cloud ou sur un ordinateur connecté. Les exigences fixent les limites et la configuration définit les valeurs par défaut.

Utilisez l’API de gestion des politiques pour gérer les paramètres de la portée Global. Pour gérer les paramètres de la portée Local ou Codex Cloud, utilisez l’interface Agent Security. Les workflows existants qui utilisent l’API pour la portée Global restent disponibles après la migration. Testez vos scripts et vos intégrations Terraform, puis vérifiez que les affectations des politiques et leur ordre sont restés identiques. La prise en charge d’un champ dans requirements.toml ne suffit pas à établir sa compatibilité avec l’API.

Paramètre ou famille de paramètres	Portée pour l’accès à l’ordinateur local avec Work Cloud	Consignes
Politiques d’approbation et exigences de révision	Politique de portée Global de l’orchestrateur lorsque la gestion des politiques est activée	Conservez les contrôles d’approbation et de révision dans la portée Global. Les paramètres propres à un environnement ne peuvent pas modifier les contrôles de l’orchestrateur. Les politiques s’appliquent séparément à l’exécution locale et à l’exécution dans un conteneur cloud.
Applications gérées, serveurs MCP, plugins, marketplaces et règles de commande	Politique de portée Global	Conservez ces contrôles dans la portée Global. La présence d’un champ dans un schéma ne suffit pas à établir qu’il est modifiable pour chaque environnement.
Exigences relatives aux fichiers et au bac à sable, et exigences réseau portables	Exécution locale	Pour l’exécution locale, les exigences MDM et les anciennes exigences applicables aux appareils gérés priment sur celles d’Agent Security. Les exigences d’Agent Security priment à leur tour sur celles du fichier d’exigences système de l’appareil. La nouvelle configuration d’entreprise `requirements.toml` ne s’applique pas aux conteneurs cloud de Work, qui conservent les politiques Work Cloud existantes.
Contrôles de l’exécuteur propres à la plateforme	Ordinateur qui exécute l’étape	La prise en charge dépend de l’exécuteur et de la plateforme.
Hooks gérés	Lorsqu’ils sont activés, les hooks MCP définis par l’administrateur s’exécutent sur le coordinateur cloud (orchestrateur) en réponse aux événements de cycle de vie et d’outils pris en charge.	Avant de vous appuyer sur ces hooks, testez la connexion de rappel, vérifiez quels événements elle reçoit et examinez les conséquences d’un échec sur la tâche. Les hooks MCP ne fournissent pas de piste d’audit complète via l’API de conformité. L’orchestration cloud ne prend pas en charge les hooks de commande, de configuration locale ou de plugin, même si les outils s’exécutent localement. Les hooks déjà pris en charge continuent de s’appliquer aux fils de discussion de Work et de Codex lorsque l’orchestration et l’exécution ont toutes deux lieu en local.
Adresses et ports d’écoute du proxy, paramètres de processus	Hors du champ des politiques portables d’un environnement à l’autre	L’environnement d’exécution cloud ne prend en charge ni les ports d’écoute HTTP/SOCKS gérés ni les proxys à l’écoute sur une adresse autre qu’une adresse de bouclage. La prise en charge des règles de socket dépend du chemin d’exécution. La configuration personnalisée du proxy est distincte des restrictions de destination prises en charge.
Paramètres propres à l’application et valeurs locales par défaut habituelles	Paramètres que le coordinateur cloud ne prend pas nécessairement en compte	Les contrôles appliqués par l’application peuvent rester en vigueur même si l’accès à l’ordinateur local avec Work Cloud ne les prend pas en compte. Validez séparément la distribution des politiques dans le cloud et le comportement du navigateur cloud.

Exigences d’Agent Security pour l’accès à l’ordinateur local avec Work Cloud

Pour le mode Work avec accès local et pour les dots, les paramètres pris en charge de la politique Global s’appliquent à l’orchestrateur cloud partagé lorsque la politique gérée est activée. Les exigences d’exécution locale s’appliquent à l’ordinateur connecté. Les conteneurs cloud de Work et les ordinateurs cloud des dots utilisent leurs propres paramètres et exigences d’exécution. Testez séparément les contrôles locaux et ceux du cloud.

Paramètres disponibles dans l’interface d’Agent Security

Politiques d’approbation autorisées
Modes de recherche web autorisés

Paramètres configurés en TOML

allowed_approvals_reviewers
auto_review
guardian_policy_config
apps
mcp_servers
plugins
rules

Ces exigences de l’orchestrateur restent au niveau Global. Elles ne définissent pas les autorisations des fonctionnalités cloud partagées et ne permettent pas de transposer les paramètres d’exécution locale aux conteneurs cloud de Work ou aux ordinateurs cloud des dots.

Limites de compatibilité de l’accès à l’ordinateur local avec Work Cloud

La prise en charge dépend du champ, du mode de distribution de la politique et de l’environnement où la tâche s’exécute. Vérifiez la politique effectivement appliquée au membre avant d’activer la synchronisation. Le tableau indique les contrôles à tester dans votre déploiement.

Au sein d’une politique, les paramètres s’appliquent par ordre de priorité décroissant : paramètres de substitution de l’environnement propres à un système d’exploitation → paramètres de substitution de l’environnement communs à tous les systèmes d’exploitation → Global. Une politique de priorité supérieure l’emporte même si la politique de priorité inférieure est plus spécifique.

Pour l’exécution locale, les exigences MDM et les anciennes exigences relatives aux appareils gérés priment sur celles d’Agent Security. Ces dernières priment à leur tour sur les exigences définies dans le fichier d’exigences système de l’appareil. Certaines exigences, notamment celles qui concernent le réseau, suivent des règles de fusion propres à chaque champ et sont soumises à des limites lors de l’exécution. Vous trouverez des exemples dans la section Configuration gérée.

Paramètre ou famille de paramètres	Compatibilité avec l’accès à l’ordinateur local avec Work Cloud	Consignes pour les administrateurs
`sqlite_home`, `log_dir`, `model_catalog_json`	Non pris en charge comme paramètres de substitution gérés dans le cloud.	Les chemins locaux ne permettent pas de modifier l’emplacement du stockage ou des journaux dans le cloud. Le catalogue de modèles local n’est pas repris.
`model_provider`, `model_providers`	Non pris en charge dans les exigences gérées ni dans la configuration gérée de l’accès à l’ordinateur local avec Work Cloud.	Ces champs ne permettent pas de reprendre les passerelles d’inférence personnalisées ni les connexions aux fournisseurs. La sélection du modèle est indépendante de ces paramètres.
`enforce_residency`	Bloque l’accès à l’ordinateur local avec Work Cloud dès qu’une politique cloud active ce paramètre.	Si une politique cloud active `enforce_residency`, l’option Autoriser l’accès à l’ordinateur local est désactivée pour le mode Work et les dots. Cette protection ne configure pas la résidence des données de l’espace de travail et ne désactive pas, à elle seule, Work Cloud ou les dots.
`application.network.enabled` et `application.network.domains`	Non pris en charge pour l’accès à l’ordinateur local avec Work Cloud.	N’utilisez pas ces restrictions sur les destinations réseau de l’application pour contrôler l’accès réseau des commandes lors de l’accès à l’ordinateur local avec Work Cloud.
`allow_browser_and_computer_use`, `in_app_browser`, `additional_developer_instructions`	La distribution des politiques cloud reste à valider. L’accès à l’ordinateur local avec Work Cloud rejette ces clés d’exigences gérées.	L’application vérifie les restrictions du navigateur. Ces vérifications ne prouvent ni que la politique cloud a été distribuée ni que le navigateur cloud applique les restrictions. `additional_developer_instructions` nécessite une prise en charge par l’orchestrateur.
`experimental_network` et `permissions.<profile>.network`	Partielle. Les restrictions prises en charge pour les destinations et les exécuteurs sont distinctes de la configuration d’un proxy personnalisé.	L’environnement d’exécution cloud ne prend en charge ni les ports d’écoute HTTP/SOCKS gérés ni les proxys qui écoutent sur une adresse autre qu’une adresse de bouclage. La prise en charge des règles de socket dépend du chemin d’exécution. La fusion des paramètres pour l’exécution locale obéit à des règles distinctes. Les restrictions réseau des commandes ne désactivent ni la recherche hébergée, ni MCP, ni les outils des applications.
fonctionnalités / `feature_requirements`, modèles, `computer_use`	Partielle.	Les paramètres retirés, tels que `tool_search` = false, `tool_search_always_defer_mcp_tools` = false, `js_repl` = true et `remote_control` = true, sont rejetés. Certains paramètres d’utilisation de l’ordinateur nécessitent encore une validation de bout en bout.
`browser_use`, `allow_appshots`, retours des utilisateurs, `allow_remote_control`, restrictions sur les sources de la Marketplace	L’application ou le serveur d’application applique ces contrôles pour certains modes de distribution des politiques.	Les contrôles de l’application peuvent rester en vigueur même si l’accès à l’ordinateur local avec Work Cloud ignore un champ. Les règles par site du navigateur de bureau ne s’appliquent pas aux conteneurs cloud de Work. Vérifiez que les contrôles s’appliquent dans l’interface concernée avec le mode de distribution des politiques que vous utilisez.

Certaines clés du schéma de configuration peuvent être incompatibles avec l’accès à l’ordinateur local avec Work Cloud ou ne pas accepter de valeurs de remplacement propres à un environnement. Consultez la section Configuration gérée pour connaître la configuration globale de référence et les règles de priorité.

`config.toml`

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

La configuration du projet ne peut pas redéfinir les clés propres à la machine qui régissent le fournisseur, l’authentification, les métadonnées que l’hôte gère pour les requêtes des applications, les notifications, le choix du profil de configuration ou le routage de la télémétrie. Codex ignore les clés 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 du projet. Placez les clés du fournisseur, des notifications et de la télémétrie dans la configuration utilisateur. Les fichiers de profil se trouvent dans le même répertoire que config.toml, sous la forme $CODEX_HOME/profile-name.config.toml. Sélectionnez un profil avec --profile profile-name.

Pour les clés du bac à sable et des approbations (approval_policy, sandbox_mode et sandbox_workspace_write.*), consultez également Bac à sable et approbations, Chemins protégés dans les racines accessibles en écriture et Accès réseau. Pour les profils d’autorisations en 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 qui spécifient trust_level = "untrusted" dans le fichier de configuration utilisateur ~/.codex/config.toml restent prises en charge. Consultez Migrer depuis l’ancienne politique d’approbation untrusted pour voir des exemples et comparer les avantages et les limites des différentes options d’approbation.

Définissez model sur un modèle disponible pour le compte ou l’espace de travail auquel vous êtes connecté. Vérifiez la disponibilité de GPT-6.1 Sol avant d’utiliser la valeur de l’exemple.

Key	Type / Values	Details
`agents`	`table`	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.
`agents.<name>.config_file`	`string (path)`	Chemin du fichier TOML qui définit la couche de configuration propre à ce rôle. Codex résout les chemins relatifs à partir du répertoire du fichier de configuration qui déclare le rôle.
`agents.<name>.description`	`string`	Consignes sur le rôle présentées à Codex lorsqu’il choisit ce type d’agent et lance un agent de ce type.
`agents.default_subagent_model`	`string`	Modèle par défaut des sous-agents. Un modèle indiqué explicitement au lancement est prioritaire.
`agents.default_subagent_reasoning_effort`	`string`	Effort de raisonnement par défaut des sous-agents. Un effort indiqué explicitement au lancement est prioritaire.
`agents.enabled`	`boolean`	Active ou désactive les outils multi-agents (par défaut : true).
`agents.interrupt_message`	`boolean`	Enregistre un message visible par le modèle lorsqu’un tour d’agent est interrompu (par défaut : true).
`agents.max_concurrent_threads_per_session`	`number`	Nombre maximal de fils de sous-agents qui peuvent rester ouverts simultanément, hors fil principal. Si vous omettez ce paramètre, Codex choisit la limite par défaut.
`agents.max_threads`	`number`	Ancien alias de `agents.max_concurrent_threads_per_session`.
`allow_login_shell`	`boolean`	Autorise les outils shell à utiliser un shell de connexion. La valeur par défaut est `true`. Avec `false`, Codex rejette les demandes qui spécifient `login = true` et utilise un shell sans connexion si `login` est omis.
`allow_symlinked_codex_home`	`boolean`	Sous macOS, autorise le bac à sable à suivre les liens symboliques pour les racines accessibles en écriture qui correspondent à `$CODEX_HOME` ou se trouvent sous ce répertoire. Codex lit ce paramètre au démarrage, uniquement dans le fichier `$CODEX_HOME/config.toml` de l’hôte d’exécution. En l’activant, vous faites confiance aux cibles situées hors de ce répertoire et à celles qui changent entre deux commandes. Ce paramètre n’ajoute aucune racine accessible en écriture. La valeur par défaut est `false`.
`analytics.enabled`	`boolean`	Active ou désactive la collecte de données analytiques pour cette machine ou ce profil. La valeur `false` désactive l’exportateur de métriques Statsig intégré. Les exportateurs de métriques OTLP configurés explicitement restent actifs. Si vous omettez ce paramètre, le client utilise son réglage par défaut.
`approval_policy`	`on-request \| never \| { granular = { sandbox_approval = bool, rules = bool, mcp_elicitations = bool, request_permissions = bool, skill_approval = bool } }`	Détermine dans quels cas Codex attend votre approbation avant d’exécuter une commande. Utilisez `approval_policy = { granular = { ... } }` pour préciser, pour certaines catégories de demandes, si Codex peut les afficher ou doit les rejeter automatiquement. Les autres demandes restent interactives. Codex ne prend pas en charge `untrusted`, et `on-failure` est obsolète. Utilisez `on-request` pour les exécutions interactives ou `never` pour les exécutions non interactives.
`approval_policy.granular.mcp_elicitations`	`boolean`	Avec `true`, Codex peut afficher les demandes d’élicitation MCP au lieu de les rejeter automatiquement.
`approval_policy.granular.request_permissions`	`boolean`	Avec `true`, Codex peut afficher les demandes émises par l’outil `request_permissions`.
`approval_policy.granular.rules`	`boolean`	Avec `true`, Codex peut afficher les demandes d’approbation déclenchées par les règles `prompt` d’execpolicy.
`approval_policy.granular.sandbox_approval`	`boolean`	Avec `true`, Codex peut vous demander l’autorisation d’exécuter une commande au-delà des restrictions du bac à sable.
`approval_policy.granular.skill_approval`	`boolean`	Avec `true`, Codex peut vous demander d’approuver l’exécution de scripts de skills.
`approvals_reviewer`	`user \| auto_review`	Détermine qui examine les demandes d’approbation admissibles avec la politique `on-request` ou une politique d’approbation granulaire. La valeur par défaut est `user`. Avec `auto_review`, le sous-agent chargé de la révision examine ces demandes. Ce paramètre ne modifie pas les restrictions du bac à sable et ne soumet pas à révision les actions qui y sont déjà autorisées.
`apps._default.approvals_reviewer`	`user \| auto_review`	Détermine qui examine par défaut les demandes d’approbation des outils d’application, sauf réglage propre à l’application. Si ce paramètre est omis, les applications héritent de la valeur du paramètre de premier niveau `approvals_reviewer`.
`apps._default.default_tools_approval_mode`	`auto \| prompt \| writes \| approve`	Mode d’approbation par défaut des outils d’application en l’absence de réglage propre à l’application ou à l’outil.
`apps._default.destructive_enabled`	`boolean`	Autorise ou interdit par défaut les outils d’application qui déclarent `destructive_hint = true`.
`apps._default.enabled`	`boolean`	Détermine si les applications sont activées par défaut, sauf réglage propre à une application.
`apps._default.open_world_enabled`	`boolean`	Autorise ou interdit par défaut les outils d’application qui déclarent `open_world_hint = true`.
`apps.<id>.approvals_reviewer`	`user \| auto_review`	Détermine qui examine les demandes d’approbation des outils de cette application. Ce réglage prévaut sur `apps._default.approvals_reviewer`.
`apps.<id>.default_tools_approval_mode`	`auto \| prompt \| writes \| approve`	Mode d’approbation par défaut des outils de cette application, sauf réglage propre à l’outil.
`apps.<id>.default_tools_enabled`	`boolean`	Détermine si les outils de cette application sont activés par défaut, sauf réglage propre à l’outil.
`apps.<id>.destructive_enabled`	`boolean`	Autorise ou bloque les outils de cette application qui déclarent `destructive_hint = true`.
`apps.<id>.enabled`	`boolean`	Active ou désactive une application ou un connecteur selon son identifiant (par défaut : true).
`apps.<id>.omit_tools_from`	`array<string>`	Exclut les outils de cette application des interfaces `direct`, `deferred` ou `code_mode`. Les exclusions de l’application et celles du serveur MCP se cumulent.
`apps.<id>.open_world_enabled`	`boolean`	Autorise ou bloque les outils de cette application qui déclarent `open_world_hint = true`.
`apps.<id>.tools.<tool>.approval_mode`	`auto \| prompt \| writes \| approve`	Redéfinit le mode d’approbation d’un outil de l’application.
`apps.<id>.tools.<tool>.enabled`	`boolean`	Redéfinit l’état d’activation d’un outil de l’application (par exemple `repos/list`).
`auto_review.policy`	`string`	Texte Markdown qui remplace la politique par défaut de la fonctionnalité Révision automatique. Le paramètre géré `guardian_policy_config` est prioritaire. Les valeurs vides sont ignorées.
`background_terminal_max_timeout`	`number`	Durée maximale d’attente en millisecondes pour chaque appel `write_stdin` sans entrée qui interroge le terminal en arrière-plan. La valeur par défaut est de `300000` millisecondes (5 minutes). Ce paramètre remplace l’ancienne clé `background_terminal_timeout`.
`browser_use.allow_history_access`	`boolean`	Définissez ce paramètre sur `false` pour restreindre l’accès à l’historique de navigation. Les exigences gérées peuvent imposer cette restriction.
`browser_use.default_origin_policy`	`table`	Restrictions que le navigateur applique par défaut aux origines. Les champs `access`, `uploads`, `downloads` et `full_cdp_access` acceptent chacun `allow` ou `deny`.
`browser_use.origins.<origin>`	`table`	Restrictions du navigateur propres à une origine. Les champs sont les mêmes que pour `browser_use.default_origin_policy`. Indiquez le schéma HTTP ou HTTPS et, si nécessaire, le port. Omettez le chemin, la chaîne de requête et le fragment. Les valeurs locales ne peuvent pas assouplir les interdictions imposées par les exigences gérées.
`chatgpt_base_url`	`string`	Redéfinit l’URL de base utilisée lors de la connexion à ChatGPT.
`check_for_update_on_startup`	`boolean`	Recherche les mises à jour de Codex au démarrage. Utilisez false uniquement si les mises à jour sont gérées de manière centralisée.
`cli_auth_credentials_store`	`file \| keyring \| auto \| ephemeral`	Détermine où la CLI conserve les identifiants mis en cache.
`compact_prompt`	`string`	Prompt défini directement dans la configuration pour remplacer le prompt de compactage de l’historique.
`computer_use.default_app_access`	`allow \| deny`	Politique d’accès par défaut aux applications natives pour la fonctionnalité Utilisation de l’ordinateur. Une entrée propre à une application peut définir sa politique d’accès. La configuration locale ne peut pas assouplir les restrictions imposées par les exigences gérées.
`computer_use.macos.bundle_ids`	`map<string, allow \| deny>`	Accès aux applications natives macOS, par identifiant de bundle.
`computer_use.windows.always_allowed_app_ids`	`array<string>`	Identifiants des applications Windows que la fonctionnalité Utilisation de l’ordinateur peut ouvrir sans demander d’approbation. L’ouverture des applications absentes de cette liste nécessite une approbation. Pour supprimer une entrée enregistrée, ouvrez les paramètres d’Utilisation de l’ordinateur dans l’application de bureau ChatGPT.
`computer_use.windows.aumids`	`map<string, allow \| deny>`	Accès aux applications Windows distribuées en package, selon leur identifiant Application User Model ID (AUMID).
`computer_use.windows.exes`	`array<table>`	Règles d’accès aux exécutables Windows. Chaque règle exige `publisher_name`, `product_name` et `access` (`allow` ou `deny`). Le champ `binary_name` est facultatif.
`default_permissions`	`string`	Nom du profil d’autorisations par défaut à appliquer aux appels d’outils en bac à sable. Les profils intégrés sont `:read-only`, `:workspace` et `:danger-full-access`. Chaque nom de profil personnalisé doit correspondre à une table `[permissions.<name>]`. Ne combinez ce paramètre ni avec `sandbox_mode` ni avec `[sandbox_workspace_write]`.
`desktop.custom_file_handlers.<id>`	`table`	Ce paramètre se définit uniquement dans la configuration utilisateur. Il ajoute une destination au menu Ouvrir dans de l’application de bureau ChatGPT. Consultez la section Ajouter des gestionnaires de fichiers personnalisés pour voir des exemples et connaître les contraintes applicables aux identifiants des gestionnaires.
`desktop.custom_file_handlers.<id>.args`	`array<string>`	Arguments insérés entre la commande et le fichier fourni en entrée (par défaut : `[]`).
`desktop.custom_file_handlers.<id>.command`	`string`	Chemin de l’exécutable ou nom de la commande à détecter et à lancer. Obligatoire.
`desktop.custom_file_handlers.<id>.icon`	`string`	Source de l’icône du gestionnaire (obligatoire) : chemin d’une ressource fournie avec l’application, URL `data:image/...` encodée en Base64, URI de fichier ou chemin local absolu. Si la source n’est pas prise en charge, l’application affiche l’icône VS Code par défaut.
`desktop.custom_file_handlers.<id>.input`	`path \| json_argument \| json_stdin`	Indique comment l’application transmet le fichier au gestionnaire (par défaut : `path`).
`desktop.custom_file_handlers.<id>.label`	`string`	Nom affiché dans les menus Ouvrir dans. Obligatoire.
`desktop.custom_file_handlers.<id>.supports_ssh`	`boolean`	Propose le gestionnaire pour les fichiers des espaces de travail SSH (par défaut : `false`).
`developer_instructions`	`string`	Instructions supplémentaires du développeur que Codex ajoute à la session (paramètre facultatif).
`disable_paste_burst`	`boolean`	Ancien paramètre utilisé en l’absence de `tui.disable_paste_burst`. Privilégiez le paramètre de la section `[tui]`.
`experimental_compact_prompt_file`	`string (path)`	Charge depuis un fichier le prompt qui remplace le prompt de compactage par défaut (expérimental).
`experimental_use_unified_exec_tool`	`boolean`	Ancien nom du paramètre d’activation de l’exécution unifiée. Privilégiez `[features].unified_exec` ou `codex --enable unified_exec`.
`features.apps`	`boolean`	Active les intégrations d’applications (connecteurs). Cette fonctionnalité est stable et activée par défaut. Le trafic des applications et des connecteurs n’est soumis ni au proxy réseau des commandes exécutées en bac à sable ni à sa liste de domaines autorisés.
`features.code_mode.direct_only_tool_namespaces`	`array<string>`	Espaces de noms d’outils que le mode code peut utiliser uniquement par des appels d’outils directs.
`features.code_mode.enabled`	`boolean`	Active la configuration du mode code. Cette fonctionnalité est en cours de développement et désactivée par défaut.
`features.code_mode.excluded_tool_namespaces`	`array<string>`	Espaces de noms d’outils que le mode code exclut des instructions sur les appels d’outils imbriqués et de l’ensemble des outils accessibles à l’exécuteur.
`features.context_management.experimental_mode`	`boolean`	Paramètre expérimental de gestion du contexte. Cette fonctionnalité est actuellement indisponible.
`features.enable_request_compression`	`boolean`	Compresse avec zstd le corps des requêtes en streaming lorsque cette compression est prise en charge (fonctionnalité stable, activée par défaut).
`features.fast_mode`	`boolean`	Active les commandes du mode Rapide proposées par le modèle actif, indépendamment de `features.ultrafast_mode` (fonctionnalité stable, activée par défaut). La disponibilité de ces commandes dépend toujours du modèle et du compte.
`features.goals`	`boolean`	Active les objectifs persistants et la poursuite automatique du travail (fonctionnalité stable, activée par défaut).
`features.hooks`	`boolean`	Active les hooks de cycle de vie chargés depuis `hooks.json` ou définis directement dans la section `[hooks]` de la configuration. `features.codex_hooks` est un alias obsolète.
`features.memories`	`boolean`	Active les Mémoires (désactivées par défaut).
`features.multi_agent`	`boolean`	Active les outils de collaboration entre agents (`spawn_agent`, `send_input`, `resume_agent`, `wait_agent` et `close_agent`). Cette fonctionnalité stable est activée par défaut.
`features.network_proxy`	`boolean \| table`	Démarre le proxy réseau pour les commandes exécutées en bac à sable (fonctionnalité expérimentale, désactivée par défaut). Activez ce paramètre pour appliquer les règles de domaine des profils d’autorisations, sauf si les exigences `network_proxy` gérées par l’administrateur sont activées et démarrent le proxy. Utilisez une table pour définir des options de politique propres à cette fonctionnalité, telles que `domains`. Le proxy ne filtre ni la recherche web, ni les applications, ni MCP, ni les autres outils hébergés.
`features.network_proxy.allow_local_binding`	`boolean`	Autorise un accès plus large aux réseaux locaux ou privés. La valeur par défaut est `false`. Vous pouvez néanmoins autoriser l’accès à des cibles locales précises en indiquant une adresse IP locale sous sa forme littérale exacte ou `localhost` dans une règle d’autorisation.
`features.network_proxy.allow_upstream_proxy`	`boolean`	Autorise le passage par un proxy amont défini dans l’environnement. Valeur par défaut : `true`.
`features.network_proxy.dangerously_allow_all_unix_sockets`	`boolean`	Autorise l’accès à tout socket Unix, même s’il ne figure pas dans la liste d’autorisation. La valeur par défaut est `false`. Utilisez ce paramètre uniquement dans des environnements strictement contrôlés.
`features.network_proxy.dangerously_allow_non_loopback_proxy`	`boolean`	Autorise le proxy à écouter sur des adresses autres que les adresses de bouclage. La valeur par défaut est `false`. L’activation de ce paramètre peut rendre les ports d’écoute du proxy accessibles au-delà de localhost.
`features.network_proxy.domains`	`map<string, allow \| deny>`	Règles d’accès aux domaines depuis le bac à sable. Ce paramètre n’a pas de valeur par défaut. Aucune destination externe n’est autorisée tant que vous n’ajoutez pas de règle `allow`. Vous pouvez indiquer un nom d’hôte exact, `.example.com` pour les sous-domaines uniquement, `.example.com` pour le domaine lui-même et ses sous-domaines, ou `` pour une règle d’autorisation globale. Privilégiez les règles ciblées, car `*` autorise largement les connexions sortantes vers le réseau public. Ajoutez des règles `deny` pour bloquer des destinations. En cas de conflit, `deny` l’emporte.
`features.network_proxy.enable_socks5`	`boolean`	Active la prise en charge de SOCKS5. Valeur par défaut : `true`.
`features.network_proxy.enable_socks5_udp`	`boolean`	Autorise UDP sur SOCKS5. Valeur par défaut : `true`.
`features.network_proxy.enabled`	`boolean`	Démarre le proxy réseau pour les commandes exécutées en bac à sable lorsque leur accès au réseau est activé. La valeur par défaut est `false`. Tant que le proxy est désactivé, les règles de domaine des profils d’autorisations ne s’appliquent pas.
`features.network_proxy.proxy_url`	`string`	URL d’écoute HTTP pour le réseau du bac à sable. Valeur par défaut : `"http://127.0.0.1:3128"`.
`features.network_proxy.socks_url`	`string`	URL d’écoute SOCKS5. Valeur par défaut : `"http://127.0.0.1:8081"`.
`features.network_proxy.unix_sockets`	`map<string, allow \| deny>`	Règles d’accès aux sockets Unix depuis le bac à sable. Aucune valeur n’est définie par défaut. Ajoutez une entrée `allow` pour chaque socket autorisé.
`features.personality`	`boolean`	Indicateur de fonctionnalité supprimé. Codex l’accepte pour des raisons de compatibilité et l’ignore.
`features.prefer_mxc`	`boolean`	Privilégie MXC pour l’exécution locale sous Windows lorsque les capacités natives et la politique le permettent. Sinon, Codex conserve l’ancien bac à sable et sa configuration. Ce paramètre est désactivé par défaut dans la CLI autonome. L’application de bureau ChatGPT peut l’activer via sa configuration de déploiement. L’échec d’une commande ne déclenche pas de retour à l’ancien bac à sable.
`features.prevent_idle_sleep`	`boolean`	Empêche la mise en veille de la machine pendant l’exécution d’un tour (fonctionnalité expérimentale, désactivée par défaut).
`features.remote_plugin`	`boolean`	Active le catalogue distant de plugins (fonctionnalité stable, activée par défaut).
`features.rollout_budget.enabled`	`boolean`	Active le suivi du budget de tokens d’une exécution. Cette fonctionnalité est en cours de développement et désactivée par défaut. Si vous l’activez, définissez à la fois `limit_tokens` et `reminder_at_remaining_tokens`.
`features.rollout_budget.limit_tokens`	`integer`	Nombre maximal de tokens pour le suivi du budget d’exécution. Cette limite doit être strictement positive et doit être définie si le suivi est activé.
`features.rollout_budget.prefill_token_weight`	`number`	Coefficient fini, positif ou nul, appliqué aux tokens de préremplissage dans le calcul du budget d’exécution. La valeur par défaut est `1.0`.
`features.rollout_budget.reminder_at_remaining_tokens`	`array<integer>`	Envoie un rappel chaque fois que le budget restant en tokens pondérés franchit l’un des seuils. Fournissez cette liste si le suivi du budget d’exécution est activé. Chaque valeur doit être strictement positive et inférieure à `limit_tokens`.
`features.rollout_budget.sampling_token_weight`	`number`	Coefficient fini, positif ou nul, appliqué aux tokens échantillonnés dans le calcul du budget d’exécution. La valeur par défaut est `1.0`.
`features.shell_snapshot`	`boolean`	Crée un instantané de l’environnement du shell pour accélérer l’exécution des commandes répétées (fonctionnalité stable, activée par défaut).
`features.shell_tool`	`boolean`	Active les outils d’exécution de commandes (fonctionnalité stable, activée par défaut).
`features.skill_mcp_dependency_install`	`boolean`	Permet à Codex de proposer l’installation des dépendances MCP manquantes pour les skills et de les installer (fonctionnalité stable, activée par défaut).
`features.ultrafast_mode`	`boolean`	Active les commandes du mode Ultrarapide, indépendamment de `features.fast_mode` (fonctionnalité stable, activée par défaut). La disponibilité de ces commandes dépend toujours du modèle et du compte.
`features.unified_exec`	`boolean`	Permet de reprendre l’exécution des commandes (fonctionnalité stable, activée sur toutes les plateformes). Codex ignore les demandes de désactivation des utilisateurs. Les exigences gérées peuvent désactiver les processus dont l’exécution peut être reprise ainsi que `write_stdin`. Dans ce cas, `exec_command` reste disponible pour exécuter une commande en une seule étape.
`features.view_image`	`boolean`	Active l’outil intégré `view_image` pour ouvrir des images locales. Valeur par défaut : `true`.
`features.web_search`	`boolean`	Paramètre obsolète. Privilégiez le paramètre de premier niveau `web_search`.
`features.web_search_cached`	`boolean`	Paramètre obsolète. Si `web_search` est absent, la valeur true correspond à `web_search = "cached"`.
`features.web_search_request`	`boolean`	Paramètre obsolète. Si `web_search` est absent, la valeur true correspond à `web_search = "live"`.
`feedback.enabled`	`boolean`	Autorise l’envoi de retours via `/feedback` depuis tous les clients locaux (par défaut : true).
`file_opener`	`vscode \| vscode-insiders \| windsurf \| cursor \| none`	Schéma d’URI utilisé pour ouvrir les références citées dans les sorties de Codex (par défaut : `vscode`).
`forced_chatgpt_workspace_id`	`string (uuid)`	Limite les connexions à ChatGPT à l’espace de travail désigné par cet identifiant.
`forced_login_method`	`chatgpt \| api`	Limite Codex à une méthode d’authentification précise.
`goals.max_goal_token_budget`	`integer (positive)`	Définit à la fois le budget de tokens par défaut des nouveaux objectifs et le budget maximal qu’un objectif peut demander. Omettez ce paramètre pour ne fixer aucune limite aux objectifs.
`hide_agent_reasoning`	`boolean`	Masque les événements de raisonnement dans l’interface du terminal et dans la sortie de `codex exec`.
`history.max_bytes`	`number`	Si vous définissez ce paramètre, Codex limite la taille du fichier d’historique au nombre d’octets indiqué en supprimant les entrées les plus anciennes.
`history.persistence`	`save-all \| none`	Détermine si Codex enregistre les transcriptions de session dans history.jsonl.
`hooks`	`table`	Hooks de cycle de vie définis directement dans `config.toml`. Ils utilisent le même schéma d’événements que `hooks.json`. Consultez le guide des hooks pour voir des exemples et la liste des événements pris en charge.
`hooks.<Event>`	`array<table>`	Groupes de critères de correspondance pour des événements de hook tels que `PreModelRequest`, `PostModelRequest`, `PreToolUse`, `PermissionRequest`, `PostToolUse`, `PreCompact`, `PostCompact`, `SessionStart`, `SessionEnd`, `SubagentStart`, `SubagentStop`, `UserPromptSubmit`, `Stop` ou `Interrupt`.
`hooks.<Event>[].hooks`	`array<table>`	Gestionnaires de hooks pour un groupe de critères de correspondance. Codex prend en charge les hooks de commande et d’outil MCP. Il analyse les gestionnaires de hooks de prompt et d’agent sans les exécuter.
`hooks.<Event>[].hooks[].additionalContextLimit`	`integer`	Seuil approximatif en tokens, propre à chaque gestionnaire, au-delà duquel Codex enregistre `additionalContext` sur disque et présente un aperçu plus court au modèle. La valeur par défaut est `2500`. Avec `0`, le modèle reçoit directement tout le contexte. Consultez Sorties volumineuses des hooks.
`hooks.<Event>[].hooks[].async`	`boolean`	Exécute un hook de commande en arrière-plan sans retarder l’opération qui le déclenche. La valeur par défaut est `false`. Les hooks `SessionEnd` s’exécutent toujours de façon synchrone. Consultez Exécuter des hooks en arrière-plan.
`hooks.<Event>[].hooks[].commandWindows`	`string`	Commande de remplacement propre à Windows pour les hooks de commande. L’alias TOML `command_windows` est également accepté.
`instructions`	`string`	Réservé à un usage futur. Privilégiez `model_instructions_file` ou `AGENTS.md`.
`log_dir`	`string (path)`	Répertoire où Codex écrit les fichiers journaux. La valeur par défaut est `$CODEX_HOME/log`. Si vous définissez explicitement ce paramètre, Codex y écrit également `codex-tui.log`, le journal facultatif en texte brut de l’interface du terminal.
`marketplaces.<name>.ref`	`string`	Référence Git facultative pour la marketplace (branche, tag ou commit).
`marketplaces.<name>.source`	`string`	Emplacement du dépôt Git ou répertoire racine de la marketplace locale. Pour une source locale, utilisez le chemin absolu du répertoire qui contient .agents/plugins/marketplace.json.
`marketplaces.<name>.source_type`	`git \| local`	Type de source d’une marketplace de plugins configurée. Vous pouvez définir une marketplace dans le fichier config.toml du système, de l’utilisateur ou d’un projet de confiance, ou dans le fichier config.toml géré dans le cloud.
`marketplaces.<name>.sparse_paths`	`array<string>`	Chemins facultatifs pour une extraction partielle d’une marketplace Git. Incluez le catalogue de la marketplace et tous les répertoires de plugins locaux auxquels ce catalogue fait référence.
`mcp_oauth_callback_port`	`integer`	Port fixe global facultatif du serveur HTTP local qui reçoit le rappel lors de la connexion OAuth MCP. Le paramètre `oauth.callback_port` propre au serveur est prioritaire. Si aucun des deux paramètres n’est défini, Codex écoute sur un port éphémère choisi par le système d’exploitation.
`mcp_oauth_callback_url`	`string`	URL de rappel de base facultative pour la connexion OAuth MCP, par exemple l’URL d’entrée d’une devbox. Lorsque le serveur d’autorisation prend en charge l’identification de l’émetteur, les clients préenregistrés nouvellement ajoutés utilisent cette URL telle quelle. Les clients existants sans URL de rappel enregistrée y ajoutent un identifiant de rappel propre au serveur. Si le serveur d’autorisation ne prend pas en charge l’identification de l’émetteur, tout serveur MCP préenregistré dont l’URL de rappel configurée ne contient pas l’identifiant requis utilise à la place l’URL de base suivie de cet identifiant. Le port indiqué dans l’URL de rappel ne détermine pas le port d’écoute.
`mcp_oauth_credentials_store`	`auto \| file \| keyring`	Emplacement de stockage privilégié pour les identifiants OAuth utilisés avec MCP.
`mcp_optional_startup_grace_ms`	`integer (milliseconds)`	Délai d’attente commun aux serveurs MCP facultatifs lors de la création du catalogue initial d’outils. La valeur par défaut est `1000`. Utilisez `0` pour appliquer à chaque serveur son propre délai `startup_timeout_sec`.
`mcp_servers.<id>.args`	`array<string>`	Arguments transmis à la commande de lancement du serveur MCP stdio.
`mcp_servers.<id>.auth`	`oauth \| chatgpt`	Méthode d’authentification de repli pour un serveur MCP HTTP. Les jetons porteurs et les en-têtes d’autorisation configurés sont prioritaires. `oauth` (par défaut) utilise les identifiants OAuth MCP enregistrés s’ils sont disponibles. `chatgpt` utilise la session ChatGPT en cours pour l’origine de confiance exploitée par ChatGPT, puis se replie si nécessaire sur les identifiants OAuth enregistrés. Dans les deux modes, la connexion peut s’établir sans authentification si aucune source ne fournit d’identifiants.
`mcp_servers.<id>.bearer_token_env_var`	`string`	Variable d’environnement qui contient le jeton porteur utilisé pour accéder au serveur MCP via HTTP.
`mcp_servers.<id>.command`	`string`	Commande de lancement d’un serveur MCP stdio.
`mcp_servers.<id>.cwd`	`string`	Répertoire de travail du processus du serveur MCP stdio.
`mcp_servers.<id>.default_tools_approval_mode`	`auto \| prompt \| writes \| approve`	Mode d’approbation par défaut des outils MCP de ce serveur. Un réglage propre à un outil est prioritaire pour cet outil.
`mcp_servers.<id>.disabled_tools`	`array<string>`	Liste des outils interdits pour ce serveur MCP. Elle s’applique après `enabled_tools`.
`mcp_servers.<id>.enabled`	`boolean`	Permet de désactiver un serveur MCP sans supprimer sa configuration.
`mcp_servers.<id>.enabled_tools`	`array<string>`	Liste des noms d’outils que le serveur MCP est autorisé à exposer.
`mcp_servers.<id>.env`	`map<string,string>`	Variables d’environnement transmises au serveur MCP stdio.
`mcp_servers.<id>.env_http_headers`	`map<string,string>`	En-têtes HTTP dont les valeurs proviennent de variables d’environnement pour un serveur MCP HTTP.
`mcp_servers.<id>.env_vars`	`array<string \| { name = string, source = "local" \| "remote" }>`	Variables d’environnement supplémentaires à autoriser pour un serveur MCP stdio. Les entrées de type chaîne utilisent `source = "local"` par défaut. Utilisez `source = "remote"` uniquement si un exécuteur gère le transport stdio distant.
`mcp_servers.<id>.environment_id`	`string`	Environnement d’exécution du serveur MCP. La valeur par défaut est `local`. Utilisez l’identifiant d’un exécuteur configuré pour y lancer un serveur stdio ou pour vous connecter depuis cet environnement à un serveur HTTP prenant en charge le streaming.
`mcp_servers.<id>.http_headers`	`map<string,string>`	En-têtes HTTP statiques inclus dans chaque requête HTTP adressée au serveur MCP.
`mcp_servers.<id>.http_headers_helper`	`string (command)`	Commande locale qui écrit sur la sortie standard un objet JSON associant chaque nom d’en-tête HTTP à sa valeur. Seuls les serveurs MCP HTTP connectés localement prennent en charge cette commande. Les jetons porteurs explicitement configurés et les identifiants OAuth ont priorité sur les en-têtes Authorization fournis par la commande.
`mcp_servers.<id>.oauth_resource`	`string`	Paramètre de ressource OAuth facultatif conforme à la RFC 8707 à inclure lors de la connexion MCP.
`mcp_servers.<id>.oauth.callback_port`	`integer`	Port d’écoute fixe pour le rappel OAuth de ce serveur MCP. Ce réglage prévaut sur `mcp_oauth_callback_port`. Si l’URL d’un rappel direct sur l’interface de bouclage indique explicitement un port, configurez ce même port comme port d’écoute.
`mcp_servers.<id>.oauth.callback_url`	`string`	URL de rappel OAuth propre au serveur. Les clients préenregistrés la réutilisent si l’identification de l’émetteur est prise en charge ou si l’URL se termine déjà par l’identifiant de rappel propre au serveur. Sinon, Codex ajoute cet identifiant à la fin de l’URL de rappel globale ou par défaut et utilise l’URL ainsi obtenue. Les clients sans identifiant préenregistré utilisent l’URL de rappel propre au serveur lors de leur enregistrement.
`mcp_servers.<id>.oauth.client_id`	`string`	Identifiant client OAuth préenregistré utilisé pour l’autorisation et l’échange de jetons avec ce serveur MCP.
`mcp_servers.<id>.oauth.client_secret`	`string`	Secret client OAuth pour l’échange de jetons avec un client préenregistré. Renseignez `oauth.client_id` et le secret avec des valeurs non vides. Le secret est stocké dans la configuration.
`mcp_servers.<id>.omit_tools_from`	`array<string>`	Masque les outils de ce serveur dans les interfaces sélectionnées auxquelles le modèle a accès. Choisissez `direct` (outils disponibles dès le départ), `deferred` (recherche d’outils) ou `code_mode` (scripts du mode code). Utilisez `disabled_tools` pour bloquer un outil. Une liste vide efface les exclusions héritées.
`mcp_servers.<id>.required`	`boolean`	Si ce serveur est activé, exige qu’il soit prêt au démarrage. Avec `startup_readiness = "catalog"`, un catalogue valide en cache peut satisfaire cette exigence.
`mcp_servers.<id>.scopes`	`array<string>`	Portées OAuth à demander lors de la connexion. Si vous omettez ce paramètre, Codex utilise les portées du défi d’authentification initial ou, à défaut, celles des métadonnées de la ressource protégée.
`mcp_servers.<id>.startup_readiness`	`connection \| catalog`	Avec `connection` (valeur par défaut), Codex attend que la connexion soit établie pour considérer le serveur comme prêt au démarrage. Avec `catalog`, un catalogue d’outils valide en cache suffit pendant que la connexion s’établit. L’appel d’un outil nécessite toujours une connexion active.
`mcp_servers.<id>.startup_timeout_ms`	`number`	Alias de `startup_timeout_sec` exprimé en millisecondes.
`mcp_servers.<id>.startup_timeout_sec`	`number`	Fixe le délai maximal de démarrage du serveur MCP. Le délai par défaut est de 10 secondes.
`mcp_servers.<id>.supports_parallel_tool_calls`	`boolean`	Indique que tous les outils de ce serveur peuvent être exécutés en parallèle en toute sécurité. Activez ce paramètre uniquement si le serveur peut traiter des appels simultanés à tous ses outils. La valeur par défaut est `false`.
`mcp_servers.<id>.tool_input_schema_max_bytes`	`integer (positive)`	Compacte le schéma d’entrée de chaque outil MCP ordinaire si sa taille en octets UTF-8 dépasse ce seuil. La valeur par défaut est de 5 000 octets. Si vous indiquez une valeur, le mode code l’utilise aussi pour afficher les types d’entrée des outils.
`mcp_servers.<id>.tool_timeout_sec`	`number`	Fixe le délai maximal pour chaque appel d’outil du serveur MCP. Le délai par défaut est de 60 secondes.
`mcp_servers.<id>.tools.<tool>.approval_mode`	`auto \| prompt \| writes \| approve`	Redéfinit le mode d’approbation pour un outil MCP de ce serveur.
`mcp_servers.<id>.tools.<tool>.output_token_limit`	`integer (positive)`	Budget de tokens pour la sortie d’un outil MCP, avant l’ajout de la marge standard de 20 % prévue pour la sérialisation. Cette valeur remplace le seuil de troncature que le modèle applique par défaut à la sortie de cet outil.
`mcp_servers.<id>.url`	`string`	Point de terminaison d’un serveur MCP utilisant le transport HTTP en streaming.
`memories.consolidation_model`	`string`	Modèle de remplacement facultatif pour la consolidation globale des mémoires.
`memories.consolidation_service_tier`	`string`	Offre utilisée pour la consolidation globale des mémoires. Valeur par défaut : `default` (Standard).
`memories.disable_on_external_context`	`boolean`	Avec `true`, Codex exclut de la génération de mémoires les fils qui utilisent un contexte externe, par exemple via des appels d’outils MCP, la recherche web ou la recherche d’outils. Valeur par défaut : `false`. Ancien alias : `memories.no_memories_if_mcp_or_web_search`.
`memories.dual_write`	`boolean`	Si `v1` est la version sélectionnée, réglez ce paramètre sur `true` pour que Codex alimente les deux stockages tout en continuant à lire les mémoires dans `v1`. Si `v2` est la version sélectionnée, Codex écrit uniquement dans `v2`.
`memories.extract_model`	`string`	Modèle de remplacement facultatif pour extraire les mémoires de chaque fil.
`memories.generate_memories`	`boolean`	Avec `false`, Codex n’enregistre pas les nouveaux fils comme sources pour la génération de mémoires. Valeur par défaut : `true`.
`memories.max_raw_memories_for_consolidation`	`number`	Nombre maximal de mémoires brutes récentes conservées pour la consolidation globale. Valeur par défaut : `256`. Plafond : `4096`.
`memories.max_rollout_age_days`	`number`	Âge maximal, en jours, des fils pris en compte pour la génération de mémoires. Valeur par défaut : `30`. Codex ramène toute valeur hors de l’intervalle de `0` à `90` à la borne la plus proche.
`memories.max_rollouts_per_startup`	`number`	Nombre maximal de fils candidats que Codex traite à chaque passe de démarrage. Valeur par défaut : `16`. Plafond : `128`.
`memories.max_unused_days`	`number`	Délai maximal, en jours, depuis la dernière utilisation d’une mémoire. Au-delà de ce délai, Codex exclut la mémoire de la consolidation. Valeur par défaut : `30`. Codex ramène toute valeur hors de l’intervalle de `0` à `365` à la borne la plus proche.
`memories.min_rate_limit_remaining_percent`	`number`	Pourcentage minimal de quota qui doit rester disponible dans chaque fenêtre de limite de débit de Codex pour que la génération de mémoires démarre. Valeur par défaut : `25`. Codex ramène toute valeur hors de l’intervalle de `0` à `100` à la borne la plus proche.
`memories.min_rollout_idle_hours`	`number`	Durée minimale d’inactivité, en heures, avant que Codex prenne un fil en compte pour la génération de mémoires. Valeur par défaut : `6`. Codex ramène toute valeur hors de l’intervalle de `1` à `48` à la borne la plus proche.
`memories.use_memories`	`boolean`	Avec `false`, Codex n’ajoute pas les mémoires existantes au contexte des sessions futures. Valeur par défaut : `true`.
`memories.version`	`v1 \| v2`	Sélectionne le stockage local des mémoires. Lorsque les mémoires sont activées, Codex utilise par défaut `v2` pour un nouveau répertoire d’accueil de Codex et `v1` si `$CODEX_HOME/memories/` existe. Si vous indiquez explicitement `dual_write = false`, la valeur par défaut reste `v1`.
`model`	`string`	Modèle à utiliser (par exemple `gpt-6.1-sol`).
`model_auto_compact_token_limit`	`number`	Seuil de tokens qui déclenche le compactage automatique de l’historique. En l’absence de valeur, les paramètres par défaut du modèle s’appliquent.
`model_auto_compact_token_limit_scope`	`total \| body_after_prefix`	Détermine si le seuil de compactage automatique tient compte de tout le contexte actif (`total`, valeur par défaut) ou uniquement des tokens ajoutés après le préfixe conservé de la fenêtre de compactage (`body_after_prefix`).
`model_catalog_json`	`string (path)`	Chemin facultatif vers un catalogue de modèles au format JSON chargé au démarrage. Vous pouvez redéfinir ce chemin pour chaque profil dans le fichier `$CODEX_HOME/profile-name.config.toml` correspondant au profil sélectionné.
`model_context_window`	`number`	Nombre de tokens disponibles dans la fenêtre de contexte du modèle actif.
`model_instructions_file`	`string (path)`	Fichier à utiliser à la place de `AGENTS.md` pour remplacer les instructions intégrées.
`model_post_turn_compact_threshold_percent`	`integer (0–100)`	Codex compacte l’historique après la réponse finale si le contexte actif atteint ce pourcentage de la fenêtre de contexte utilisable. Omettez ce paramètre ou réglez-le sur `0` pour désactiver le compactage en fin de tour. Les limites habituelles du compactage automatique continuent de s’appliquer.
`model_provider`	`string`	Identifiant du fournisseur dans `model_providers` (par défaut : `openai`).
`model_providers.<id>`	`table`	Définition d’un fournisseur de modèles personnalisé. Les identifiants des fournisseurs intégrés (`openai`, `ollama` et `lmstudio`) sont réservés et ne peuvent pas être redéfinis.
`model_providers.<id>.auth`	`table`	Configure la commande qui fournit un jeton porteur pour un fournisseur personnalisé. Ne combinez pas ce paramètre avec `env_key`, `experimental_bearer_token` ou `requires_openai_auth`.
`model_providers.<id>.auth.args`	`array<string>`	Arguments transmis à la commande d’obtention du jeton.
`model_providers.<id>.auth.command`	`string`	Commande que Codex exécute lorsqu’il a besoin d’un jeton porteur. Elle doit écrire le jeton sur la sortie standard.
`model_providers.<id>.auth.cwd`	`string (path)`	Répertoire de travail de la commande d’obtention du jeton.
`model_providers.<id>.auth.refresh_interval_ms`	`number`	Intervalle en millisecondes entre deux renouvellements anticipés du jeton par Codex (par défaut : 300000). Utilisez `0` pour que Codex renouvelle le jeton uniquement après une nouvelle tentative d’authentification.
`model_providers.<id>.auth.timeout_ms`	`number`	Durée maximale d’exécution de la commande d’obtention du jeton, en millisecondes (par défaut : 5000).
`model_providers.<id>.base_url`	`string`	URL de base de l’API du fournisseur de modèles.
`model_providers.<id>.capabilities.external_web_access`	`boolean`	Indique si le service de recherche web hébergé par le fournisseur peut accéder au Web en temps réel. Omettez ce paramètre pour conserver les valeurs par défaut du fournisseur. Les paramètres du modèle et du tour peuvent restreindre davantage cet accès.
`model_providers.<id>.capabilities.remote_compaction`	`unsupported \| v2`	Protocole de compactage du fournisseur. Avec `unsupported`, le compactage s’effectue localement. Avec `v2`, Codex transmet les demandes de compactage via l’API Responses. Omettez ce paramètre pour conserver les valeurs par défaut du fournisseur. Les paramètres du modèle et du tour peuvent limiter davantage la prise en charge du compactage à distance.
`model_providers.<id>.env_http_headers`	`map<string,string>`	En-têtes HTTP renseignés à partir des variables d’environnement correspondantes lorsqu’elles sont définies.
`model_providers.<id>.env_key`	`string`	Variable d’environnement qui fournit la clé API du fournisseur.
`model_providers.<id>.env_key_instructions`	`string`	Instructions facultatives pour configurer la clé API du fournisseur.
`model_providers.<id>.experimental_bearer_token`	`string`	Jeton porteur pour l’authentification auprès du fournisseur. La saisie directe du jeton est déconseillée. Utilisez `env_key`.
`model_providers.<id>.http_headers`	`map<string,string>`	En-têtes HTTP statiques ajoutés aux requêtes envoyées au fournisseur.
`model_providers.<id>.model_catalog_url`	`string`	URL complète d’un catalogue de modèles au format natif de Codex. Omettez ce paramètre pour conserver le mécanisme de découverte des modèles que le fournisseur utilise par défaut.
`model_providers.<id>.name`	`string`	Nom affiché pour un fournisseur de modèles personnalisé.
`model_providers.<id>.query_params`	`map<string,string>`	Paramètres de requête supplémentaires ajoutés à l’URL des requêtes envoyées au fournisseur.
`model_providers.<id>.request_max_retries`	`number`	Nombre de nouvelles tentatives pour les requêtes HTTP envoyées au fournisseur (par défaut : 4).
`model_providers.<id>.requires_openai_auth`	`boolean`	Indique si le fournisseur utilise l’authentification OpenAI (par défaut : false).
`model_providers.<id>.stream_idle_timeout_ms`	`number`	Délai maximal d’inactivité d’un flux SSE, en millisecondes (par défaut : 300000).
`model_providers.<id>.stream_max_retries`	`number`	Nombre de nouvelles tentatives en cas d’interruption d’un flux SSE (par défaut : 5).
`model_providers.<id>.supports_standalone_web_search`	`boolean`	Signale la prise en charge d’un point de terminaison compatible pour la recherche web autonome (par défaut : false). La recherche web autonome est encore en cours de développement et reste désactivée par défaut. La compatibilité du fournisseur ne suffit pas à l’activer.
`model_providers.<id>.supports_websockets`	`boolean`	Indique si le fournisseur prend en charge le transport WebSocket de l’API Responses.
`model_providers.<id>.wire_api`	`responses`	Protocole utilisé par le fournisseur. `responses` est la seule valeur prise en charge et s’applique par défaut si vous omettez ce paramètre.
`model_providers.amazon-bedrock.aws.profile`	`string`	Nom du profil AWS utilisé par le fournisseur intégré `amazon-bedrock`.
`model_providers.amazon-bedrock.aws.region`	`string`	Région AWS utilisée par le fournisseur intégré `amazon-bedrock`.
`model_providers.gcp.base_url`	`string`	Redéfinit le point de terminaison intégré de Google Cloud Vertex AI. Si vous omettez ce paramètre, Codex construit l’URL du point de terminaison à partir de l’identifiant du projet et de l’emplacement Google Cloud.
`model_providers.gcp.credential_file`	`string (absolute path)`	Chemin du fichier Google Application Default Credentials (ADC). Ce chemin remplace la valeur de `GOOGLE_APPLICATION_CREDENTIALS` uniquement pour la commande d’authentification du fournisseur.
`model_providers.gcp.location`	`string`	Emplacement Google Cloud du point de terminaison Vertex AI. Ce paramètre est prioritaire sur `GOOGLE_CLOUD_LOCATION`. Valeur par défaut : `global`.
`model_providers.gcp.project_id`	`string`	Identifiant du projet Google Cloud pour le point de terminaison Vertex AI. Ce paramètre est prioritaire sur `GOOGLE_CLOUD_PROJECT`.
`model_reasoning_effort`	`string`	Niveau d’effort de raisonnement proposé par le modèle sélectionné, par exemple `low`, `medium`, `high`, `xhigh`, `max` ou `ultra`. Les niveaux disponibles dépendent du modèle et du client.
`model_reasoning_summary`	`auto \| concise \| detailed \| none`	Sélectionnez le niveau de détail des résumés de raisonnement ou désactivez-les entièrement.
`model_verbosity`	`low \| medium \| high`	Ce paramètre facultatif redéfinit le niveau de détail des réponses de GPT-5 dans l’API Responses. Si vous l’omettez, la valeur par défaut du modèle ou du préréglage sélectionné s’applique.
`notice.hide_full_access_warning`	`boolean`	Indique si l’utilisateur a pris connaissance de l’avertissement relatif à l’accès complet.
`notice.hide_gpt-5.1-codex-max_migration_prompt`	`boolean`	Indique si l’utilisateur a pris connaissance du message de migration vers gpt-5.1-codex-max.
`notice.hide_gpt5_1_migration_prompt`	`boolean`	Indique si l’utilisateur a pris connaissance du message de migration vers GPT-5.1.
`notice.hide_rate_limit_model_nudge`	`boolean`	Indique si l’utilisateur a désactivé le rappel qui propose de changer de modèle lorsque la limite de débit est atteinte.
`notice.hide_world_writable_warning`	`boolean`	Indique si l’utilisateur a pris connaissance de l’avertissement concernant les répertoires Windows dans lesquels tous les utilisateurs peuvent écrire.
`notice.model_migrations`	`map<string,string>`	Enregistre les migrations de modèles confirmées en associant chaque ancien modèle au nouveau.
`notify`	`array<string>`	Commande que Codex appelle pour les notifications. Codex lui transmet les données de notification au format JSON.
`openai_base_url`	`string`	URL de base à utiliser à la place de celle du fournisseur de modèles intégré `openai`.
`oss_provider`	`lmstudio \| ollama`	Fournisseur local utilisé par défaut avec `--oss`. Si ce paramètre est absent, Codex vous demande de choisir un fournisseur.
`otel.environment`	`string`	Étiquette d’environnement ajoutée aux événements OpenTelemetry émis (par défaut : `dev`).
`otel.exporter`	`none \| otlp-http \| otlp-grpc`	Sélectionnez l’exportateur OpenTelemetry et fournissez les éventuelles métadonnées du point de terminaison.
`otel.exporter.<id>.endpoint`	`string`	Point de terminaison de l’exportateur de journaux OTEL.
`otel.exporter.<id>.headers`	`map<string,string>`	En-têtes statiques inclus dans les requêtes de l’exportateur OTEL.
`otel.exporter.<id>.protocol`	`binary \| json`	Protocole utilisé par l’exportateur OTLP/HTTP.
`otel.exporter.<id>.tls.ca-certificate`	`string`	Chemin du certificat de l’autorité de certification pour les connexions TLS de l’exportateur OTEL.
`otel.exporter.<id>.tls.client-certificate`	`string`	Chemin du certificat client pour les connexions TLS de l’exportateur OTEL.
`otel.exporter.<id>.tls.client-private-key`	`string`	Chemin de la clé privée du client pour les connexions TLS de l’exportateur OTEL.
`otel.log_agent_responses`	`boolean`	Transmettez à l’exportateur de journaux OTLP configuré le texte des réponses finales de l’agent principal et des sous-agents lancés. Valeur par défaut : `false`. Ce texte peut contenir des données sensibles. Sa taille est limitée à 64 Kio par réponse.
`otel.log_guardian_assessments`	`boolean`	Transmettez à l’exportateur de journaux OTLP configuré les résultats des révisions automatiques des demandes d’approbation une fois ces révisions terminées. Valeur par défaut : `false`. Chaque justification peut contenir des données sensibles et sa taille est limitée à 64 Kio.
`otel.log_user_prompt`	`boolean`	Activez cette option pour exporter les prompts bruts des utilisateurs avec les journaux OpenTelemetry.
`otel.metrics_exporter`	`none \| statsig \| otlp-http \| otlp-grpc`	Sélectionnez l’exportateur de métriques OpenTelemetry. L’exportateur par défaut, `statsig`, exporte les métriques selon la valeur de `analytics.enabled`. Les exportateurs OTLP configurés explicitement fonctionnent indépendamment de ce paramètre. Utilisez `none` pour désactiver l’exportation des métriques.
`otel.span_attributes`	`map<string,string>`	Ajoutez des attributs de type chaîne à chaque segment de trace exporté.
`otel.tool_result.max_bytes`	`integer (nonnegative)`	Nombre maximal d’octets UTF-8 à consigner pour chaque résultat d’outil avant l’avis de troncature. Valeur par défaut : `2048`. Ce paramètre s’applique uniquement aux sorties consignées dans les journaux.
`otel.trace_exporter`	`none \| otlp-http \| otlp-grpc`	Sélectionnez l’exportateur de traces OpenTelemetry et fournissez les éventuelles métadonnées du point de terminaison.
`otel.trace_exporter.<id>.endpoint`	`string`	Point de terminaison de l’exportateur de traces pour les journaux OTEL.
`otel.trace_exporter.<id>.headers`	`map<string,string>`	En-têtes statiques inclus dans les requêtes de l’exportateur de traces OTEL.
`otel.trace_exporter.<id>.protocol`	`binary \| json`	Protocole utilisé par l’exportateur de traces OTLP/HTTP.
`otel.trace_exporter.<id>.tls.ca-certificate`	`string`	Chemin du certificat de l’autorité de certification pour les connexions TLS de l’exportateur de traces OTEL.
`otel.trace_exporter.<id>.tls.client-certificate`	`string`	Chemin du certificat client pour les connexions TLS de l’exportateur de traces OTEL.
`otel.trace_exporter.<id>.tls.client-private-key`	`string`	Chemin de la clé privée du client pour les connexions TLS de l’exportateur de traces OTEL.
`otel.tracestate`	`map<string,map<string,string>>`	Définissez les champs des membres de tracestate (W3C) lors de la propagation du contexte de trace. Chaque membre associe des noms de champs à des valeurs de type chaîne.
`permissions.<name>.description`	`string`	Description en clair de ce profil nommé. Un profil n’hérite pas de la description de son parent via `extends`.
`permissions.<name>.extends`	`string`	Profil parent facultatif appliqué avant ce profil nommé. Indiquez le nom d’un autre profil nommé, `:read-only` ou `:workspace`. Codex rejette `:danger-full-access`, les références à des parents non définis et les cycles d’héritage.
`permissions.<name>.filesystem`	`table`	Profil nommé d’autorisations d’accès au système de fichiers. Chaque clé est un chemin absolu ou un symbole spécial tel que `:minimal` ou `:workspace_roots`.
`permissions.<name>.filesystem.":workspace_roots".<subpath-or-glob>`	`"read" \| "write" \| "deny"`	Règle d’accès au système de fichiers qui s’applique relativement à chaque racine effective de l’espace de travail. Utilisez `"."` pour désigner la racine elle-même. Pour les sous-chemins, des motifs glob tels que `"*/.env"` permettent d’interdire la lecture avec `"deny"`.
`permissions.<name>.filesystem.<path-or-glob>`	`"read" \| "write" \| "deny" \| table`	Accordez un accès direct pour un chemin, un motif glob ou un symbole spécial, ou limitez la portée des entrées imbriquées à cette racine. Utilisez `"deny"` pour interdire la lecture des chemins correspondants.
`permissions.<name>.filesystem.glob_scan_max_depth`	`number`	Profondeur maximale de recherche des chemins correspondant aux motifs glob d’interdiction de lecture sur les plateformes qui enregistrent la liste des correspondances avant le démarrage du bac à sable. Si vous définissez ce paramètre, sa valeur doit être supérieure ou égale à `1`.
`permissions.<name>.network.allow_local_binding`	`boolean`	Autorise un accès plus large aux réseaux locaux ou privés depuis le bac à sable. Une règle d’autorisation qui spécifie une adresse IP locale exacte ou `localhost` peut permettre l’accès à la cible locale correspondante même si ce paramètre reste à `false`.
`permissions.<name>.network.allow_upstream_proxy`	`boolean`	Autorise le proxy réseau du bac à sable à relayer le trafic via un autre proxy en amont.
`permissions.<name>.network.dangerously_allow_all_unix_sockets`	`boolean`	Autorise toute destination de socket Unix au lieu de l’ensemble restreint prévu par défaut. N’activez cette option que dans des environnements strictement contrôlés.
`permissions.<name>.network.dangerously_allow_non_loopback_proxy`	`boolean`	Autorise les services réseau du bac à sable à écouter sur des adresses autres que les adresses de bouclage. L’activation de cette option peut rendre ces services accessibles au-delà de localhost.
`permissions.<name>.network.domains`	`table`	Règles de domaine pour les commandes exécutées dans le bac à sable. Elles ne s’appliquent que si le proxy est activé par `features.network_proxy` ou par une exigence réseau gérée par l’administrateur et activée. Les règles d’autorisation acceptent des noms d’hôte exacts, des motifs tels que `.example.com` et `.example.com`, ainsi que le motif global ``. En cas de conflit, la règle `deny` l’emporte. Ces règles ne restreignent ni la recherche web, ni les applications, ni les serveurs MCP.
`permissions.<name>.network.domains.<pattern>`	`allow \| deny`	Autorise ou interdit l’accès à un hôte désigné par son nom exact ou aux hôtes correspondant à un motif générique ciblé tel que `.example.com` ou `*.example.com`.
`permissions.<name>.network.enable_socks5`	`boolean`	Rend SOCKS5 disponible lorsque ce profil d’autorisations active le réseau du bac à sable.
`permissions.<name>.network.enable_socks5_udp`	`boolean`	Lorsque cette option est activée, le proxy SOCKS5 accepte le trafic UDP sur son port d’écoute.
`permissions.<name>.network.enabled`	`boolean`	Active l’accès réseau pour les commandes exécutées avec ce profil d’autorisations. Ce paramètre ne démarre pas le proxy réseau. Si `features.network_proxy` est désactivé et qu’aucune exigence réseau gérée par l’administrateur n’est activée, les commandes accèdent directement au réseau et les règles de domaine du profil ne s’appliquent pas.
`permissions.<name>.network.mode`	`limited \| full`	Mode du proxy réseau pour le trafic des sous-processus.
`permissions.<name>.network.proxy_url`	`string`	URL d’écoute HTTP utilisée lorsque ce profil d’autorisations active le réseau du bac à sable.
`permissions.<name>.network.socks_url`	`string`	Point de terminaison du proxy SOCKS5 utilisé par ce profil d’autorisations.
`permissions.<name>.network.unix_sockets`	`table`	Modifie la liste des sockets Unix autorisés pour le réseau du bac à sable. Utilisez les chemins des sockets comme clés. `allow` ajoute un chemin et `deny` le rejette.
`permissions.<name>.network.unix_sockets.<path>`	`allow \| deny`	Utilisez `allow` pour ajouter un chemin absolu de socket Unix à la liste d’autorisation effective ou `deny` pour le rejeter. Les chemins refusés sont exclus de cette liste.
`permissions.<name>.workspace_roots`	`table`	Racines de l’espace de travail définies par le profil. Les règles du système de fichiers `:workspace_roots` s’appliquent à ces racines ainsi qu’à celles que la session utilise à l’exécution.
`permissions.<name>.workspace_roots.<path>`	`boolean`	Définissez cette valeur sur `true` pour ajouter le chemin aux racines de l’espace de travail du profil. Les entrées désactivées restent inactives.
`personality`	`none \| friendly \| pragmatic`	Paramètre obsolète conservé pour des raisons de compatibilité. Les valeurs `friendly` et `pragmatic` ne permettent plus de choisir un style. Avec `none`, Codex omet la section intégrée « Personnalité » des instructions du modèle. Les remplacements d’instructions définis explicitement continuent de s’appliquer.
`plan_mode_reasoning_effort`	`string`	Redéfinit l’effort de raisonnement pour le mode Plan uniquement. Choisissez un niveau pris en charge par le modèle sélectionné. Si vous omettez ce paramètre, le mode Plan utilise la valeur par défaut de son préréglage intégré.
`plugins._default.enabled`	`boolean`	Définissez l’état d’activation par défaut des plugins installés. Pour les plugins activés par leur source, un réglage explicite de `plugins.<plugin>.enabled` remplace cette valeur par défaut. Omettez la table pour conserver les paramètres d’activation de la source ou du compte.
`plugins.<plugin>.enabled`	`boolean`	Activez ou désactivez un plugin d’une marketplace locale avec une clé `plugin-name@marketplace-name`. Codex lit cette valeur dans la configuration résultant de la fusion des paramètres. Les paramètres d’un projet de confiance peuvent remplacer les valeurs par défaut de l’utilisateur, celles gérées dans le cloud et celles du système. L’actualisation de la marketplace peut installer ou actualiser les plugins configurés, même s’ils sont désactivés. Les états d’activation gérés par l’espace de travail ont priorité sur ce paramètre.
`plugins.<plugin>.mcp_servers.<server>.default_tools_approval_mode`	`auto \| prompt \| writes \| approve`	Mode d’approbation par défaut des outils d’un serveur MCP fourni par un plugin.
`plugins.<plugin>.mcp_servers.<server>.disabled_tools`	`array<string>`	Liste des outils à exclure après application de `enabled_tools` pour un serveur MCP fourni par un plugin.
`plugins.<plugin>.mcp_servers.<server>.enabled`	`boolean`	Activez ou désactivez un serveur MCP fourni avec un plugin installé sans modifier le manifeste du plugin.
`plugins.<plugin>.mcp_servers.<server>.enabled_tools`	`array<string>`	Liste des outils autorisés parmi ceux qu’expose un serveur MCP fourni par un plugin.
`plugins.<plugin>.mcp_servers.<server>.tools.<tool>.approval_mode`	`auto \| prompt \| writes \| approve`	Redéfinit le mode d’approbation d’un outil MCP fourni par un plugin.
`project_doc_fallback_filenames`	`array<string>`	Autres noms de fichiers à essayer si `AGENTS.md` est absent.
`project_doc_max_bytes`	`number`	Nombre maximal d’octets lus dans `AGENTS.md` pour constituer les instructions du projet.
`project_root_markers`	`array<string>`	Noms des fichiers que Codex recherche dans les répertoires parents pour repérer la racine du projet.
`projects.<path>.trust_level`	`string`	Définit le niveau de confiance d’un projet ou d’un arbre de travail (`"trusted"` \| `"untrusted"`). Si le projet n’est pas de confiance, Codex ignore les couches `.codex/` propres au projet, notamment sa configuration locale, ses hooks et ses règles.
`review_model`	`string`	Modèle de remplacement facultatif pour `/review`. Par défaut, la commande utilise le modèle de la session en cours.
`sandbox_mode`	`read-only \| workspace-write \| danger-full-access`	Politique du bac à sable pour l’accès au système de fichiers et au réseau pendant l’exécution des commandes.
`sandbox_workspace_write.exclude_slash_tmp`	`boolean`	Exclut `/tmp` des racines accessibles en écriture en mode workspace-write.
`sandbox_workspace_write.exclude_tmpdir_env_var`	`boolean`	Exclut le répertoire indiqué par `$TMPDIR` des racines accessibles en écriture en mode workspace-write.
`sandbox_workspace_write.network_access`	`boolean`	Autorise les connexions réseau sortantes depuis le bac à sable en mode workspace-write.
`sandbox_workspace_write.writable_roots`	`array<string>`	Racines supplémentaires accessibles en écriture lorsque `sandbox_mode = "workspace-write"`.
`service_tier`	`string`	Offre privilégiée pour les nouveaux tours de conversation. Utilisez `fast` ou une autre offre proposée par le modèle actif. `fast` correspond à la valeur `priority` dans la requête.
`shell_environment_policy.exclude`	`array<string>`	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 de configuration.
`shell_environment_policy.experimental_use_profile`	`boolean`	Utilisez le profil shell de l’utilisateur pour lancer les sous-processus.
`shell_environment_policy.filters`	`map<string, include \| exclude>`	Filtres canoniques qui comparent les noms des variables d’environnement à des motifs sans tenir compte de la casse. Les entrées d’inclusion créent une liste d’autorisation et ne peuvent pas rétablir les valeurs exclues. Les valeurs définies explicitement avec `set` s’appliquent après les exclusions. Ne combinez pas ces filtres avec les anciens tableaux `exclude` ou `include_only` dans une même couche de configuration.
`shell_environment_policy.ignore_default_excludes`	`boolean`	Conserve les variables dont le nom contient KEY, SECRET ou TOKEN avant l’application des autres filtres (valeur par défaut : true). Utilisez false pour exclure automatiquement les variables dont le nom indique un secret.
`shell_environment_policy.include_only`	`array<string>`	Ancienne liste de motifs définissant les variables d’environnement autorisées. Utilisez `shell_environment_policy.filters` pour toute nouvelle configuration. Ne combinez pas les deux formes dans une même couche de configuration.
`shell_environment_policy.inherit`	`all \| core \| none`	Définit les variables d’environnement dont les sous-processus héritent par défaut à leur lancement.
`shell_environment_policy.set`	`map<string,string>`	Valeurs explicites des variables d’environnement, ajoutées après les exclusions. Les filtres d’inclusion peuvent encore les éliminer.
`show_raw_agent_reasoning`	`boolean`	Affiche le contenu brut du raisonnement lorsque le modèle actif le produit.
`skills.bundled.enabled`	`boolean`	Charge les skills système fournis avec Codex. La valeur par défaut est `true`. Dans la configuration d’un projet de confiance, réglez ce paramètre sur `false` pour désactiver ces skills dans ce projet.
`skills.config`	`array<object>`	Active ou désactive les skills par nom ou par chemin. Si plusieurs règles correspondent à un même skill, la dernière l’emporte.
`skills.config.<index>.enabled`	`boolean`	Active ou désactive le skill référencé.
`skills.config.<index>.name`	`string`	Sélectionne tous les skills portant exactement ce nom. Pour chaque entrée, indiquez soit `name`, soit `path`.
`skills.config.<index>.path`	`string (path)`	Chemin absolu vers un fichier `SKILL.md`.
`skills.include_instructions`	`boolean`	Inclut les instructions automatiques relatives aux skills dans le contexte du modèle. La valeur par défaut est `true`.
`skills.max_context_tokens`	`integer (positive)`	Budget de tokens alloué au catalogue des skills disponibles. Par défaut, il représente 2 % de la fenêtre de contexte du modèle. Les valeurs explicites sont plafonnées à `10000` tokens.
`sqlite_home`	`string (path)`	Répertoire où Codex stocke la base de données SQLite qui conserve l’état des tâches des agents ainsi que d’autres données d’état nécessaires à la reprise de l’exécution.
`suppress_unstable_features_warning`	`boolean`	Masque l’avertissement qui s’affiche lorsque des options de configuration activent des fonctionnalités en cours de développement.
`thread_unload_delay_secs`	`integer (nonnegative)`	Délai en secondes pendant lequel App Server attend avant de décharger un fil inactif sans abonné. Utilisez `0` pour le décharger dès que les deux conditions sont réunies. Le délai par défaut est de `60` secondes.
`tool_output_token_limit`	`number`	Nombre maximal de tokens à conserver dans l’historique pour chaque sortie d’outil ou de fonction.
`tool_suggest.disabled_tools`	`array<table>`	Désactive les suggestions d’outils pour certains connecteurs ou plugins détectables. Chaque entrée utilise `type = "connector"` ou `"plugin"` et un `id`.
`tool_suggest.discoverables`	`array<table>`	Autorise les suggestions d’outils pour d’autres connecteurs ou plugins détectables. Chaque entrée utilise `type = "connector"` ou `"plugin"` et un `id`.
`tools.web_search`	`boolean \| { context_size = "low\|medium\|high", allowed_domains = [string], location = { country, region, city, timezone } }`	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 position approximative de l’utilisateur. Ces filtres de recherche sont distincts des règles qui régissent l’accès des commandes en bac à sable aux domaines réseau. Ils ne restreignent ni les connecteurs ni les serveurs MCP.
`tui`	`table`	Options propres à l’interface du terminal, par exemple l’activation des notifications de bureau intégrées.
`tui.alternate_screen`	`auto \| always \| never`	Détermine si l’interface du terminal utilise l’écran alternatif (par défaut : auto). En mode auto, l’interface évite l’écran alternatif dans Zellij pour préserver l’historique de défilement.
`tui.animations`	`boolean`	Active les animations du terminal (écran d’accueil, effet de scintillement et indicateur d’activité rotatif). Valeur par défaut : true.
`tui.auto_recap`	`boolean`	Génère automatiquement des récapitulatifs de la conversation lorsque le terminal n’a pas le focus (par défaut : true). Utilisez `false` pour désactiver les récapitulatifs automatiques. La commande `/recap` reste disponible.
`tui.disable_paste_burst`	`boolean`	Désactive la détection des collages en rafale dans l’interface du terminal (par défaut : false). Ce réglage prime sur l’ancien paramètre de premier niveau `disable_paste_burst`.
`tui.keymap.<context>.<action>`	`string \| array<string>`	Raccourci clavier associé à une action de l’interface du terminal. Les contextes pris en charge incluent `global`, `chat`, `composer`, `editor`, `vim_normal`, `vim_operator`, `vim_text_object`, `pager`, `list` et `approval`. Certaines actions de la zone de saisie utilisent à défaut les raccourcis correspondants de `tui.keymap.global`. Les raccourcis propres au contexte ont priorité lorsqu’ils sont pris en charge.
`tui.keymap.<context>.<action> = []`	`empty array`	Supprimez les raccourcis clavier associés à l’action dans ce contexte. Les noms de touches utilisent des chaînes normalisées telles que `ctrl-a`, `shift-enter`, `page-down` ou `minus`.
`tui.model_availability_nux.<model>`	`integer`	État interne de l’infobulle de démarrage, indexé par le slug du modèle.
`tui.notification_condition`	`unfocused \| always`	Détermine si l’interface du terminal émet des notifications uniquement lorsque le terminal n’a pas le focus ou dans tous les cas. Valeur par défaut : `unfocused`.
`tui.notification_method`	`auto \| osc9 \| bel`	Méthode d’envoi des notifications du terminal (par défaut : auto).
`tui.notifications`	`boolean \| array<string>`	Active les notifications de l’interface du terminal. Vous pouvez les limiter à certains types d’événements.
`tui.presets.<digit>.input`	`string`	Enregistrez un prompt ou une commande slash dans l’un des dix emplacements (`0` à `9`) affichés par `/presets`. Saisissez un texte non vide de 8 000 octets UTF-8 au maximum. Les commandes shell commençant par `!` ne sont pas prises en charge.
`tui.presets.<digit>.label`	`string`	Nom facultatif du préréglage affiché dans le sélecteur et dans les indications de raccourcis clavier.
`tui.raw_output_mode`	`boolean`	Démarre l’interface du terminal avec un historique de défilement en texte brut pour faciliter la sélection et la copie de texte (par défaut : false). Vous pouvez activer ou désactiver ce mode avec `/raw` ou le raccourci clavier par défaut `alt-r`.
`tui.resume_cwd`	`current \| session`	Répertoire de travail à utiliser pour reprendre ou forker une session. Si ce paramètre est absent et que le répertoire courant diffère de celui enregistré pour la session, Codex vous demande lequel utiliser.
`tui.show_server_version_notice`	`boolean`	Affiche des messages d’information sur les écarts de version avec l’App Server connecté (par défaut : true). Les erreurs de compatibilité et l’état de la version restent visibles même si vous désactivez ces messages.
`tui.show_tooltips`	`boolean`	Affiche les infobulles de prise en main sur l’écran d’accueil de l’interface du terminal (par défaut : true).
`tui.status_line`	`array<string> \| null`	Liste ordonnée des identifiants des éléments de la ligne d’état au bas de l’interface du terminal. `null` désactive cette ligne.
`tui.terminal_title`	`array<string> \| null`	Liste ordonnée des identifiants des éléments du titre de la fenêtre ou de l’onglet du terminal. Valeur par défaut : `["spinner", "project"]`. `null` désactive la mise à jour du titre.
`tui.theme`	`string`	Thème à utiliser à la place du thème de coloration syntaxique par défaut (nom du thème en kebab-case).
`tui.vim_mode_default`	`boolean`	Ouvre la zone de saisie en mode normal de Vim au lieu du mode insertion (par défaut : false). Vous pouvez activer ou désactiver le mode Vim pour chaque session avec `/vim`.
`web_search`	`disabled \| cached \| indexed \| live`	Mode de recherche web (par défaut : `"cached"`). Le mode cached utilise un index tenu à jour par OpenAI sans accéder au Web externe. Le mode indexed autorise l’accès externe uniquement si l’index de recherche le permet. Si vous utilisez `--yolo` ou un autre paramètre du bac à sable qui accorde un accès complet, le mode par défaut devient `"live"`. Utilisez `"live"` pour récupérer des données en direct sans restriction, ou `"disabled"` pour retirer l’outil.
`windows.sandbox`	`mxc \| elevated \| unelevated`	Implémentation native du bac à sable Windows. La sélection explicite de `mxc` échoue si MXC est indisponible ou si les exigences gérées en interdisent l’utilisation. Pour sélectionner automatiquement MXC, utilisez `features.prefer_mxc` avec une ancienne implémentation qui servira de solution de repli.

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 du fichier TOML qui définit la couche de configuration propre à ce rôle. Codex résout les chemins relatifs à partir du répertoire du fichier de configuration qui déclare le rôle.

Key

agents.<name>.description

Type / Values

string

Details

Consignes sur le rôle présentées à Codex lorsqu’il choisit ce type d’agent et lance un agent de ce type.

Key

agents.default_subagent_model

Type / Values

string

Details

Modèle par défaut des sous-agents. Un modèle indiqué explicitement au lancement est prioritaire.

Key

agents.default_subagent_reasoning_effort

Type / Values

string

Details

Effort de raisonnement par défaut des sous-agents. Un effort indiqué explicitement au lancement est prioritaire.

Key

agents.enabled

Type / Values

boolean

Details

Active ou désactive les outils multi-agents (par défaut : true).

Key

agents.interrupt_message

Type / Values

boolean

Details

Enregistre un message visible par le modèle lorsqu’un tour d’agent est interrompu (par défaut : true).

Key

agents.max_concurrent_threads_per_session

Type / Values

number

Details

Nombre maximal de fils de sous-agents qui peuvent rester ouverts simultanément, hors fil principal. Si vous omettez ce paramètre, Codex choisit la limite 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

Autorise les outils shell à utiliser un shell de connexion. La valeur par défaut est true. Avec false, Codex rejette les demandes qui spécifient login = true et utilise un shell sans connexion si login est omis.

Key

allow_symlinked_codex_home

Type / Values

boolean

Details

Sous macOS, autorise le bac à sable à suivre les liens symboliques pour les racines accessibles en écriture qui correspondent à $CODEX_HOME ou se trouvent sous ce répertoire. Codex lit ce paramètre au démarrage, uniquement dans le fichier $CODEX_HOME/config.toml de l’hôte d’exécution. En l’activant, vous faites confiance aux cibles situées hors de ce répertoire et à celles qui changent entre deux commandes. Ce paramètre n’ajoute aucune racine accessible en écriture. La valeur par défaut est false.

Key

analytics.enabled

Type / Values

boolean

Details

Active ou désactive la collecte de données analytiques pour cette machine ou ce profil. La valeur false désactive l’exportateur de métriques Statsig intégré. Les exportateurs de métriques OTLP configurés explicitement restent actifs. Si vous omettez ce paramètre, le client utilise son réglage par défaut.

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 dans quels cas Codex attend votre approbation avant d’exécuter une commande. Utilisez approval_policy = { granular = { ... } } pour préciser, pour certaines catégories de demandes, si Codex peut les afficher ou doit les rejeter automatiquement. Les autres demandes restent interactives. Codex ne prend pas en charge untrusted, 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 true, Codex peut afficher les demandes d’élicitation MCP au lieu de les rejeter automatiquement.

Key

approval_policy.granular.request_permissions

Type / Values

boolean

Details

Avec true, Codex peut afficher les demandes émises par l’outil request_permissions.

Key

approval_policy.granular.rules

Type / Values

boolean

Details

Avec true, Codex peut afficher les demandes d’approbation déclenchées par les règles prompt d’execpolicy.

Key

approval_policy.granular.sandbox_approval

Type / Values

boolean

Details

Avec true, Codex peut vous demander l’autorisation d’exécuter une commande au-delà des restrictions du bac à sable.

Key

approval_policy.granular.skill_approval

Type / Values

boolean

Details

Avec true, Codex peut vous demander d’approuver l’exécution de scripts de skills.

Key

approvals_reviewer

Type / Values

user | auto_review

Details

Détermine qui examine les demandes d’approbation admissibles avec la politique on-request ou une politique d’approbation granulaire. La valeur par défaut est user. Avec auto_review, le sous-agent chargé de la révision examine ces demandes. Ce paramètre ne modifie pas les restrictions du bac à sable et ne soumet pas à révision les actions qui y sont déjà autorisées.

Key

apps._default.approvals_reviewer

Type / Values

user | auto_review

Details

Détermine qui examine par défaut les demandes d’approbation des outils d’application, sauf réglage propre à l’application. Si ce paramètre est omis, les applications héritent de la valeur du paramètre de premier niveau approvals_reviewer.

Key

apps._default.default_tools_approval_mode

Type / Values

auto | prompt | writes | approve

Details

Mode d’approbation par défaut des outils d’application en l’absence de réglage propre à l’application ou à l’outil.

Key

apps._default.destructive_enabled

Type / Values

boolean

Details

Autorise ou interdit par défaut les outils d’application qui déclarent destructive_hint = true.

Key

apps._default.enabled

Type / Values

boolean

Details

Détermine si les applications sont activées par défaut, sauf réglage propre à une application.

Key

apps._default.open_world_enabled

Type / Values

boolean

Details

Autorise ou interdit par défaut les outils d’application qui déclarent open_world_hint = true.

Key

apps.<id>.approvals_reviewer

Type / Values

user | auto_review

Details

Détermine qui examine les demandes d’approbation des outils de cette application. Ce réglage prévaut sur apps._default.approvals_reviewer.

Key

apps.<id>.default_tools_approval_mode

Type / Values

auto | prompt | writes | approve

Details

Mode d’approbation par défaut des outils de cette application, sauf réglage propre à l’outil.

Key

apps.<id>.default_tools_enabled

Type / Values

boolean

Details

Détermine si les outils de cette application sont activés par défaut, sauf réglage propre à l’outil.

Key

apps.<id>.destructive_enabled

Type / Values

boolean

Details

Autorise ou bloque les outils de cette application qui déclarent destructive_hint = true.

Key

apps.<id>.enabled

Type / Values

boolean

Details

Active ou désactive une application ou un connecteur selon son identifiant (par défaut : true).

Key

apps.<id>.omit_tools_from

Type / Values

array<string>

Details

Exclut les outils de cette application des interfaces direct, deferred ou code_mode. Les exclusions de l’application et celles du serveur MCP se cumulent.

Key

apps.<id>.open_world_enabled

Type / Values

boolean

Details

Autorise ou bloque 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

Redéfinit le mode d’approbation d’un outil de l’application.

Key

apps.<id>.tools.<tool>.enabled

Type / Values

boolean

Details

Redéfinit l’état d’activation d’un outil de l’application (par exemple repos/list).

Key

auto_review.policy

Type / Values

string

Details

Texte Markdown qui remplace la politique par défaut de la fonctionnalité Révision automatique. Le paramètre géré guardian_policy_config est prioritaire. Les valeurs vides sont ignorées.

Key

background_terminal_max_timeout

Type / Values

number

Details

Durée maximale d’attente en millisecondes pour chaque appel write_stdin sans entrée qui interroge le terminal en arrière-plan. La valeur par défaut est de 300000 millisecondes (5 minutes). Ce paramètre 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 de navigation. Les exigences gérées peuvent imposer cette restriction.

Key

browser_use.default_origin_policy

Type / Values

table

Details

Restrictions que le navigateur applique par défaut aux origines. Les champs access, uploads, downloads et full_cdp_access acceptent chacun allow ou deny.

Key

browser_use.origins.<origin>

Type / Values

table

Details

Restrictions du navigateur propres à une origine. Les champs sont les mêmes que pour browser_use.default_origin_policy. Indiquez le schéma HTTP ou HTTPS et, si nécessaire, le port. Omettez le chemin, la chaîne de requête et le fragment. Les valeurs locales ne peuvent pas assouplir les interdictions imposées par les exigences gérées.

Key

chatgpt_base_url

Type / Values

string

Details

Redéfinit l’URL de base utilisée lors de la connexion à ChatGPT.

Key

check_for_update_on_startup

Type / Values

boolean

Details

Recherche les mises à jour de Codex au démarrage. Utilisez 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étermine où la CLI conserve les identifiants mis en cache.

Key

compact_prompt

Type / Values

string

Details

Prompt défini directement dans la configuration pour remplacer le prompt de compactage de l’historique.

Key

computer_use.default_app_access

Type / Values

allow | deny

Details

Politique d’accès par défaut aux applications natives pour la fonctionnalité Utilisation de l’ordinateur. Une entrée propre à une application peut définir sa politique d’accès. La configuration locale ne peut pas assouplir les restrictions imposées par les exigences gérées.

Key

computer_use.macos.bundle_ids

Type / Values

map<string, allow | deny>

Details

Accès aux applications natives macOS, par identifiant de bundle.

Key

computer_use.windows.always_allowed_app_ids

Type / Values

array<string>

Details

Identifiants des applications Windows que la fonctionnalité Utilisation de l’ordinateur peut ouvrir sans demander d’approbation. L’ouverture des applications absentes de cette liste nécessite une approbation. Pour supprimer une entrée enregistrée, ouvrez les paramètres d’Utilisation de l’ordinateur dans l’application de bureau ChatGPT.

Key

computer_use.windows.aumids

Type / Values

map<string, allow | deny>

Details

Accès aux applications Windows distribuées en package, selon leur identifiant Application User Model ID (AUMID).

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). Le champ binary_name est facultatif.

Key

default_permissions

Type / Values

string

Details

Nom du profil d’autorisations par défaut à appliquer aux appels d’outils en bac à sable. Les profils intégrés sont :read-only, :workspace et :danger-full-access. Chaque nom de profil personnalisé doit correspondre à une table [permissions.<name>]. Ne combinez ce paramètre ni avec sandbox_mode ni avec [sandbox_workspace_write].

Key

desktop.custom_file_handlers.<id>

Type / Values

table

Details

Ce paramètre se définit uniquement dans la configuration utilisateur. Il ajoute une destination au menu Ouvrir dans de l’application de bureau ChatGPT. Consultez la section Ajouter des gestionnaires de fichiers personnalisés pour voir des exemples et connaître les contraintes applicables 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

Source de l’icône du gestionnaire (obligatoire) : chemin d’une ressource fournie avec l’application, URL data:image/... encodée en Base64, URI de fichier ou chemin local absolu. Si la source n’est pas prise en charge, l’application affiche l’icône VS Code par défaut.

Key

desktop.custom_file_handlers.<id>.input

Type / Values

path | json_argument | json_stdin

Details

Indique comment l’application transmet le fichier 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

Propose le gestionnaire pour les fichiers des espaces de travail SSH (par défaut : false).

Key

developer_instructions

Type / Values

string

Details

Instructions supplémentaires du développeur que Codex ajoute à la session (paramètre facultatif).

Key

disable_paste_burst

Type / Values

boolean

Details

Ancien paramètre utilisé en l’absence de tui.disable_paste_burst. Privilégiez le paramètre de la section [tui].

Key

experimental_compact_prompt_file

Type / Values

string (path)

Details

Charge depuis un fichier le prompt qui remplace le prompt de compactage par défaut (expérimental).

Key

experimental_use_unified_exec_tool

Type / Values

boolean

Details

Ancien nom du paramètre d’activation de l’exécution unifiée. Privilégiez [features].unified_exec ou codex --enable unified_exec.

Key

features.apps

Type / Values

boolean

Details

Active les intégrations d’applications (connecteurs). Cette fonctionnalité est stable et activée par défaut. Le trafic des applications et des connecteurs n’est soumis ni au proxy réseau des commandes exécutées en bac à sable ni à sa liste de domaines autorisés.

Key

features.code_mode.direct_only_tool_namespaces

Type / Values

array<string>

Details

Espaces de noms d’outils que le mode code peut utiliser uniquement par des appels d’outils directs.

Key

features.code_mode.enabled

Type / Values

boolean

Details

Active la configuration du mode code. Cette fonctionnalité est en cours de développement et désactivée par défaut.

Key

features.code_mode.excluded_tool_namespaces

Type / Values

array<string>

Details

Espaces de noms d’outils que le mode code exclut des instructions sur les appels d’outils imbriqués et de l’ensemble des outils accessibles à l’exécuteur.

Key

features.context_management.experimental_mode

Type / Values

boolean

Details

Paramètre expérimental de gestion du contexte. Cette fonctionnalité est actuellement indisponible.

Key

features.enable_request_compression

Type / Values

boolean

Details

Compresse avec zstd le corps des requêtes en streaming lorsque cette compression est prise en charge (fonctionnalité stable, activée par défaut).

Key

features.fast_mode

Type / Values

boolean

Details

Active les commandes du mode Rapide proposées par le modèle actif, indépendamment de features.ultrafast_mode (fonctionnalité stable, activée par défaut). La disponibilité de ces commandes dépend toujours du modèle et du compte.

Key

features.goals

Type / Values

boolean

Details

Active les objectifs persistants et la poursuite automatique du travail (fonctionnalité stable, activée par défaut).

Key

features.hooks

Type / Values

boolean

Details

Active les hooks de cycle de vie chargés depuis hooks.json ou définis directement dans la section [hooks] de la configuration. features.codex_hooks est un alias obsolète.

Key

features.memories

Type / Values

boolean

Details

Active les Mémoires (désactivées par défaut).

Key

features.multi_agent

Type / Values

boolean

Details

Active les outils de collaboration entre agents (spawn_agent, send_input, resume_agent, wait_agent et close_agent). Cette fonctionnalité stable est activée par défaut.

Key

features.network_proxy

Type / Values

boolean | table

Details

Démarre le proxy réseau pour les commandes exécutées en bac à sable (fonctionnalité expérimentale, désactivée par défaut). Activez ce paramètre pour appliquer les règles de domaine des profils d’autorisations, sauf si les exigences network_proxy gérées par l’administrateur sont activées et démarrent le proxy. Utilisez une table pour définir des options de politique propres à cette fonctionnalité, telles que domains. Le proxy ne filtre ni la recherche web, ni les applications, ni MCP, ni les autres outils hébergés.

Key

features.network_proxy.allow_local_binding

Type / Values

boolean

Details

Autorise un accès plus large aux réseaux locaux ou privés. La valeur par défaut est false. Vous pouvez néanmoins autoriser l’accès à des cibles locales précises en indiquant une adresse IP locale sous sa forme littérale exacte ou localhost dans une règle d’autorisation.

Key

features.network_proxy.allow_upstream_proxy

Type / Values

boolean

Details

Autorise le passage par un proxy amont défini dans l’environnement. Valeur par défaut : true.

Key

features.network_proxy.dangerously_allow_all_unix_sockets

Type / Values

boolean

Details

Autorise l’accès à tout socket Unix, même s’il ne figure pas dans la liste d’autorisation. La valeur par défaut est false. Utilisez ce paramètre uniquement dans des environnements strictement contrôlés.

Key

features.network_proxy.dangerously_allow_non_loopback_proxy

Type / Values

boolean

Details

Autorise le proxy à écouter sur des adresses autres que les adresses de bouclage. La valeur par défaut est false. L’activation de ce paramètre peut rendre les ports d’écoute du proxy accessibles au-delà de localhost.

Key

features.network_proxy.domains

Type / Values

map<string, allow | deny>

Details

Règles d’accès aux domaines depuis le bac à sable. Ce paramètre n’a pas de valeur par défaut. Aucune destination externe n’est autorisée tant que vous n’ajoutez pas de règle allow. Vous pouvez indiquer un nom d’hôte exact, *.example.com pour les sous-domaines uniquement, **.example.com pour le domaine lui-même et ses sous-domaines, ou * pour une règle d’autorisation globale. Privilégiez les règles ciblées, car * autorise largement les connexions sortantes vers le réseau public. Ajoutez des règles deny pour bloquer des destinations. En cas de conflit, deny l’emporte.

Key

features.network_proxy.enable_socks5

Type / Values

boolean

Details

Active la prise en charge de SOCKS5. Valeur par défaut : true.

Key

features.network_proxy.enable_socks5_udp

Type / Values

boolean

Details

Autorise UDP sur SOCKS5. Valeur par défaut : true.

Key

features.network_proxy.enabled

Type / Values

boolean

Details

Démarre le proxy réseau pour les commandes exécutées en bac à sable lorsque leur accès au réseau est activé. La valeur par défaut est false. Tant que le proxy est désactivé, les règles de domaine des profils d’autorisations ne s’appliquent pas.

Key

features.network_proxy.proxy_url

Type / Values

string

Details

URL d’écoute HTTP pour le réseau du 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

Règles d’accès aux sockets Unix depuis le bac à sable. Aucune valeur n’est définie par défaut. Ajoutez une entrée allow pour chaque socket autorisé.

Key

features.personality

Type / Values

boolean

Details

Indicateur de fonctionnalité supprimé. Codex l’accepte pour des raisons de compatibilité et l’ignore.

Key

features.prefer_mxc

Type / Values

boolean

Details

Privilégie MXC pour l’exécution locale sous Windows lorsque les capacités natives et la politique le permettent. Sinon, Codex conserve l’ancien bac à sable et sa configuration. Ce paramètre est désactivé par défaut dans la CLI autonome. L’application de bureau ChatGPT peut l’activer via sa configuration de déploiement. L’échec d’une commande ne déclenche pas de retour à l’ancien bac à sable.

Key

features.prevent_idle_sleep

Type / Values

boolean

Details

Empêche la mise en veille de la machine pendant l’exécution d’un tour (fonctionnalité expérimentale, désactivée par défaut).

Key

features.remote_plugin

Type / Values

boolean

Details

Active le catalogue distant de plugins (fonctionnalité stable, activée par défaut).

Key

features.rollout_budget.enabled

Type / Values

boolean

Details

Active le suivi du budget de tokens d’une exécution. Cette fonctionnalité est en cours de développement et désactivée par défaut. Si vous l’activez, définissez à la fois limit_tokens et reminder_at_remaining_tokens.

Key

features.rollout_budget.limit_tokens

Type / Values

integer

Details

Nombre maximal de tokens pour le suivi du budget d’exécution. Cette limite doit être strictement positive et doit être définie si le suivi est activé.

Key

features.rollout_budget.prefill_token_weight

Type / Values

number

Details

Coefficient fini, positif ou nul, 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_at_remaining_tokens

Type / Values

array<integer>

Details

Envoie un rappel chaque fois que le budget restant en tokens pondérés franchit l’un des seuils. Fournissez cette liste si le suivi du budget d’exécution est activé. Chaque valeur doit être strictement positive et inférieure à limit_tokens.

Key

features.rollout_budget.sampling_token_weight

Type / Values

number

Details

Coefficient fini, positif ou nul, 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ée un instantané de l’environnement du shell pour accélérer l’exécution des commandes répétées (fonctionnalité stable, activée par défaut).

Key

features.shell_tool

Type / Values

boolean

Details

Active les outils d’exécution de commandes (fonctionnalité stable, activée par défaut).

Key

features.skill_mcp_dependency_install

Type / Values

boolean

Details

Permet à Codex de proposer l’installation des dépendances MCP manquantes pour les skills et de les installer (fonctionnalité stable, activée par défaut).

Key

features.ultrafast_mode

Type / Values

boolean

Details

Active les commandes du mode Ultrarapide, indépendamment de features.fast_mode (fonctionnalité stable, activée par défaut). La disponibilité de ces commandes dépend toujours du modèle et du compte.

Key

features.unified_exec

Type / Values

boolean

Details

Permet de reprendre l’exécution des commandes (fonctionnalité stable, activée sur toutes les plateformes). Codex ignore les demandes de désactivation des utilisateurs. Les exigences gérées peuvent désactiver les processus dont l’exécution peut être reprise ainsi que write_stdin. Dans ce cas, exec_command reste disponible pour exécuter une commande en une seule étape.

Key

features.view_image

Type / Values

boolean

Details

Active l’outil intégré view_image pour ouvrir des images locales. Valeur par défaut : true.

Key

features.web_search

Type / Values

boolean

Details

Paramètre obsolète. Privilégiez le paramètre de premier niveau web_search.

Key

features.web_search_cached

Type / Values

boolean

Details

Paramètre obsolète. Si web_search est absent, la valeur true correspond à web_search = "cached".

Key

features.web_search_request

Type / Values

boolean

Details

Paramètre obsolète. Si web_search est absent, la valeur true correspond à web_search = "live".

Key

feedback.enabled

Type / Values

boolean

Details

Autorise l’envoi de retours via /feedback depuis tous 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 références citées dans les sorties de Codex (par défaut : vscode).

Key

forced_chatgpt_workspace_id

Type / Values

string (uuid)

Details

Limite les connexions à ChatGPT à l’espace de travail désigné par cet identifiant.

Key

forced_login_method

Type / Values

chatgpt | api

Details

Limite Codex à une méthode d’authentification précise.

Key

goals.max_goal_token_budget

Type / Values

integer (positive)

Details

Définit à la fois le budget de tokens par défaut des nouveaux objectifs et le budget maximal qu’un objectif peut demander. Omettez ce paramètre pour ne fixer aucune limite aux objectifs.

Key

hide_agent_reasoning

Type / Values

boolean

Details

Masque les événements de raisonnement dans l’interface du terminal et dans la sortie de codex exec.

Key

history.max_bytes

Type / Values

number

Details

Si vous définissez ce paramètre, Codex limite la taille du fichier d’historique au nombre d’octets indiqué en supprimant les entrées les plus anciennes.

Key

history.persistence

Type / Values

save-all | none

Details

Détermine si Codex enregistre les transcriptions de session dans history.jsonl.

Key

hooks

Type / Values

table

Details

Hooks de cycle de vie définis directement dans config.toml. Ils utilisent le même schéma d’événements que hooks.json. Consultez le guide des hooks pour voir 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 des événements de hook tels que PreModelRequest, PostModelRequest, 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. Codex prend en charge les hooks de commande et d’outil MCP. Il analyse les gestionnaires de hooks de prompt et d’agent sans les exécuter.

Key

hooks.<Event>[].hooks[].additionalContextLimit

Type / Values

integer

Details

Seuil approximatif en tokens, propre à chaque gestionnaire, au-delà duquel Codex enregistre additionalContext sur disque et présente un aperçu plus court au modèle. La valeur par défaut est 2500. Avec 0, le modèle reçoit directement tout le contexte. Consultez Sorties volumineuses des hooks.

Key

hooks.<Event>[].hooks[].async

Type / Values

boolean

Details

Exécute un hook de commande en arrière-plan sans retarder l’opération qui le déclenche. La valeur par défaut est false. Les hooks SessionEnd s’exécutent toujours de façon synchrone. Consultez Exécuter des hooks en arrière-plan.

Key

hooks.<Event>[].hooks[].commandWindows

Type / Values

string

Details

Commande de remplacement propre à Windows pour les hooks de commande. L’alias TOML command_windows est également accepté.

Key

instructions

Type / Values

string

Details

Réservé à un usage futur. Privilégiez model_instructions_file ou AGENTS.md.

Key

log_dir

Type / Values

string (path)

Details

Répertoire où Codex écrit les fichiers journaux. La valeur par défaut est $CODEX_HOME/log. Si vous définissez explicitement ce paramètre, Codex y écrit également codex-tui.log, le journal facultatif en texte brut de l’interface du terminal.

Key

marketplaces.<name>.ref

Type / Values

string

Details

Référence Git facultative pour la marketplace (branche, tag ou commit).

Key

marketplaces.<name>.source

Type / Values

string

Details

Emplacement du dépôt Git ou répertoire racine de la marketplace locale. Pour une source locale, utilisez le chemin absolu du répertoire qui 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. Vous pouvez définir une marketplace dans le fichier config.toml du système, de l’utilisateur ou d’un projet de confiance, ou dans le fichier config.toml géré dans le cloud.

Key

marketplaces.<name>.sparse_paths

Type / Values

array<string>

Details

Chemins facultatifs pour une extraction partielle d’une marketplace Git. Incluez le catalogue de la marketplace et tous les répertoires de plugins locaux auxquels ce catalogue fait référence.

Key

mcp_oauth_callback_port

Type / Values

integer

Details

Port fixe global facultatif du serveur HTTP local qui reçoit le rappel lors de la connexion OAuth MCP. Le paramètre oauth.callback_port propre au serveur est prioritaire. Si aucun des deux paramètres 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 rappel de base facultative pour la connexion OAuth MCP, par exemple l’URL d’entrée d’une devbox. Lorsque le serveur d’autorisation prend en charge l’identification de l’émetteur, les clients préenregistrés nouvellement ajoutés utilisent cette URL telle quelle. Les clients existants sans URL de rappel enregistrée y ajoutent un identifiant de rappel propre au serveur. Si le serveur d’autorisation ne prend pas en charge l’identification de l’émetteur, tout serveur MCP préenregistré dont l’URL de rappel configurée ne contient pas l’identifiant requis utilise à la place l’URL de base suivie de cet identifiant. Le port indiqué dans l’URL de rappel ne détermine pas le port d’écoute.

Key

mcp_oauth_credentials_store

Type / Values

auto | file | keyring

Details

Emplacement de stockage privilégié pour les identifiants OAuth utilisés avec MCP.

Key

mcp_optional_startup_grace_ms

Type / Values

integer (milliseconds)

Details

Délai d’attente commun aux serveurs MCP facultatifs lors de la création du catalogue initial d’outils. La valeur par défaut est 1000. Utilisez 0 pour appliquer à chaque serveur son propre délai startup_timeout_sec.

Key

mcp_servers.<id>.args

Type / Values

array<string>

Details

Arguments transmis à la commande de lancement du serveur MCP stdio.

Key

mcp_servers.<id>.auth

Type / Values

oauth | chatgpt

Details

Méthode d’authentification de repli pour un serveur MCP HTTP. Les jetons porteurs et les en-têtes d’autorisation configurés sont prioritaires. oauth (par défaut) utilise les identifiants OAuth MCP enregistrés s’ils sont disponibles. chatgpt utilise la session ChatGPT en cours pour l’origine de confiance exploitée par ChatGPT, puis se replie si nécessaire sur les identifiants OAuth enregistrés. Dans les deux modes, la connexion peut s’établir sans authentification si aucune source ne fournit d’identifiants.

Key

mcp_servers.<id>.bearer_token_env_var

Type / Values

string

Details

Variable d’environnement qui contient le jeton porteur utilisé pour accéder au serveur MCP via 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

Mode d’approbation par défaut des outils MCP de ce serveur. Un réglage propre à un outil est prioritaire pour cet outil.

Key

mcp_servers.<id>.disabled_tools

Type / Values

array<string>

Details

Liste des outils interdits pour ce serveur MCP. Elle s’applique après enabled_tools.

Key

mcp_servers.<id>.enabled

Type / Values

boolean

Details

Permet de désactiver 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 dont les valeurs proviennent 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 de type chaîne utilisent source = "local" par défaut. Utilisez source = "remote" uniquement si un exécuteur gère le transport stdio distant.

Key

mcp_servers.<id>.environment_id

Type / Values

string

Details

Environnement d’exécution du serveur MCP. La valeur par défaut est local. Utilisez l’identifiant d’un exécuteur configuré pour y lancer un serveur stdio ou pour vous connecter depuis cet environnement à un serveur HTTP prenant en charge le streaming.

Key

mcp_servers.<id>.http_headers

Type / Values

map<string,string>

Details

En-têtes HTTP statiques inclus dans chaque requête HTTP adressée au serveur MCP.

Key

mcp_servers.<id>.http_headers_helper

Type / Values

string (command)

Details

Commande locale qui écrit sur la sortie standard un objet JSON associant chaque nom d’en-tête HTTP à sa valeur. Seuls les serveurs MCP HTTP connectés localement prennent en charge cette commande. Les jetons porteurs explicitement configurés et les identifiants OAuth ont priorité sur les en-têtes Authorization fournis par la commande.

Key

mcp_servers.<id>.oauth_resource

Type / Values

string

Details

Paramètre de ressource OAuth facultatif conforme à la RFC 8707 à inclure lors de la connexion MCP.

Key

mcp_servers.<id>.oauth.callback_port

Type / Values

integer

Details

Port d’écoute fixe pour le rappel OAuth de ce serveur MCP. Ce réglage prévaut sur mcp_oauth_callback_port. Si l’URL d’un rappel direct sur l’interface de bouclage indique explicitement un port, configurez ce même port comme 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 si l’identification de l’émetteur est prise en charge ou si l’URL se termine déjà par l’identifiant de rappel propre au serveur. Sinon, Codex ajoute cet identifiant à la fin de l’URL de rappel globale ou par défaut et utilise l’URL ainsi obtenue. Les clients sans identifiant préenregistré utilisent l’URL de rappel propre au serveur lors de leur enregistrement.

Key

mcp_servers.<id>.oauth.client_id

Type / Values

string

Details

Identifiant client OAuth préenregistré utilisé pour l’autorisation et l’échange de jetons avec ce serveur MCP.

Key

mcp_servers.<id>.oauth.client_secret

Type / Values

string

Details

Secret client OAuth pour l’échange de jetons avec un client préenregistré. Renseignez oauth.client_id et le secret avec des valeurs non vides. Le secret est stocké dans la configuration.

Key

mcp_servers.<id>.omit_tools_from

Type / Values

array<string>

Details

Masque les outils de ce serveur dans les interfaces sélectionnées auxquelles le modèle a accès. Choisissez direct (outils disponibles dès le départ), deferred (recherche d’outils) ou code_mode (scripts du mode code). Utilisez disabled_tools pour bloquer un outil. Une liste vide efface les exclusions héritées.

Key

mcp_servers.<id>.required

Type / Values

boolean

Details

Si ce serveur est activé, exige qu’il soit prêt au démarrage. Avec startup_readiness = "catalog", un catalogue valide en cache peut satisfaire cette exigence.

Key

mcp_servers.<id>.scopes

Type / Values

array<string>

Details

Portées OAuth à demander lors de la connexion. Si vous omettez ce paramètre, Codex utilise les portées du défi d’authentification initial ou, à défaut, celles des métadonnées de la ressource protégée.

Key

mcp_servers.<id>.startup_readiness

Type / Values

connection | catalog

Details

Avec connection (valeur par défaut), Codex attend que la connexion soit établie pour considérer le serveur comme prêt au démarrage. Avec catalog, un catalogue d’outils valide en cache suffit pendant que la connexion s’établit. L’appel d’un outil nécessite toujours une connexion active.

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

Fixe le délai maximal de démarrage du serveur MCP. Le délai par défaut est de 10 secondes.

Key

mcp_servers.<id>.supports_parallel_tool_calls

Type / Values

boolean

Details

Indique que tous les outils de ce serveur peuvent être exécutés en parallèle en toute sécurité. Activez ce paramètre uniquement si le serveur peut traiter des appels simultanés à tous ses outils. La valeur par défaut est false.

Key

mcp_servers.<id>.tool_input_schema_max_bytes

Type / Values

integer (positive)

Details

Compacte le schéma d’entrée de chaque outil MCP ordinaire si sa taille en octets UTF-8 dépasse ce seuil. La valeur par défaut est de 5 000 octets. Si vous indiquez une valeur, le mode code l’utilise aussi pour afficher les types d’entrée des outils.

Key

mcp_servers.<id>.tool_timeout_sec

Type / Values

number

Details

Fixe le délai maximal pour chaque appel d’outil du serveur MCP. Le délai par défaut est de 60 secondes.

Key

mcp_servers.<id>.tools.<tool>.approval_mode

Type / Values

auto | prompt | writes | approve

Details

Redéfinit le mode d’approbation pour 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 l’ajout de la marge standard de 20 % prévue pour la sérialisation. Cette valeur remplace le seuil de troncature que le modèle applique par défaut à la sortie de cet outil.

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.consolidation_service_tier

Type / Values

string

Details

Offre utilisée pour la consolidation globale des mémoires. Valeur par défaut : default (Standard).

Key

memories.disable_on_external_context

Type / Values

boolean

Details

Avec true, Codex exclut de la génération de mémoires les fils qui utilisent un contexte externe, par exemple via des appels d’outils MCP, la recherche web ou la recherche d’outils. Valeur par défaut : false. Ancien alias : memories.no_memories_if_mcp_or_web_search.

Key

memories.dual_write

Type / Values

boolean

Details

Si v1 est la version sélectionnée, réglez ce paramètre sur true pour que Codex alimente les deux stockages tout en continuant à lire les mémoires dans v1. Si v2 est la version sélectionnée, Codex écrit uniquement dans v2.

Key

memories.extract_model

Type / Values

string

Details

Modèle de remplacement facultatif pour extraire les mémoires de chaque fil.

Key

memories.generate_memories

Type / Values

boolean

Details

Avec false, Codex n’enregistre pas les nouveaux fils comme sources pour la génération de mémoires. Valeur par défaut : true.

Key

memories.max_raw_memories_for_consolidation

Type / Values

number

Details

Nombre maximal de mémoires brutes récentes conservées pour la consolidation globale. Valeur par défaut : 256. Plafond : 4096.

Key

memories.max_rollout_age_days

Type / Values

number

Details

Âge maximal, en jours, des fils pris en compte pour la génération de mémoires. Valeur par défaut : 30. Codex ramène toute valeur hors de l’intervalle de 0 à 90 à la borne la plus proche.

Key

memories.max_rollouts_per_startup

Type / Values

number

Details

Nombre maximal de fils candidats que Codex traite à chaque passe de démarrage. Valeur par défaut : 16. Plafond : 128.

Key

memories.max_unused_days

Type / Values

number

Details

Délai maximal, en jours, depuis la dernière utilisation d’une mémoire. Au-delà de ce délai, Codex exclut la mémoire de la consolidation. Valeur par défaut : 30. Codex ramène toute valeur hors de l’intervalle de 0 à 365 à la borne la plus proche.

Key

memories.min_rate_limit_remaining_percent

Type / Values

number

Details

Pourcentage minimal de quota qui doit rester disponible dans chaque fenêtre de limite de débit de Codex pour que la génération de mémoires démarre. Valeur par défaut : 25. Codex ramène toute valeur hors de l’intervalle de 0 à 100 à la borne la plus proche.

Key

memories.min_rollout_idle_hours

Type / Values

number

Details

Durée minimale d’inactivité, en heures, avant que Codex prenne un fil en compte pour la génération de mémoires. Valeur par défaut : 6. Codex ramène toute valeur hors de l’intervalle de 1 à 48 à la borne la plus proche.

Key

memories.use_memories

Type / Values

boolean

Details

Avec false, Codex n’ajoute pas les mémoires existantes au contexte des sessions futures. Valeur par défaut : true.

Key

memories.version

Type / Values

v1 | v2

Details

Sélectionne le stockage local des mémoires. Lorsque les mémoires sont activées, Codex utilise par défaut v2 pour un nouveau répertoire d’accueil de Codex et v1 si $CODEX_HOME/memories/ existe. Si vous indiquez explicitement dual_write = false, la valeur par défaut reste v1.

Key

model

Type / Values

string

Details

Modèle à utiliser (par exemple gpt-6.1-sol).

Key

model_auto_compact_token_limit

Type / Values

number

Details

Seuil de tokens qui déclenche le compactage automatique de l’historique. En l’absence de valeur, les paramètres 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 tient compte de tout le contexte actif (total, valeur par défaut) ou uniquement des tokens ajoutés après le préfixe conservé de la fenêtre de compactage (body_after_prefix).

Key

model_catalog_json

Type / Values

string (path)

Details

Chemin facultatif vers un catalogue de modèles au format JSON chargé au démarrage. Vous pouvez redéfinir ce chemin pour chaque profil dans le fichier $CODEX_HOME/profile-name.config.toml correspondant au profil sélectionné.

Key

model_context_window

Type / Values

number

Details

Nombre de tokens disponibles dans la fenêtre de contexte du modèle actif.

Key

model_instructions_file

Type / Values

string (path)

Details

Fichier à utiliser à la place de AGENTS.md pour remplacer les instructions intégrées.

Key

model_post_turn_compact_threshold_percent

Type / Values

integer (0–100)

Details

Codex compacte l’historique après la réponse finale si le contexte actif atteint ce pourcentage de la fenêtre de contexte utilisable. Omettez ce paramètre ou réglez-le sur 0 pour désactiver le compactage en fin de tour. Les limites habituelles du compactage automatique continuent de s’appliquer.

Key

model_provider

Type / Values

string

Details

Identifiant du fournisseur dans model_providers (par défaut : openai).

Key

model_providers.<id>

Type / Values

table

Details

Définition d’un fournisseur de modèles 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

Configure la commande qui fournit un jeton porteur pour un fournisseur personnalisé. Ne combinez pas ce paramètre 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 jeton.

Key

model_providers.<id>.auth.command

Type / Values

string

Details

Commande que Codex exécute lorsqu’il a besoin d’un jeton porteur. Elle doit écrire le jeton sur la sortie standard.

Key

model_providers.<id>.auth.cwd

Type / Values

string (path)

Details

Répertoire de travail de la commande d’obtention du jeton.

Key

model_providers.<id>.auth.refresh_interval_ms

Type / Values

number

Details

Intervalle en millisecondes entre deux renouvellements anticipés du jeton par Codex (par défaut : 300000). Utilisez 0 pour que Codex renouvelle le jeton uniquement 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 jeton, en millisecondes (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>.capabilities.external_web_access

Type / Values

boolean

Details

Indique si le service de recherche web hébergé par le fournisseur peut accéder au Web en temps réel. Omettez ce paramètre pour conserver les valeurs par défaut du fournisseur. Les paramètres du modèle et du tour peuvent restreindre davantage cet accès.

Key

model_providers.<id>.capabilities.remote_compaction

Type / Values

unsupported | v2

Details

Protocole de compactage du fournisseur. Avec unsupported, le compactage s’effectue localement. Avec v2, Codex transmet les demandes de compactage via l’API Responses. Omettez ce paramètre pour conserver les valeurs par défaut du fournisseur. Les paramètres du modèle et du tour peuvent limiter davantage la prise en charge du compactage à distance.

Key

model_providers.<id>.env_http_headers

Type / Values

map<string,string>

Details

En-têtes HTTP renseignés à partir des variables d’environnement correspondantes lorsqu’elles sont définies.

Key

model_providers.<id>.env_key

Type / Values

string

Details

Variable d’environnement qui fournit 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

Jeton porteur pour l’authentification auprès du fournisseur. La saisie directe du jeton est déconseillée. 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>.model_catalog_url

Type / Values

string

Details

URL complète d’un catalogue de modèles au format natif de Codex. Omettez ce paramètre pour conserver le mécanisme de découverte des modèles que le fournisseur utilise par défaut.

Key

model_providers.<id>.name

Type / Values

string

Details

Nom affiché pour 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 à l’URL des 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 (par défaut : 4).

Key

model_providers.<id>.requires_openai_auth

Type / Values

boolean

Details

Indique si le fournisseur utilise l’authentification OpenAI (par défaut : false).

Key

model_providers.<id>.stream_idle_timeout_ms

Type / Values

number

Details

Délai maximal d’inactivité d’un flux SSE, en millisecondes (par défaut : 300000).

Key

model_providers.<id>.stream_max_retries

Type / Values

number

Details

Nombre de nouvelles tentatives en cas d’interruption d’un flux SSE (par défaut : 5).

Key

model_providers.<id>.supports_standalone_web_search

Type / Values

boolean

Details

Signale la prise en charge d’un point de terminaison compatible pour la recherche web autonome (par défaut : false). La recherche web autonome est encore en cours de développement et reste 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 le 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 vous omettez ce paramètre.

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_providers.gcp.base_url

Type / Values

string

Details

Redéfinit le point de terminaison intégré de Google Cloud Vertex AI. Si vous omettez ce paramètre, Codex construit l’URL du point de terminaison à partir de l’identifiant du projet et de l’emplacement Google Cloud.

Key

model_providers.gcp.credential_file

Type / Values

string (absolute path)

Details

Chemin du fichier Google Application Default Credentials (ADC). Ce chemin remplace la valeur de GOOGLE_APPLICATION_CREDENTIALS uniquement pour la commande d’authentification du fournisseur.

Key

model_providers.gcp.location

Type / Values

string

Details

Emplacement Google Cloud du point de terminaison Vertex AI. Ce paramètre est prioritaire sur GOOGLE_CLOUD_LOCATION. Valeur par défaut : global.

Key

model_providers.gcp.project_id

Type / Values

string

Details

Identifiant du projet Google Cloud pour le point de terminaison Vertex AI. Ce paramètre est prioritaire sur GOOGLE_CLOUD_PROJECT.

Key

model_reasoning_effort

Type / Values

string

Details

Niveau d’effort de raisonnement proposé par le modèle sélectionné, par exemple low, medium, high, xhigh, max ou ultra. Les niveaux disponibles dépendent du modèle et du client.

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 entièrement.

Key

model_verbosity

Type / Values

low | medium | high

Details

Ce paramètre facultatif redéfinit le niveau de détail des réponses de GPT-5 dans l’API Responses. Si vous l’omettez, la valeur par défaut du modèle ou du préréglage sélectionné s’applique.

Key

notice.hide_full_access_warning

Type / Values

boolean

Details

Indique si l’utilisateur a pris connaissance de l’avertissement relatif à l’accès complet.

Key

notice.hide_gpt-5.1-codex-max_migration_prompt

Type / Values

boolean

Details

Indique si l’utilisateur a pris connaissance du message de migration vers gpt-5.1-codex-max.

Key

notice.hide_gpt5_1_migration_prompt

Type / Values

boolean

Details

Indique si l’utilisateur a pris connaissance du message de migration vers GPT-5.1.

Key

notice.hide_rate_limit_model_nudge

Type / Values

boolean

Details

Indique si l’utilisateur a désactivé le rappel qui propose de changer de modèle lorsque la limite de débit est atteinte.

Key

notice.hide_world_writable_warning

Type / Values

boolean

Details

Indique si l’utilisateur a pris connaissance de l’avertissement concernant les répertoires Windows dans lesquels tous les utilisateurs peuvent écrire.

Key

notice.model_migrations

Type / Values

map<string,string>

Details

Enregistre les migrations de modèles confirmées en associant chaque ancien modèle au nouveau.

Key

notify

Type / Values

array<string>

Details

Commande que Codex appelle pour les notifications. Codex lui transmet les données de notification au format JSON.

Key

openai_base_url

Type / Values

string

Details

URL de base à utiliser à la place de celle du fournisseur de modèles intégré openai.

Key

oss_provider

Type / Values

lmstudio | ollama

Details

Fournisseur local utilisé par défaut avec --oss. Si ce paramètre est absent, Codex vous demande de choisir un fournisseur.

Key

otel.environment

Type / Values

string

Details

Étiquette d’environnement ajouté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 de 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 de l’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_agent_responses

Type / Values

boolean

Details

Transmettez à l’exportateur de journaux OTLP configuré le texte des réponses finales de l’agent principal et des sous-agents lancés. Valeur par défaut : false. Ce texte peut contenir des données sensibles. Sa taille est limitée à 64 Kio par réponse.

Key

otel.log_guardian_assessments

Type / Values

boolean

Details

Transmettez à l’exportateur de journaux OTLP configuré les résultats des révisions automatiques des demandes d’approbation une fois ces révisions terminées. Valeur par défaut : false. Chaque justification peut contenir des données sensibles et sa taille est limitée à 64 Kio.

Key

otel.log_user_prompt

Type / Values

boolean

Details

Activez cette option pour exporter les prompts bruts des utilisateurs 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. L’exportateur par défaut, statsig, exporte les métriques selon la valeur de analytics.enabled. Les exportateurs OTLP configurés explicitement fonctionnent indépendamment de ce paramètre. Utilisez none pour désactiver l’exportation des métriques.

Key

otel.span_attributes

Type / Values

map<string,string>

Details

Ajoutez des attributs de type chaîne à chaque segment de trace exporté.

Key

otel.tool_result.max_bytes

Type / Values

integer (nonnegative)

Details

Nombre maximal d’octets UTF-8 à consigner pour chaque résultat d’outil avant l’avis de troncature. Valeur par défaut : 2048. Ce paramètre s’applique uniquement aux sorties consignées dans les journaux.

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 de l’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

otel.tracestate

Type / Values

map<string,map<string,string>>

Details

Définissez les champs des membres de tracestate (W3C) lors de la propagation du contexte de trace. Chaque membre associe des noms de champs à des valeurs de type chaîne.

Key

permissions.<name>.description

Type / Values

string

Details

Description en clair 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é. Indiquez le nom d’un autre profil nommé, :read-only ou :workspace. Codex rejette :danger-full-access, les références à des parents non définis et les cycles d’héritage.

Key

permissions.<name>.filesystem

Type / Values

table

Details

Profil nommé d’autorisations d’accès au système de fichiers. Chaque clé est un chemin absolu ou un symbole spécial tel que :minimal ou :workspace_roots.

Key

permissions.<name>.filesystem.":workspace_roots".<subpath-or-glob>

Type / Values

"read" | "write" | "deny"

Details

Règle d’accès au système de fichiers qui s’applique relativement à chaque racine effective de l’espace de travail. Utilisez "." pour désigner la racine elle-même. Pour les sous-chemins, des motifs glob tels que "**/*.env" permettent d’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 symbole spécial, ou limitez la portée des entrées imbriquées à cette racine. Utilisez "deny" pour interdire la lecture des chemins correspondants.

Key

permissions.<name>.filesystem.glob_scan_max_depth

Type / Values

number

Details

Profondeur maximale de recherche des chemins correspondant aux motifs glob d’interdiction de lecture sur les plateformes qui enregistrent la liste des correspondances avant le démarrage du bac à sable. Si vous définissez ce paramètre, sa valeur doit être supérieure ou égale à 1.

Key

permissions.<name>.network.allow_local_binding

Type / Values

boolean

Details

Autorise un accès plus large aux réseaux locaux ou privés depuis le bac à sable. Une règle d’autorisation qui spécifie une adresse IP locale exacte ou localhost peut permettre l’accès à la cible locale correspondante même si ce paramètre reste à false.

Key

permissions.<name>.network.allow_upstream_proxy

Type / Values

boolean

Details

Autorise le proxy réseau du bac à sable à relayer le trafic via un autre proxy en amont.

Key

permissions.<name>.network.dangerously_allow_all_unix_sockets

Type / Values

boolean

Details

Autorise toute destination de socket Unix au lieu de l’ensemble restreint prévu par défaut. N’activez cette option que dans des environnements strictement contrôlés.

Key

permissions.<name>.network.dangerously_allow_non_loopback_proxy

Type / Values

boolean

Details

Autorise les services réseau du bac à sable à écouter sur des adresses autres que les adresses de bouclage. L’activation de cette option peut rendre ces services accessibles au-delà de localhost.

Key

permissions.<name>.network.domains

Type / Values

table

Details

Règles de domaine pour les commandes exécutées dans le bac à sable. Elles ne s’appliquent que si le proxy est activé par features.network_proxy ou par une exigence réseau gérée par l’administrateur et activée. Les règles d’autorisation acceptent des noms d’hôte exacts, des motifs tels que *.example.com et **.example.com, ainsi que le motif global *. En cas de conflit, la règle deny l’emporte. 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

Autorise ou interdit l’accès à un hôte désigné par son nom exact ou aux hôtes correspondant à un motif générique ciblé tel que *.example.com ou **.example.com.

Key

permissions.<name>.network.enable_socks5

Type / Values

boolean

Details

Rend SOCKS5 disponible lorsque ce profil d’autorisations active le réseau du bac à sable.

Key

permissions.<name>.network.enable_socks5_udp

Type / Values

boolean

Details

Lorsque cette option est activée, le proxy SOCKS5 accepte le trafic UDP sur son port d’écoute.

Key

permissions.<name>.network.enabled

Type / Values

boolean

Details

Active l’accès réseau pour les commandes exécutées avec ce profil d’autorisations. Ce paramètre ne démarre pas le proxy réseau. Si features.network_proxy est désactivé et qu’aucune exigence réseau gérée par l’administrateur n’est activée, les commandes accèdent directement au réseau et les règles de domaine du profil ne s’appliquent pas.

Key

permissions.<name>.network.mode

Type / Values

limited | full

Details

Mode du proxy réseau 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 le réseau du 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

Modifie la liste des sockets Unix autorisés pour le réseau du bac à sable. Utilisez les chemins des sockets comme clés. allow ajoute un chemin et deny le rejette.

Key

permissions.<name>.network.unix_sockets.<path>

Type / Values

allow | deny

Details

Utilisez allow pour ajouter un chemin absolu de socket Unix à la liste d’autorisation effective ou deny pour le rejeter. Les chemins refusés sont exclus de cette liste.

Key

permissions.<name>.workspace_roots

Type / Values

table

Details

Racines de l’espace de travail définies par le profil. Les règles du système de fichiers :workspace_roots s’appliquent à ces racines ainsi qu’à celles que la session utilise à l’exécution.

Key

permissions.<name>.workspace_roots.<path>

Type / Values

boolean

Details

Définissez cette valeur sur true pour ajouter le chemin aux racines de l’espace de travail du profil. Les entrées désactivées restent inactives.

Key

personality

Type / Values

none | friendly | pragmatic

Details

Paramètre obsolète conservé pour des raisons de compatibilité. Les valeurs friendly et pragmatic ne permettent plus de choisir un style. Avec none, Codex omet la section intégrée « Personnalité » des instructions du modèle. Les remplacements d’instructions définis explicitement continuent de s’appliquer.

Key

plan_mode_reasoning_effort

Type / Values

string

Details

Redéfinit l’effort de raisonnement pour le mode Plan uniquement. Choisissez un niveau pris en charge par le modèle sélectionné. Si vous omettez ce paramètre, le mode Plan utilise la valeur par défaut de son préréglage intégré.

Key

plugins._default.enabled

Type / Values

boolean

Details

Définissez l’état d’activation par défaut des plugins installés. Pour les plugins activés par leur source, un réglage explicite de plugins.<plugin>.enabled remplace cette valeur par défaut. Omettez la table pour conserver les paramètres d’activation de la source ou du compte.

Key

plugins.<plugin>.enabled

Type / Values

boolean

Details

Activez ou désactivez un plugin d’une marketplace locale avec une clé plugin-name@marketplace-name. Codex lit cette valeur dans la configuration résultant de la fusion des paramètres. Les paramètres d’un projet de confiance peuvent remplacer les valeurs par défaut de l’utilisateur, celles gérées dans le cloud et celles du système. L’actualisation de la marketplace peut installer ou actualiser les plugins configurés, même s’ils sont désactivés. Les états d’activation gérés par l’espace de travail ont priorité sur ce paramètre.

Key

plugins.<plugin>.mcp_servers.<server>.default_tools_approval_mode

Type / Values

auto | prompt | writes | approve

Details

Mode d’approbation par défaut des outils d’un serveur MCP fourni par un plugin.

Key

plugins.<plugin>.mcp_servers.<server>.disabled_tools

Type / Values

array<string>

Details

Liste des outils à exclure après application de enabled_tools pour un serveur MCP fourni par un plugin.

Key

plugins.<plugin>.mcp_servers.<server>.enabled

Type / Values

boolean

Details

Activez ou désactivez un serveur MCP fourni avec un plugin installé sans modifier le manifeste du plugin.

Key

plugins.<plugin>.mcp_servers.<server>.enabled_tools

Type / Values

array<string>

Details

Liste des outils autorisés parmi ceux qu’expose un serveur MCP fourni par un plugin.

Key

plugins.<plugin>.mcp_servers.<server>.tools.<tool>.approval_mode

Type / Values

auto | prompt | writes | approve

Details

Redéfinit le mode d’approbation d’un outil MCP fourni par un plugin.

Key

project_doc_fallback_filenames

Type / Values

array<string>

Details

Autres noms de fichiers à essayer si AGENTS.md est absent.

Key

project_doc_max_bytes

Type / Values

number

Details

Nombre maximal d’octets lus dans AGENTS.md pour constituer les instructions du projet.

Key

project_root_markers

Type / Values

array<string>

Details

Noms des fichiers que Codex recherche dans les répertoires parents pour repérer la racine du projet.

Key

projects.<path>.trust_level

Type / Values

string

Details

Définit le niveau de confiance d’un projet ou d’un arbre de travail ("trusted" | "untrusted"). Si le projet n’est pas de confiance, Codex ignore les couches .codex/ propres au projet, notamment sa configuration locale, ses hooks et ses règles.

Key

review_model

Type / Values

string

Details

Modèle de remplacement facultatif pour /review. Par défaut, la commande utilise 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

Exclut /tmp des racines accessibles en écriture en mode workspace-write.

Key

sandbox_workspace_write.exclude_tmpdir_env_var

Type / Values

boolean

Details

Exclut le répertoire indiqué par $TMPDIR des racines accessibles en écriture en mode workspace-write.

Key

sandbox_workspace_write.network_access

Type / Values

boolean

Details

Autorise les connexions réseau sortantes depuis le bac à sable en mode workspace-write.

Key

sandbox_workspace_write.writable_roots

Type / Values

array<string>

Details

Racines supplémentaires accessibles en écriture lorsque sandbox_mode = "workspace-write".

Key

service_tier

Type / Values

string

Details

Offre privilégiée pour les nouveaux tours de conversation. Utilisez fast ou une autre offre proposé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 de configuration.

Key

shell_environment_policy.experimental_use_profile

Type / Values

boolean

Details

Utilisez le profil shell de l’utilisateur pour lancer les sous-processus.

Key

shell_environment_policy.filters

Type / Values

map<string, include | exclude>

Details

Filtres canoniques qui comparent les noms des variables d’environnement à des motifs sans tenir compte de la casse. Les entrées d’inclusion créent une liste d’autorisation et ne peuvent pas rétablir les valeurs exclues. Les valeurs définies explicitement avec set s’appliquent après les exclusions. Ne combinez pas ces filtres avec les anciens tableaux exclude ou include_only dans une même couche de configuration.

Key

shell_environment_policy.ignore_default_excludes

Type / Values

boolean

Details

Conserve les variables dont le nom contient KEY, SECRET ou TOKEN avant l’application des autres filtres (valeur par défaut : true). Utilisez false pour exclure automatiquement les variables dont le nom indique un secret.

Key

shell_environment_policy.include_only

Type / Values

array<string>

Details

Ancienne liste de motifs définissant les variables d’environnement autorisées. Utilisez shell_environment_policy.filters pour toute nouvelle configuration. Ne combinez pas les deux formes dans une même couche de configuration.

Key

shell_environment_policy.inherit

Type / Values

all | core | none

Details

Définit les variables d’environnement dont les sous-processus héritent par défaut à leur lancement.

Key

shell_environment_policy.set

Type / Values

map<string,string>

Details

Valeurs explicites des variables d’environnement, ajoutées après les exclusions. Les filtres d’inclusion peuvent encore les éliminer.

Key

show_raw_agent_reasoning

Type / Values

boolean

Details

Affiche le contenu brut du raisonnement lorsque le modèle actif le produit.

Key

skills.bundled.enabled

Type / Values

boolean

Details

Charge les skills système fournis avec Codex. La valeur par défaut est true. Dans la configuration d’un projet de confiance, réglez ce paramètre sur false pour désactiver ces skills dans ce projet.

Key

skills.config

Type / Values

array<object>

Details

Active ou désactive les skills par nom ou par chemin. Si plusieurs règles correspondent à un même skill, la dernière l’emporte.

Key

skills.config.<index>.enabled

Type / Values

boolean

Details

Active ou désactive le skill référencé.

Key

skills.config.<index>.name

Type / Values

string

Details

Sélectionne tous les skills portant exactement ce nom. Pour chaque entrée, indiquez soit name, soit path.

Key

skills.config.<index>.path

Type / Values

string (path)

Details

Chemin absolu vers un fichier SKILL.md.

Key

skills.include_instructions

Type / Values

boolean

Details

Inclut les instructions automatiques relatives aux skills dans le contexte du modèle. La valeur par défaut est true.

Key

skills.max_context_tokens

Type / Values

integer (positive)

Details

Budget de tokens alloué au catalogue des skills disponibles. Par défaut, il représente 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 où Codex stocke la base de données SQLite qui conserve l’état des tâches des agents ainsi que d’autres données d’état nécessaires à la reprise de l’exécution.

Key

suppress_unstable_features_warning

Type / Values

boolean

Details

Masque l’avertissement qui s’affiche lorsque des options de configuration activent des fonctionnalités en cours de développement.

Key

thread_unload_delay_secs

Type / Values

integer (nonnegative)

Details

Délai en secondes pendant lequel App Server attend avant de décharger un fil inactif sans abonné. Utilisez 0 pour le décharger dès que les deux conditions sont réunies. Le délai par défaut est de 60 secondes.

Key

tool_output_token_limit

Type / Values

number

Details

Nombre maximal de tokens à conserver dans l’historique pour chaque sortie d’outil ou de fonction.

Key

tool_suggest.disabled_tools

Type / Values

array<table>

Details

Désactive les suggestions d’outils 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

Autorise les suggestions d’outils pour d’autres connecteurs ou plugins détectables. Chaque entrée utilise type = "connector" ou "plugin" et un id.

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 position approximative de l’utilisateur. Ces filtres de recherche sont distincts des règles qui régissent l’accès des commandes en bac à sable aux domaines réseau. Ils ne restreignent ni les connecteurs ni les serveurs MCP.

Key

tui

Type / Values

table

Details

Options propres à l’interface du terminal, par exemple l’activation des notifications de bureau intégrées.

Key

tui.alternate_screen

Type / Values

auto | always | never

Details

Détermine si l’interface du terminal utilise l’écran alternatif (par défaut : auto). En mode auto, l’interface évite l’écran alternatif dans Zellij pour préserver l’historique de défilement.

Key

tui.animations

Type / Values

boolean

Details

Active les animations du terminal (écran d’accueil, effet de scintillement et indicateur d’activité rotatif). Valeur par défaut : true.

Key

tui.auto_recap

Type / Values

boolean

Details

Génère automatiquement des récapitulatifs de la conversation lorsque le terminal n’a pas le focus (par défaut : true). Utilisez false pour désactiver les récapitulatifs automatiques. La commande /recap reste disponible.

Key

tui.disable_paste_burst

Type / Values

boolean

Details

Désactive la détection des collages en rafale dans l’interface du terminal (par défaut : false). Ce réglage prime sur l’ancien paramètre de premier niveau disable_paste_burst.

Key

tui.keymap.<context>.<action>

Type / Values

string | array<string>

Details

Raccourci clavier associé à une action de l’interface du terminal. Les contextes pris en charge incluent global, chat, composer, editor, vim_normal, vim_operator, vim_text_object, pager, list et approval. Certaines actions de la zone de saisie utilisent à défaut les raccourcis correspondants de tui.keymap.global. Les raccourcis propres au contexte ont priorité lorsqu’ils sont pris en charge.

Key

tui.keymap.<context>.<action> = []

Type / Values

empty array

Details

Supprimez les raccourcis clavier associés à l’action dans ce contexte. Les noms de 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 de l’infobulle de démarrage, indexé par le slug du modèle.

Key

tui.notification_condition

Type / Values

unfocused | always

Details

Détermine si l’interface du terminal émet des notifications uniquement lorsque le terminal n’a pas le focus ou dans tous les cas. Valeur par défaut : unfocused.

Key

tui.notification_method

Type / Values

auto | osc9 | bel

Details

Méthode d’envoi des notifications du terminal (par défaut : auto).

Key

tui.notifications

Type / Values

boolean | array<string>

Details

Active les notifications de l’interface du terminal. Vous pouvez les limiter à certains types d’événements.

Key

tui.presets.<digit>.input

Type / Values

string

Details

Enregistrez un prompt ou une commande slash dans l’un des dix emplacements (0 à 9) affichés par /presets. Saisissez un texte non vide de 8 000 octets UTF-8 au maximum. Les commandes shell commençant par ! ne sont pas prises en charge.

Key

tui.presets.<digit>.label

Type / Values

string

Details

Nom facultatif du préréglage affiché dans le sélecteur et dans les indications de raccourcis clavier.

Key

tui.raw_output_mode

Type / Values

boolean

Details

Démarre l’interface du terminal avec un historique de défilement en texte brut pour faciliter la sélection et la copie de texte (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 est absent et que le répertoire courant diffère de celui enregistré pour la session, Codex vous demande lequel utiliser.

Key

tui.show_server_version_notice

Type / Values

boolean

Details

Affiche des messages d’information sur les écarts de version avec l’App Server connecté (par défaut : true). Les erreurs de compatibilité et l’état de la version restent visibles même si vous désactivez ces messages.

Key

tui.show_tooltips

Type / Values

boolean

Details

Affiche les infobulles de prise en main sur l’écran d’accueil de l’interface du terminal (par défaut : true).

Key

tui.status_line

Type / Values

array<string> | null

Details

Liste ordonnée des identifiants des éléments de la ligne d’état au bas de l’interface du terminal. null désactive cette ligne.

Key

tui.terminal_title

Type / Values

array<string> | null

Details

Liste ordonnée des identifiants des éléments du titre de la fenêtre ou de l’onglet du terminal. Valeur par défaut : ["spinner", "project"]. null désactive la mise à jour du titre.

Key

tui.theme

Type / Values

string

Details

Thème à utiliser à la place du thème de coloration syntaxique par défaut (nom du thème en kebab-case).

Key

tui.vim_mode_default

Type / Values

boolean

Details

Ouvre la zone de saisie en mode normal de Vim au lieu du mode insertion (par défaut : false). Vous pouvez activer ou désactiver le mode Vim pour chaque session avec /vim.

Key

web_search

Type / Values

disabled | cached | indexed | live

Details

Mode de recherche web (par défaut : "cached"). Le mode cached utilise un index tenu à jour par OpenAI sans accéder au Web externe. Le mode indexed autorise l’accès externe uniquement si l’index de recherche le permet. Si vous utilisez --yolo ou un autre paramètre du bac à sable qui accorde un accès complet, le mode par défaut devient "live". Utilisez "live" pour récupérer des données en direct sans restriction, ou "disabled" pour retirer l’outil.

Key

windows.sandbox

Type / Values

mxc | elevated | unelevated

Details

Implémentation native du bac à sable Windows. La sélection explicite de mxc échoue si MXC est indisponible ou si les exigences gérées en interdisent l’utilisation. Pour sélectionner automatiquement MXC, utilisez features.prefer_mxc avec une ancienne implémentation qui servira de solution de repli.

Pour config.toml, consultez la dernière version du schéma JSON.

Pour bénéficier de l’autocomplétion et des diagnostics lorsque vous modifiez config.toml dans VS Code ou Cursor, installez l’extension Even Better TOML et ajoutez cette ligne au début de votre fichier config.toml :

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

Remarque : renommez experimental_instructions_file en model_instructions_file. L’ancienne clé est obsolète dans Codex. Utilisez le nouveau nom dans vos configurations existantes.

`requirements.toml`

requirements.toml est le fichier de configuration dans lequel l’administrateur définit les contraintes applicables aux paramètres sensibles pour la sécurité. Les utilisateurs ne peuvent pas déroger à ces contraintes. Pour en savoir plus, connaître les emplacements du fichier et consulter des exemples, reportez-vous à la section Exigences imposées par l’administrateur.

Pour les utilisateurs de ChatGPT Business et de ChatGPT Enterprise, Codex peut également appliquer des exigences récupérées depuis le cloud. Consultez la page sur la sécurité pour connaître les règles de priorité. Pour distribuer la politique de la CLI depuis votre propre point de terminaison HTTPS, consultez la section Héberger vous-même la configuration de Codex pour votre équipe.

Utilisez [features] dans requirements.toml pour imposer l’activation ou la désactivation de fonctionnalités à l’exécution avec les mêmes clés canoniques que dans config.toml. Les exigences peuvent aussi inclure des clés documentées propres à l’application qui n’ont pas leur place dans config.toml. Les clés omises ne sont soumises à aucune contrainte.

Certaines exigences gérées imposent une valeur précise plutôt qu’une liste de valeurs autorisées. Lorsqu’une exigence impose un chemin, une préférence de mise à jour, une politique relative au shell de connexion ou un paramètre de collecte des commentaires, les utilisateurs ne peuvent pas en modifier la valeur.

Pour gérer la liste des profils d’autorisations admis, vous devez utiliser Codex 0.138.0 ou une version ultérieure. Codex 0.137.0 et les versions antérieures ignorent allowed_permission_profiles et le paramètre géré default_permissions.

Utilisez allowed_sandbox_modes avec sandbox_mode. Pour les déploiements qui utilisent des profils d’autorisations, associez allowed_permission_profiles au paramètre géré default_permissions.

Une entrée untrusted dans allowed_approval_policies reste valide pour les règles d’approbation plus strictes 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 que vous pouvez remplacer. Si vous redéfinissez 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 usages distincts. in_app_browser contrôle le volet du navigateur qu’une personne ouvre et utilise directement. browser_use contrôle les actions de l’agent dans un navigateur. computer_use contrôle ses actions dans les applications de bureau natives.

Les valeurs imbriquées des politiques Navigateur et Utilisation de l’ordinateur ne suffisent pas à accorder l’accès. Une valeur allow propre à une origine ou à une application peut remplacer la valeur de repli définie par la même source de politique. Les vérifications habituelles portant sur les fonctionnalités, les approbations et les autres politiques continuent de s’appliquer. Lorsque les exigences gérées et config.toml s’appliquent simultanément, une valeur deny provenant de l’une ou l’autre source l’emporte.

Key	Type / Values	Details
`additional_developer_instructions`	`string`	Instructions de développeur gérées, ajoutées dans un message de développeur distinct. Codex rejette les instructions dont la taille estimée dépasse 10 000 tokens, marqueurs de contexte compris.
`allow_appshots`	`boolean`	Utilisez `false` pour désactiver Appshots pour les utilisateurs soumis à la politique. Si vous omettez ce paramètre, les exigences ne restreignent pas Appshots et les conditions habituelles de disponibilité du produit s’appliquent.
`allow_browser_and_computer_use`	`boolean`	Utilisez `false` pour bloquer à la fois la fonctionnalité Navigateur pilotée par l’agent et la fonctionnalité Utilisation de l’ordinateur dans les applications natives. Si vous utilisez `true` ou omettez ce paramètre, cela n’active aucune des deux fonctionnalités. Les autres vérifications liées aux fonctionnalités, aux politiques et aux approbations continuent de s’appliquer.
`allow_login_shell`	`boolean`	Autorisez ou interdisez aux outils shell de lancer un shell de connexion.
`allow_managed_hooks_only`	`boolean`	Si ce paramètre vaut `true`, Codex ignore les hooks de l’utilisateur, du projet, de la session et des plugins, mais autorise les hooks gérés provenant de `requirements.toml` et des autres couches de configuration gérées.
`allow_remote_control`	`boolean`	Utilisez `false` pour désactiver le contrôle à distance des appareils pour les utilisateurs soumis à la politique. Si vous omettez ce paramètre, les exigences ne restreignent pas le contrôle à distance et les conditions habituelles de disponibilité du produit s’appliquent.
`allowed_approval_policies`	`array<string>`	Politiques d’approbation autorisées, par exemple `on-request`, `never` et `granular`. Incluez `untrusted` pour autoriser la politique plus stricte qui s’applique lorsqu’un projet n’est pas considéré comme fiable. Vous ne pouvez pas sélectionner cette politique directement avec `approval_policy`.
`allowed_approvals_reviewers`	`array<string>`	Valeurs autorisées pour `approvals_reviewer`, par exemple `user` et `auto_review`.
`allowed_chatgpt_workspaces`	`array<string>`	Limitez la connexion à ChatGPT, y compris via les jetons d’accès Codex, aux espaces de travail dont les identifiants figurent dans la liste. Une liste vide désactive la connexion à ChatGPT. L’authentification par API reste disponible si elle est autorisée. Définissez ce paramètre dans le fichier local d’exigences système ou via MDM sous macOS. Codex ignore les valeurs gérées dans le cloud.
`allowed_login_methods`	`array<string>`	Autorisez `chatgpt`, `api` ou les deux. Si vous omettez ce paramètre, il ne restreint pas les méthodes de connexion. Si vous le définissez, 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 MDM sous macOS. Codex ignore les valeurs gérées dans le cloud.
`allowed_permission_profiles`	`table<boolean>`	Liste complète des profils d’autorisations admis. Codex autorise les profils définis sur `true` et refuse ceux qui sont omis ou définis sur `false`, y compris les profils ajoutés dans les versions futures. Lors de la fusion de plusieurs sources d’exigences, Codex associe les entrées par nom de profil.
`allowed_permission_profiles.<name>`	`boolean`	Autorise ou interdit 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.
`allowed_sandbox_modes`	`array<string>`	Valeurs autorisées pour `sandbox_mode`.
`allowed_web_search_modes`	`array<string>`	Valeurs autorisées pour `web_search` (`disabled`, `cached`, `indexed`, `live`). La valeur `disabled` est toujours autorisée. Si la liste est vide, seule la valeur `disabled` est autorisée.
`application`	`table`	Exigences applicables à l’application de bureau dans le cadre d’une configuration gérée.
`application.network`	`table`	Restrictions sur les destinations des requêtes réseau de l’application de bureau. Elles sont distinctes des règles qui régissent l’accès des commandes au réseau et des règles d’origine du navigateur. Ces restrictions ne s’appliquent ni aux modules natifs ni aux processus lancés par l’application.
`application.network.domains`	`table<allow \| deny>`	Règles de correspondance exacte des noms de domaine pour les requêtes de l’application de bureau. Lorsque la politique est activée, seules les requêtes HTTPS et WSS vers des domaines explicitement autorisés sont permises. L’autorisation d’un domaine ne s’étend pas à ses sous-domaines.
`application.network.domains.<domain>`	`allow \| deny`	Autorise ou interdit un domaine précis. Utilisez des noms de domaine sans schéma d’URL, port ni caractère générique.
`application.network.enabled`	`boolean`	La valeur par défaut est true si la table est présente. Si ce paramètre vaut true, toute requête externe de l’application de bureau doit viser un domaine explicitement autorisé. Une table de domaines vide n’autorise aucune destination externe. Si la politique réseau de l’application est absente ou si ce paramètre vaut false, aucune restriction de destination ne s’applique au titre de cette politique.
`application.storage`	`table`	Fixez les emplacements de stockage des nouveaux projets et discussions dans les versions de l’application de bureau qui prennent en charge le stockage géré. Chaque chemin remplace indépendamment la préférence locale correspondante. Les paramètres de stockage ne restreignent pas l’accès au système de fichiers.
`application.storage.default_project_parent`	`string (absolute path)`	Répertoire parent des nouveaux projets locaux créés avec l’option Partir de zéro.
`application.storage.projectless_workspace_root`	`string (absolute path)`	Répertoire racine des nouvelles discussions créées sans projet.
`apps`	`table`	Exigences gérées pour les applications, indexées par identifiant d’application. Elles peuvent désactiver une application ou restreindre les modes d’approbation autorisés pour chacun de ses outils.
`apps.<id>.enabled`	`boolean`	Utilisez `false` pour désactiver une application. La désactivation reste en vigueur lors de la fusion de plusieurs sources d’exigences.
`apps.<id>.tools.<tool>.approval_mode`	`auto \| prompt \| writes \| approve`	Définissez le mode d’approbation imposé pour un outil de l’application.
`auto_review`	`table`	Exigences gérées pour la fonctionnalité Révision automatique.
`auto_review.ignore_rules`	`array<string>`	Slugs complets des modèles pour lesquels Codex ignore les règles de préfixe `allow` de la politique d’exécution des commandes. Indiquez le slug exact, avec l’espace de noms du fournisseur s’il en comporte un. Contrairement à `required_on_models`, ce paramètre n’accepte pas d’alias sans espace de noms. Les règles d’interdiction et les règles réseau restent applicables.
`auto_review.required_on_models`	`array<string>`	Slugs des modèles pour lesquels la révision automatique est obligatoire. Chaque slug doit être non vide, sans espace de noms de fournisseur ni caractère d’espacement en début ou en fin de chaîne. Codex combine les listes provenant de plusieurs sources d’exigences.
`browser_use`	`table`	Exigences gérées pour la fonctionnalité Navigateur pilotée par l’agent.
`browser_use.allow_global_persistent_approval`	`boolean`	Utilisez `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 de ce type déjà enregistrées sont ignorées mais conservées. Si vous utilisez `true` ou omettez ce paramètre, aucune approbation n’est créée.
`browser_use.allow_history_access`	`boolean`	Utilisez `false` pour empêcher la fonctionnalité Navigateur de lire l’historique de navigation. Si vous utilisez `true` ou omettez ce paramètre, les paramètres habituels de l’historique et les vérifications de disponibilité continuent de s’appliquer.
`browser_use.allow_webmcp`	`boolean`	Autorisez l’accès aux outils des sites (WebMCP) via la politique de l’espace de travail pour les offres gérées éligibles. Si vous utilisez `true` ou omettez ce paramètre, cette politique autorise l’accès. Avec `false`, elle cesse de l’accorder. Les utilisateurs peuvent toujours accéder à ces outils si la fonctionnalité est déployée pour leur compte. Les paramètres du navigateur et les autorisations des sites s’appliquent.
`browser_use.default_origin_policy`	`table`	Pour chaque paramètre de la fonctionnalité Navigateur, la valeur de repli s’applique lorsqu’aucune entrée correspondante sous `browser_use.origins` ne définit ce paramètre. Si une règle correspondant à l’origine définit ce paramètre, sa valeur remplace la valeur de repli pour la source de configuration concernée. Codex compare ensuite le résultat des exigences gérées à celui de la configuration utilisateur et applique le plus restrictif des deux.
`browser_use.default_origin_policy.access`	`allow \| deny`	Utilisez `deny` pour bloquer la fonctionnalité Navigateur sur les origines auxquelles la valeur de repli s’applique. Ce blocage interdit aussi les envois et les téléchargements de fichiers, l’accès complet aux fonctions de débogage du navigateur et la révision automatique sur ces origines. `allow` permet uniquement de poursuivre les vérifications habituelles d’approbation et de conformité aux politiques.
`browser_use.default_origin_policy.access_approval_lifetime`	`turn \| thread`	Définissez la durée de validité d’une approbation non persistante d’accès à un site. Avec `turn`, elle expire à la fin du tour en cours. Avec `thread`, elle reste valable jusqu’à la fin du fil en cours. Le paramètre `persistent_approval` détermine séparément si l’option `Always allow` est disponible. La valeur par défaut est `thread`.
`browser_use.default_origin_policy.auto_review`	`allow \| deny`	Utilisez `deny` pour désactiver la révision automatique sur les origines auxquelles la valeur de repli s’applique et demander directement l’approbation de l’utilisateur. Avec `allow`, la révision automatique reste disponible si les autres paramètres le permettent.
`browser_use.default_origin_policy.downloads`	`allow \| deny`	Utilisez `deny` pour bloquer les téléchargements via la fonctionnalité Navigateur sur les origines auxquelles la valeur de repli s’applique. `allow` permet uniquement de poursuivre les vérifications habituelles d’approbation et de conformité aux politiques.
`browser_use.default_origin_policy.full_cdp_access`	`allow \| deny`	Utilisez `deny` pour bloquer l’accès complet au protocole Chrome DevTools (CDP) sur les origines auxquelles la valeur de repli s’applique. `allow` permet uniquement de poursuivre les vérifications habituelles d’activation explicite et d’approbation.
`browser_use.default_origin_policy.persistent_approval`	`boolean`	Utilisez `false` pour empêcher la fonctionnalité Navigateur d’enregistrer ou d’appliquer une approbation `Always allow` sur les origines auxquelles la valeur de repli s’applique. Les approbations pour le tour ou le fil en cours peuvent toujours s’appliquer. La valeur `true` rend l’option `Always allow` disponible si les autres conditions le permettent, sans créer d’approbation.
`browser_use.default_origin_policy.uploads`	`allow \| deny`	Utilisez `deny` pour bloquer les envois de fichiers via la fonctionnalité Navigateur sur les origines auxquelles la valeur de repli s’applique. `allow` permet uniquement de poursuivre les vérifications habituelles d’approbation et de conformité aux politiques.
`browser_use.disable_auto_review`	`boolean`	Utilisez `true` pour désactiver la révision automatique pour la fonctionnalité Navigateur et demander directement l’approbation de l’utilisateur. Si vous utilisez `false` ou omettez ce paramètre, la révision automatique reste disponible lorsque les autres paramètres le permettent.
`browser_use.extension`	`table`	Paramètres gérés de la fonctionnalité Navigateur dans les extensions Chromium prises en charge.
`browser_use.extension.request_headers`	`array<table>`	Ajoutez jusqu’à 16 en-têtes HTTP aux requêtes provenant des onglets pilotés par l’agent dans les extensions Chromium prises en charge. Utilisez une liste vide pour n’envoyer aucun en-tête géré.
`browser_use.extension.request_headers[].name`	`string`	Nom de l’en-tête. Les noms réservés, notamment `Authorization` et `Cookie`, sont interdits. La seule substitution possible dans les noms et les valeurs est `{{session_id}}`.
`browser_use.extension.request_headers[].value`	`string`	Valeur de l’en-tête à envoyer avec les requêtes correspondantes du navigateur.
`browser_use.origins`	`map<string, table>`	Politiques de la fonctionnalité Navigateur propres à chaque origine. Les clés ont la forme `<scheme>://<host-pattern>[:<port>]`, avec `http` ou `https`. Utilisez un nom d’hôte exact, `.example.com` pour les sous-domaines uniquement ou `.example.com` pour le domaine de base et ses sous-domaines. Dans les autres motifs, le caractère générique `` peut représenter une suite de caractères contenant des points. Ainsi, `region.example.com` correspond aussi à `region.api.example.com`. Le motif d’hôte `` correspond à tous les hôtes du schéma indiqué. La correspondance tient compte du schéma et des ports autres que le port par défaut. La normalisation supprime le port par défaut s’il est indiqué explicitement. Les chemins, les chaînes de requête, les noms d’utilisateur ou mots de passe intégrés et les caractères génériques dans le schéma ou le port sont invalides. En TOML, placez le motif entre guillemets, par exemple `[browser_use.origins."https://**.example.com"]`.
`browser_use.origins.<pattern>`	`table`	Politique applicable aux origines correspondant à ce motif. Si plusieurs motifs correspondent, Codex retient la valeur la plus restrictive pour chaque capacité. `deny` prime sur `allow`, `false` sur `true` et `turn` sur `thread`.
`browser_use.origins.<pattern>.access`	`allow \| deny`	Utilisez `deny` pour bloquer la fonctionnalité Navigateur sur les origines correspondantes. Ce refus y bloque aussi les envois et les téléchargements de fichiers, l’accès complet au débogage du navigateur et la révision automatique. `allow` permet uniquement de poursuivre les vérifications habituelles relatives aux approbations et aux politiques applicables.
`browser_use.origins.<pattern>.access_approval_lifetime`	`turn \| thread`	Définissez la durée de validité d’une approbation non persistante d’accès à un site pour les origines correspondantes. Avec `turn`, l’approbation vaut uniquement pour le tour en cours. Avec `thread`, elle reste valable jusqu’à la fin du fil en cours. Le paramètre `persistent_approval` détermine séparément si l’option `Always allow` est disponible.
`browser_use.origins.<pattern>.auto_review`	`allow \| deny`	Utilisez `deny` pour demander directement l’approbation de l’utilisateur sans passer par la révision automatique sur les origines correspondantes. Avec `allow`, la révision automatique reste disponible si les autres paramètres le permettent.
`browser_use.origins.<pattern>.downloads`	`allow \| deny`	Utilisez `deny` pour bloquer les téléchargements effectués par la fonctionnalité Navigateur sur les origines correspondantes. `allow` permet uniquement de poursuivre les vérifications habituelles relatives aux approbations et aux politiques applicables.
`browser_use.origins.<pattern>.full_cdp_access`	`allow \| deny`	Utilisez `deny` pour bloquer l’accès complet au protocole Chrome DevTools (CDP) sur les origines correspondantes. `allow` permet uniquement de poursuivre les vérifications habituelles d’activation explicite et d’approbation.
`browser_use.origins.<pattern>.persistent_approval`	`boolean`	Utilisez `false` pour empêcher la fonctionnalité Navigateur d’enregistrer ou d’appliquer une approbation `Always allow` sur les origines correspondantes. Les approbations accordées pour le tour ou le fil en cours peuvent toujours s’appliquer. La valeur `true` rend l’option `Always allow` disponible si les autres conditions le permettent, sans accorder d’approbation.
`browser_use.origins.<pattern>.uploads`	`allow \| deny`	Utilisez `deny` pour bloquer les envois de fichiers effectués par la fonctionnalité Navigateur sur les origines correspondantes. `allow` permet uniquement de poursuivre les vérifications habituelles relatives aux approbations et aux politiques applicables.
`chatgpt_base_url`	`string`	Imposez l’URL de base du service ChatGPT avant l’authentification et la récupération de la politique depuis le 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 MDM sous macOS. Codex ignore les valeurs gérées dans le cloud.
`check_for_update_on_startup`	`boolean`	Imposez ou désactivez la recherche de mises à jour au démarrage de Codex.
`cli_auth_credentials_store`	`file \| keyring \| auto \| ephemeral`	Imposez le mode de stockage des identifiants de la CLI avant le chargement de l’authentification. `file` utilise `CODEX_HOME/auth.json`. `keyring` exige 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 la durée du processus en cours. Définissez ce paramètre dans le fichier local d’exigences système ou via MDM sous macOS. Codex ignore les valeurs gérées dans le cloud.
`computer_use`	`table`	Exigences gérées pour les actions de l’agent dans les applications de bureau natives. Les règles gérées relatives aux applications et celles de `config.toml` s’appliquent conjointement. Les deux sources de règles doivent autoriser l’application.
`computer_use.allow_locked_computer_use`	`boolean`	Utilisez `false` pour empêcher les utilisateurs d’activer l’utilisation de l’ordinateur verrouillé sur un appareil macOS géré. Ce paramètre supprime les commandes d’activation sans désactiver la fonctionnalité si elle est déjà activée. Si vous omettez ce paramètre, les conditions habituelles de disponibilité s’appliquent.
`computer_use.allow_persistent_approval`	`boolean`	Utilisez `false` pour supprimer l’option permettant de conserver les approbations d’applications d’une session à l’autre. Les approbations pour la session en cours restent disponibles. Si vous choisissez `true` ou omettez ce paramètre, aucune application n’est approuvée de ce seul fait.
`computer_use.default_app_access`	`allow \| deny`	Règle d’accès par défaut pour les applications natives qui ne correspondent à aucune règle propre à la plateforme. `deny` bloque l’accès. `allow` permet uniquement de poursuivre la procédure d’approbation et les contrôles de politique habituels. La valeur par défaut du produit est `allow`.
`computer_use.macos`	`table`	Règles de la fonctionnalité Utilisation de l’ordinateur pour les applications macOS.
`computer_use.macos.bundle_ids`	`map<string, allow \| deny>`	Associez chaque identifiant exact de bundle macOS à `allow` ou `deny`. Une règle correspondante remplace `computer_use.default_app_access` au sein de la même source de politique. Tout refus provenant des exigences gérées ou de la configuration de l’utilisateur bloque l’accès.
`computer_use.macos.bundle_ids.<bundle-id>`	`allow \| deny`	Utilisez `deny` pour bloquer l’application dont l’identifiant de bundle correspond exactement à celui indiqué. `allow` remplace uniquement la valeur par défaut de cette source de politique. Les autres sources de politique et la procédure habituelle d’approbation doivent aussi autoriser l’application.
`computer_use.windows`	`table`	Règles de la fonctionnalité Utilisation de l’ordinateur pour les applications Windows distribuées avec ou sans package.
`computer_use.windows.aumids`	`map<string, allow \| deny>`	Associez l’identifiant Application User Model ID (AUMID) de chaque application signée distribuée en package à `allow` ou `deny`. Utilisez l’identifiant exact tel qu’il est enregistré. Une règle correspondante remplace `computer_use.default_app_access` au sein de la même source de politique.
`computer_use.windows.aumids.<aumid>`	`allow \| deny`	Utilisez `deny` pour bloquer l’application distribuée en package dont l’identité correspond exactement à celle indiquée. `allow` remplace uniquement la valeur par défaut de cette source de politique. Les autres sources de politique et la procédure habituelle d’approbation doivent aussi autoriser l’application.
`computer_use.windows.exes`	`array<table>`	Règles pour les exécutables Windows signés distribués sans package. La correspondance se fonde sur l’éditeur vérifié et les informations de version signées de l’exécutable, indépendamment de son chemin ou du nom actuel du fichier. Si plusieurs règles correspondent, une interdiction l’emporte sur toute autorisation. Les exécutables non signés relèvent de `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.
`computer_use.windows.exes[].access`	`allow \| deny`	Décision d’accès obligatoire pour les exécutables correspondant à la règle. `deny` bloque l’accès. `allow` remplace uniquement la valeur par défaut de cette source de politique. Les autres sources de politique et la procédure habituelle d’approbation doivent aussi autoriser l’application.
`computer_use.windows.exes[].binary_name`	`string`	Valeur facultative de `OriginalFilename` dans les informations de version signées de l’exécutable. La comparaison est insensible à la casse. Si une règle correspondant à l’éditeur et au produit exige cette valeur et que l’exécutable ne la fournit pas, la fonctionnalité Utilisation de l’ordinateur bloque l’exécutable.
`computer_use.windows.exes[].product_name`	`string`	Indiquez la valeur exacte de `ProductName` figurant dans les informations de version signées de l’exécutable. Cette valeur est obligatoire.
`computer_use.windows.exes[].publisher_name`	`string`	Indiquez le nom exact de l’éditeur tel qu’il figure dans le certificat de signature de confiance de l’exécutable, au format de nom distinctif X.500 de Windows. Cette valeur est obligatoire.
`config_server`	`table`	Rattachez Codex à un serveur de configuration. Définissez ce paramètre dans les exigences locales contrôlées par l’administrateur.
`config_server`	`table`	Rattachez Codex à un serveur de configuration à l’aide des exigences gérées localement. Codex récupère son ensemble de politiques auprès de ce serveur. Une politique gérée dans le cloud ne peut pas configurer son propre serveur.
`config_server.base_url`	`string (HTTPS URL)`	URL de base du serveur de configuration enregistré par l’administrateur. Codex ajoute /codex/config/bundle à la fin de cette URL.
`config_server.base_url`	`string`	URL de base HTTPS obligatoire. Codex y ajoute `/codex/config/bundle`. Omettez les identifiants, les paramètres de requête et les fragments de l’URL de base.
`config_server.oauth`	`table`	Paramètres facultatifs de connexion au compte d’entreprise. Omettez cette table pour récupérer le paquet de configuration sans identifiants.
`config_server.oauth`	`table`	Paramètres OAuth pour la connexion au serveur de configuration. Indiquez `authorization_url`, `token_url` et un `client_id` non vide. Les champs facultatifs sont `device_authorization_url`, `resource`, `scopes` (liste vide par défaut) et `redirect_port` (valeur différente de zéro). Toutes les URL des points de terminaison doivent utiliser HTTPS.
`config_server.oauth.authorization_url`	`string (HTTPS URL)`	Point de terminaison d’autorisation pour la connexion au compte d’entreprise dans le navigateur. Obligatoire si OAuth est configuré.
`config_server.oauth.client_id`	`string`	Identifiant client OAuth public enregistré pour Codex. Obligatoire si OAuth est configuré.
`config_server.oauth.redirect_port`	`number`	Port facultatif pour le rappel du navigateur sur 127.0.0.1. Par défaut, Codex choisit un port disponible.
`config_server.oauth.resource`	`string`	Identifiant facultatif de la ressource OAuth à fournir si le fournisseur d’identité l’exige.
`config_server.oauth.scopes`	`array<string>`	Autorisations OAuth facultatives à demander au fournisseur d’identité.
`config_server.oauth.token_url`	`string (HTTPS URL)`	Point de terminaison utilisé pour obtenir les jetons lors de la connexion au compte d’entreprise et pour les renouveler. Obligatoire si OAuth est configuré.
`default_permissions`	`string`	Profil d’autorisations par défaut défini par la configuration gérée. Il doit être autorisé par `allowed_permission_profiles`. Définissez-le explicitement pour obtenir un comportement prévisible. Si vous omettez ce paramètre, Codex ne choisit `:workspace` par défaut que si `:workspace` et `:read-only` sont tous deux explicitement autorisés.
`enforce_residency`	`string`	Impose une région de résidence des données prise en charge pour le trafic des services Codex. La valeur actuellement acceptée est `us`.
`features`	`table`	Valeurs imposées pour les fonctionnalités. Utilisez les noms canoniques de `config.toml` pour les fonctionnalités de l’environnement d’exécution. Cette table accepte aussi les clés d’exigences documentées propres à l’application.
`features.<name>`	`boolean`	Imposez l’état activé ou désactivé d’une fonctionnalité documentée de l’environnement d’exécution ou de l’application.
`features.api_key_cyber_access_programs`	`boolean`	En cas d’authentification par clé API, autorisez Codex à indiquer dans ses requêtes au fournisseur OpenAI intégré le programme d’accès aux fonctionnalités de cybersécurité qui a été explicitement sélectionné. Le compte et le modèle doivent déjà avoir accès à ce programme.
`features.apps`	`boolean`	Imposez l’activation ou la désactivation de l’intégration Applications pour les utilisateurs soumis à la politique.
`features.browser_annotation_api`	`boolean`	Utilisez `false` pour empêcher les sites web de personnaliser les annotations dans le navigateur intégré. Les utilisateurs peuvent toujours annoter les pages eux-mêmes. Utilisez `true` pour autoriser ces personnalisations lorsque l’application et le compte les prennent en charge.
`features.browser_use`	`boolean`	Utilisez `false` dans `requirements.toml` pour désactiver la fonctionnalité Navigateur pilotée par l’agent.
`features.browser_use_external`	`boolean`	Utilisez `false` dans `requirements.toml` pour empêcher Codex de piloter les navigateurs pris en charge via l’extension de navigateur ChatGPT, y compris dans les onglets existants et les sessions déjà authentifiées.
`features.browser_use_full_cdp_access`	`boolean`	Utilisez `false` dans `requirements.toml` pour désactiver l’accès complet au protocole Chrome DevTools dans l’environnement d’exécution local, y compris le mode développeur du navigateur, et empêcher l’application de bureau ChatGPT d’activer le paramètre correspondant. Si vous omettez ce paramètre, les conditions habituelles de disponibilité du produit s’appliquent.
`features.computer_use`	`boolean`	Utilisez `false` dans `requirements.toml` pour désactiver les fonctionnalités « Utilisation de l’ordinateur » et « Enregistrement et relecture », ainsi que les procédures d’installation ou d’activation associées.
`features.fast_mode`	`boolean`	Autorisez ou bloquez le mode Rapide pour les utilisateurs soumis à la politique. Les anciennes versions du serveur d’application utilisent aussi ce paramètre pour contrôler l’accès au mode ultrarapide.
`features.guardian_approval`	`boolean`	Autorisez ou bloquez l’accès à l’approbation par Guardian pour les utilisateurs soumis à la politique.
`features.in_app_browser`	`boolean`	Utilisez `false` dans `requirements.toml` pour désactiver le volet du navigateur intégré que les utilisateurs ouvrent et contrôlent directement.
`features.in_app_chat`	`boolean`	Utilisez `false` pour masquer, dans l’application de bureau ChatGPT, les écrans de conversation de ChatGPT et de ChatGPT Work ainsi que les éléments d’interface associés aux automatisations dans le cloud. Ce paramètre ne bloque pas ChatGPT Voice et n’arrête pas les tâches existantes dans le cloud. Avec la valeur `true`, les vérifications liées au compte, aux autorisations de l’espace de travail et au déploiement restent en vigueur.
`features.in_app_dictation`	`boolean`	Utilisez `false` pour désactiver la dictée intégrée à l’application de bureau ChatGPT. Avec la valeur `true`, les autres vérifications de disponibilité restent en vigueur.
`features.in_app_local_automation`	`boolean`	Utilisez `false` pour désactiver les tâches planifiées locales dans l’application de bureau ChatGPT. Avec la valeur `true`, les autres vérifications de disponibilité restent en vigueur.
`features.in_app_updates`	`boolean`	Utilisez `false` dans `requirements.toml` pour désactiver les mises à jour depuis l’application. Les mises à jour restent activées par défaut si vous omettez cette exigence.
`features.in_app_voice`	`boolean`	Utilisez `false` pour désactiver les échanges vocaux en temps réel avec Codex dans l’application de bureau ChatGPT. Utilisez `features.in_app_dictation` pour gérer la dictée séparément.
`features.memories`	`boolean`	Autorisez ou bloquez l’accès aux Mémoires pour les utilisateurs soumis à la politique.
`features.multi_agent`	`boolean`	Autorisez ou bloquez l’accès aux fonctionnalités multi-agents pour les utilisateurs soumis à la politique.
`features.plugin_sharing`	`boolean`	Utilisez `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.
`features.plugins`	`boolean`	Autorisez ou bloquez l’accès aux plugins pour les utilisateurs soumis à la politique.
`features.realtime_conversation`	`boolean`	Utilisez `false` pour désactiver la commande expérimentale `/voice` dans la CLI Codex. Ne vous fiez pas à ce paramètre pour bloquer ChatGPT Voice dans l’application de bureau ChatGPT ou dans les sessions vocales de l’App Server. La valeur `true` ne permet pas de contourner les vérifications liées au client ou au déploiement.
`features.remote_plugin`	`boolean`	Autorisez ou bloquez l’accès au catalogue distant de plugins pour les utilisateurs soumis à la politique.
`features.standalone_web_search`	`boolean`	Paramètre expérimental. Utilisez `true` pour conserver la configuration native de recherche web de l’application de bureau ChatGPT lorsque la recherche hébergée serait autrement disponible via MCP.
`features.ultrafast_mode`	`boolean`	Autorisez ou bloquez le mode ultrarapide pour les utilisateurs soumis à la politique. Sur les serveurs d’application qui prennent en charge des réglages de vitesse indépendants, ce paramètre s’applique même si le mode Rapide est désactivé. La disponibilité du mode ultrarapide dépend du modèle et du compte.
`features.workspace_dependencies`	`boolean`	Autorisez ou bloquez l’accès à l’environnement d’exécution fourni pour les dépendances de l’espace de travail pour les utilisateurs soumis à la politique.
`feedback`	`table`	Paramètres gérés pour l’envoi de commentaires.
`feedback.enabled`	`boolean`	Autorisez ou interdisez aux utilisateurs d’envoyer des commentaires depuis tous les clients Codex.
`guardian_policy_config`	`string`	Texte Markdown géré qui remplace la politique par défaut de la fonctionnalité Révision automatique. Il prévaut sur la valeur locale de `[auto_review].policy`. Codex ignore les valeurs vides ou composées uniquement de caractères d’espacement.
`hooks`	`table`	Hooks gérés que l’administrateur impose pour les événements du cycle de vie. Ils nécessitent un répertoire de hooks gérés et utilisent le même schéma d’événements que les hooks définis directement sous `[hooks]` dans `config.toml`.
`hooks.<Event>`	`array<table>`	Groupes de critères de correspondance pour un événement de hook tel que `PreModelRequest`, `PostModelRequest`, `PreToolUse`, `PermissionRequest`, `PostToolUse`, `PreCompact`, `PostCompact`, `SessionStart`, `SessionEnd`, `SubagentStart`, `SubagentStop`, `UserPromptSubmit` ou `Stop`.
`hooks.<Event>[].hooks`	`array<table>`	Gestionnaires de hooks pour un groupe de critères de correspondance. Codex prend en charge les hooks de commande et d’outil MCP. Il analyse les gestionnaires de hooks de prompt et d’agent sans les exécuter.
`hooks.<Event>[].hooks[].additionalContextLimit`	`integer`	Seuil approximatif, exprimé en tokens pour chaque gestionnaire, au-delà duquel Codex enregistre `additionalContext` sur disque et présente un aperçu plus court au modèle. La valeur par défaut est `2500`. Avec `0`, le modèle reçoit directement tout le contexte. Consultez Sorties volumineuses des hooks.
`hooks.<Event>[].hooks[].async`	`boolean`	Exécute un hook de commande en arrière-plan sans retarder l’opération qui le déclenche. La valeur par défaut est `false`. Les hooks de l’événement `SessionEnd` s’exécutent toujours de façon synchrone. Consultez Exécuter des hooks en arrière-plan.
`hooks.<Event>[].hooks[].commandWindows`	`string`	Commande de remplacement propre à Windows pour les hooks de commande. Codex accepte également l’alias TOML `command_windows`.
`hooks.managed_dir`	`string (absolute path)`	Répertoire contenant les scripts de hooks gérés sous macOS et Linux. Codex vérifie que le chemin est absolu et que le répertoire existe avant de charger les hooks gérés.
`hooks.windows_managed_dir`	`string (absolute path)`	Répertoire contenant les scripts de hooks gérés sous Windows. Codex vérifie que le chemin est absolu et que le répertoire existe avant de charger les hooks gérés.
`in_app_browser`	`table`	Exigences applicables au volet du navigateur intégré. Ces paramètres ne contrôlent pas la fonctionnalité Navigateur pilotée par l’agent.
`in_app_browser.allow_external_browser_settings_import`	`boolean`	Utilisez `false` pour empêcher les utilisateurs d’importer dans le navigateur intégré les paramètres ou les données de navigation d’un navigateur externe. Si vous utilisez `true` ou omettez ce paramètre, l’importation reste disponible lorsque les autres vérifications du produit le permettent. Ce paramètre est réservé à la configuration gérée. Vous ne pouvez pas le redéfinir dans `config.toml`.
`log_dir`	`string (path)`	Imposez le répertoire dans lequel Codex écrit ses fichiers journaux locaux.
`marketplaces`	`table`	Exigences de l’administrateur pour les sources des marketplaces de plugins. Les règles s’appliquent lorsque `restrict_to_allowed_sources` vaut `true`.
`marketplaces.allowed_sources`	`table`	Sources de marketplace autorisées, indexées par nom de règle. L’administrateur choisit ces noms. Lors de la fusion des couches d’exigences, les règles de noms distincts se cumulent. Pour les règles de même nom, l’ordre de priorité habituel des couches s’applique à chaque champ.
`marketplaces.allowed_sources.<name>`	`table`	Règle autorisant une source. Après la fusion des exigences, la valeur finale de `source` détermine quels autres champs de la même table Codex interprète.
`marketplaces.allowed_sources.<name>.host_pattern`	`string`	Expression régulière obligatoire lorsque `source = "host_pattern"`. Codex extrait le nom d’hôte d’une source Git au format HTTPS, SSH ou de type SCP, le convertit en minuscules et le compare à l’expression. Utilisez `^` et `$` pour exiger que l’expression corresponde au nom d’hôte entier.
`marketplaces.allowed_sources.<name>.path`	`string (absolute path)`	Répertoire local de la marketplace, obligatoire lorsque `source = "local"`. Codex exige un chemin absolu et compare les chemins après normalisation.
`marketplaces.allowed_sources.<name>.ref`	`string`	Référence Git exacte facultative pour une règle `git`. Si vous l’omettez, la règle autorise toute référence du dépôt correspondant.
`marketplaces.allowed_sources.<name>.source`	`git \| host_pattern \| local`	Type de critère de correspondance pour la source de marketplace. Utilisez `git` pour un seul dépôt, `host_pattern` pour les hôtes Git dont le nom correspond à une expression régulière ou `local` pour un seul répertoire.
`marketplaces.allowed_sources.<name>.url`	`string`	URL du dépôt Git, obligatoire lorsque `source = "git"`. Codex normalise l’URL configurée et l’URL autorisée, puis exige qu’elles désignent exactement le même dépôt.
`marketplaces.restrict_to_allowed_sources`	`boolean`	Si ce paramètre vaut `true`, les sources de marketplace configurées doivent correspondre à une règle de `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 aussi correspondre à une règle de la liste d’autorisation. Les plugins fournis avec l’espace de travail et ceux qui y sont installés à distance sont gérés séparément de cette politique relative aux sources Git sélectionnées.
`mcp_servers`	`table`	Liste des serveurs MCP dont l’activation est autorisée. Le nom du serveur (`<id>`) et son identité doivent tous deux correspondre à une même entrée de la liste pour que le serveur puisse être activé. Codex désactive tout serveur MCP configuré qui ne figure pas dans la liste ou dont l’identité ne correspond pas à celle de l’entrée.
`mcp_servers.<id>.identity`	`table`	Règle d’identité d’un serveur MCP. Définissez soit `command` (stdio), soit `url` (HTTP en streaming).
`mcp_servers.<id>.identity.command`	`string \| table`	Pour autoriser un serveur MCP stdio, indiquez la chaîne de commande exacte ou utilisez une table de critères pour exiger une correspondance exacte de l’exécutable et vérifier chaque argument à sa position. Si vous indiquez une chaîne, Codex ne vérifie ni les arguments, ni `cwd`, ni `env`, ni `env_vars`.
`mcp_servers.<id>.identity.command.args`	`array<table>`	Liste ordonnée de critères de correspondance pour les arguments d’un serveur stdio. La liste d’arguments configurée doit avoir la même longueur que la liste de critères. Chaque argument doit satisfaire au critère qui occupe la même position. Les critères de commande ne vérifient ni `cwd`, ni `env`, ni `env_vars`.
`mcp_servers.<id>.identity.command.args[].expression`	`string`	Expression régulière utilisée par un critère d’argument de type `regex`. Elle doit être valide et correspondre à la valeur complète de l’argument.
`mcp_servers.<id>.identity.command.args[].match`	`exact \| prefix \| regex`	Type de comparaison pour l’argument à cette position.
`mcp_servers.<id>.identity.command.args[].value`	`string`	Valeur de comparaison pour un critère d’argument de type `exact` ou `prefix`.
`mcp_servers.<id>.identity.command.executable`	`string`	Exécutable auquel la valeur de `command` configurée pour le serveur stdio doit correspondre exactement.
`mcp_servers.<id>.identity.url`	`string \| table`	Pour autoriser un serveur MCP utilisant le transport HTTP en streaming, indiquez l’URL exacte sous forme de chaîne ou utilisez une table qui définit un critère de correspondance de type `exact`, `prefix` ou `regex`.
`mcp_servers.<id>.identity.url.expression`	`string`	Expression régulière utilisée par un critère d’URL de type `regex`. Elle doit être valide et correspondre à l’URL complète.
`mcp_servers.<id>.identity.url.match`	`exact \| prefix \| regex`	Type de comparaison pour l’URL configurée du serveur MCP.
`mcp_servers.<id>.identity.url.value`	`string`	Valeur de comparaison pour un critère d’URL de type `exact` ou `prefix`.
`model_catalog_json`	`string (path)`	Imposez le catalogue de modèles au format JSON que Codex utilise au démarrage.
`model_provider`	`string`	Impose l’identifiant du fournisseur de modèles. Cette valeur prévaut sur celles de la configuration locale et de la configuration de session.
`model_providers`	`map<string, table>`	Définitions gérées des fournisseurs de modèles. Chaque entrée remplace intégralement la définition du fournisseur configuré sous le même identifiant. Codex ne fusionne pas les champs de cette entrée avec ceux de la définition de l’utilisateur. Les fournisseurs portant d’autres identifiants restent disponibles.
`model_providers.<id>`	`table`	Définition complète d’un fournisseur géré. Elle utilise les mêmes champs de fournisseur que `config.toml`, notamment `name`, `base_url` et les paramètres d’authentification et de transport.
`models`	`table`	Contient la table `[models.new_thread]`.
`models.new_thread`	`table`	Valeurs par défaut facultatives qui s’appliquent au démarrage d’un nouveau fil local. Elles ont priorité sur les valeurs par défaut de l’utilisateur et du projet, mais vous pouvez les remplacer explicitement.
`models.new_thread.model`	`string`	Modèle par défaut pour les nouveaux fils. Si vous redéfinissez explicitement le modèle ou l’effort de raisonnement, Codex ignore les deux champs.
`models.new_thread.model_reasoning_effort`	`string`	Effort de raisonnement par défaut pour les nouveaux fils. Si vous redéfinissez explicitement le modèle ou l’effort de raisonnement, Codex ignore les deux champs.
`models.new_thread.service_tier`	`string`	Offre par défaut pour les nouveaux fils. Si vous redéfinissez explicitement l’offre, Codex ignore ce champ.
`network_proxy`	`table`	Exigences réseau gérées par l’administrateur pour les commandes locales exécutées en bac à sable. Codex 0.166.0 accepte `[network_proxy]` et son alias `[experimental_network]`. Utilisez un seul de ces noms par couche d’exigences. Conservez l’alias dans les politiques publiées jusqu’à ce que tous les clients et validateurs de politiques prennent en charge le nouveau nom. L’activation de ces exigences peut démarrer le proxy réseau des commandes même si `features.network_proxy` est désactivé. Les outils du navigateur vérifient séparément les interdictions réseau gérées et les listes d’autorisation exclusives. Ces exigences ne font pas passer le trafic du navigateur par le proxy et ne contrôlent ni la recherche web, ni les applications, ni les serveurs MCP, ni le trafic des applications natives, ni le trafic propre à d’autres fonctionnalités. Pour les modes d’exécution gérés pris en charge dans Codex Cloud, elles limitent l’accès réseau des commandes en complément des paramètres d’accès à Internet propres à l’environnement Cloud. Une commande dont l’exécution entièrement hors du bac à sable a été approuvée peut contourner le proxy des commandes si la politique le permet. Work Cloud n’hérite pas de ces exigences.
`network_proxy.allow_local_binding`	`boolean`	Autorise un accès plus large aux réseaux locaux ou privés depuis le bac à sable. Pour les connexions qui empruntent le chemin pris en charge via le proxy de Codex Cloud, une valeur false explicite peut empêcher l’accès au proxy amont même si un domaine est autorisé. La valeur par défaut est true uniquement si aucune exigence applicable, aucun profil réseau sélectionné et aucun paramètre de la fonctionnalité de proxy ne fournit de valeur. Une valeur false héritée reste explicite. Un réglage Cloud pris en charge et de priorité supérieure peut remplacer cette valeur sans élargir les autorisations de Global pour Local ni ajouter d’entrées d’autorisation de domaines. Vérifiez que l’exécuteur prend en charge ce réglage. N’appliquez pas cette valeur par défaut de Cloud à Local.
`network_proxy.allow_upstream_proxy`	`boolean`	Autorise le trafic réseau du bac à sable à passer par un proxy amont défini dans l’environnement.
`network_proxy.allowed_domains`	`array<string>`	Règles d’autorisation définies par l’administrateur pour l’accès réseau des commandes exécutées dans le bac à sable lorsque le proxy réseau géré est activé. Elles ne s’appliquent ni à la recherche web, ni aux applications, ni aux serveurs MCP. Ne combinez pas ce paramètre avec `network_proxy.domains`.
`network_proxy.dangerously_allow_all_unix_sockets`	`boolean`	Autorise l’accès à n’importe quel socket Unix, même s’il ne figure pas sur la liste d’autorisation. Utilisez ce paramètre uniquement dans des environnements strictement contrôlés.
`network_proxy.dangerously_allow_non_loopback_proxy`	`boolean`	Autorise les adresses d’écoute hors de l’interface de bouclage pour les exigences `[network_proxy]`. L’activation de ce paramètre peut rendre les services en écoute accessibles au-delà de localhost.
`network_proxy.denied_domains`	`array<string>`	Liste des règles d’interdiction définies par l’administrateur pour l’accès réseau depuis le bac à sable. Ne combinez pas ce paramètre avec `network_proxy.domains`.
`network_proxy.domains`	`map<string, allow \| deny>`	L’administrateur définit dans une table les règles d’accès aux domaines depuis le bac à sable. Vous pouvez indiquer un nom d’hôte exact, `.example.com` pour les sous-domaines uniquement, `.example.com` pour le domaine racine et ses sous-domaines, ou une règle d’autorisation globale ``. Privilégiez les règles ciblées, car `*` ouvre largement l’accès sortant au réseau public. Au sein d’une même politique, une règle définie pour un environnement peut remplacer une règle globale ayant la même clé de domaine. Pour une même clé, la valeur de priorité supérieure l’emporte. Les autres clés héritées sont conservées. Après fusion, toute autre règle `deny` qui correspond à la requête la bloque, même si cette règle utilise un motif générique hérité. Une table vide au niveau de l’environnement n’efface pas les règles globales. Vérifiez que l’exécuteur prend en charge ce paramètre. Ne combinez ce paramètre ni avec `network_proxy.allowed_domains` ni avec `network_proxy.denied_domains`.
`network_proxy.domains.<pattern>`	`allow \| deny`	Autorise ou interdit l’accès réseau depuis le bac à sable aux domaines correspondant au motif. Si plusieurs motifs correspondent, une règle d’interdiction l’emporte.
`network_proxy.enabled`	`boolean`	Active les exigences réseau du bac à sable. Ce paramètre n’accorde pas d’accès réseau aux commandes si le bac à sable actif bloque cet accès.
`network_proxy.http_port`	`integer`	Port d’écoute HTTP sur l’interface de bouclage pour les exigences `[network_proxy]`.
`network_proxy.managed_allowed_domains_only`	`boolean`	Si les exigences réseau sont activées et que ce paramètre vaut true, ni la configuration utilisateur ordinaire ni les approbations par domaine ne peuvent élargir la liste d’autorisation du proxy géré. Si aucune entrée d’autorisation configurée ou héritée ne s’applique, les commandes gérées ordinaires n’ont aucune destination autorisée. Une politique composée uniquement d’interdictions n’autorise pas le reste d’Internet. Certains outils échappent à cette restriction, tout comme les élévations approuvées donnant un accès complet hors du bac à sable.
`network_proxy.review_domains`	`array<string>`	Soumet les requêtes vers les hôtes correspondants à une approbation réseau, même si une règle d’autorisation s’applique. Une interdiction explicite l’emporte. Les requêtes approuvées restent soumises aux vérifications DNS et aux contrôles des adresses privées. La liste est vide par défaut.
`network_proxy.socks_port`	`integer`	Port d’écoute SOCKS5 sur l’interface de bouclage pour les exigences `[network_proxy]`.
`network_proxy.unix_sockets`	`map<string, allow \| deny>`	Liste des sockets Unix autorisés pour l’accès réseau depuis le bac à sable sous macOS. L’administrateur gère cette liste. Les chemins doivent être absolus.
`network_proxy.unix_sockets.<path>`	`allow \| deny`	Sous macOS, `allow` ajoute le chemin absolu d’un socket Unix à la liste d’autorisation et `deny` le laisse hors de cette liste. Une entrée `deny` ne peut pas bloquer un socket si l’option autorisant tous les sockets Unix est activée.
`otel`	`table`	Impose les paramètres OpenTelemetry indiqués. Chaque définition d’exportateur remplace intégralement la définition correspondante. Les attributs des segments de trace et les champs tracestate remplacent uniquement les entrées correspondantes.
`otel.environment`	`string`	Impose l’étiquette d’environnement des données de télémétrie.
`otel.exporter`	`none \| otlp-http \| otlp-grpc`	Impose l’exportateur de journaux, y compris son point de terminaison, ses en-têtes et ses paramètres TLS.
`otel.log_agent_responses`	`boolean`	Détermine si les journaux OTLP incluent le texte des réponses finales de l’agent principal et des sous-agents lancés.
`otel.log_guardian_assessments`	`boolean`	Détermine si les journaux OTLP incluent, pour chaque demande d’approbation dont l’évaluation automatique est terminée, cette évaluation et sa justification.
`otel.log_user_prompt`	`boolean`	Détermine si les journaux exportés incluent le texte des prompts de l’utilisateur.
`otel.metrics_exporter`	`none \| statsig \| otlp-http \| otlp-grpc`	Impose l’exportateur de métriques. L’activation de l’exportateur Statsig dépend du paramètre `analytics.enabled`. Les exportateurs de métriques OTLP configurés explicitement fonctionnent indépendamment de ce paramètre.
`otel.span_attributes`	`map<string,string>`	Impose, attribut par attribut, des valeurs de type chaîne sur les segments de trace exportés. Pour un même attribut, l’exigence de priorité supérieure l’emporte.
`otel.tool_result`	`table`	Impose en bloc les paramètres de journalisation des résultats d’outils. Une table vide impose la limite par défaut en octets.
`otel.tool_result.max_bytes`	`integer (nonnegative)`	Nombre maximal d’octets de texte (encodé en UTF-8) à inclure dans les journaux pour un résultat d’outil avant l’avis de troncature. La valeur par défaut est `2048` lorsque la table gérée est présente.
`otel.trace_exporter`	`none \| otlp-http \| otlp-grpc`	Impose l’exportateur de traces, y compris son point de terminaison, ses en-têtes et ses paramètres TLS.
`otel.tracestate`	`map<string,map<string,string>>`	Impose les valeurs de champs individuels au sein des membres du tracestate W3C. Pour un même champ d’un même membre, l’exigence de priorité supérieure l’emporte.
`permissions`	`table`	Profils d’autorisation définis par l’administrateur. Chaque clé correspond au nom d’un profil. Ces profils utilisent les mêmes champs que ceux de `config.toml`.
`permissions.<name>`	`table`	Profil d’autorisation défini par l’administrateur. Son nom ne peut ni commencer par `:`, ni être le nom réservé `filesystem`, ni reprendre le nom d’un profil d’une configuration chargée. Ce profil utilise les mêmes champs que les profils de `config.toml`. Consultez le guide des autorisations pour connaître le schéma complet d’un profil.
`permissions.filesystem.deny_read`	`array<string>`	Interdictions de lecture imposées par l’administrateur sur le système de fichiers. Les entrées peuvent être des chemins ou des motifs glob. Les utilisateurs ne peuvent pas assouplir ces interdictions dans leur configuration locale.
`plugins`	`table`	Listes d’autorisation des serveurs MCP, avec une liste par identifiant de plugin. Si cette table est présente, Codex désactive tout serveur fourni avec un plugin pour lequel aucune entrée ne correspond à la fois au plugin et au serveur.
`plugins.<plugin>.mcp_servers`	`table`	Liste d’autorisation des serveurs MCP fournis avec un plugin. Pour ces serveurs, spécifiez les identités exactes et les critères de correspondance dans les mêmes formats que pour les exigences de la table `mcp_servers` de premier niveau.
`plugins.<plugin>.mcp_servers.<server>.identity`	`table`	Règle d’identité d’un serveur MCP fourni avec un plugin. Définissez soit `command` (stdio), soit `url` (HTTP en streaming).
`plugins.<plugin>.mcp_servers.<server>.identity.command`	`string \| table`	Pour autoriser un serveur MCP stdio du plugin, indiquez la chaîne de commande exacte ou utilisez une table pour spécifier l’exécutable exact et, dans l’ordre, un critère de correspondance par argument.
`plugins.<plugin>.mcp_servers.<server>.identity.command.args`	`array<table>`	Liste ordonnée de critères de correspondance pour les arguments d’un serveur stdio fourni avec un plugin. La liste des arguments configurés doit avoir la même longueur que celle des critères, et chaque argument doit satisfaire au critère situé à la même position.
`plugins.<plugin>.mcp_servers.<server>.identity.command.args[].expression`	`string`	Expression régulière utilisée par un critère d’argument de type `regex`. Elle doit correspondre à la valeur complète de l’argument.
`plugins.<plugin>.mcp_servers.<server>.identity.command.args[].match`	`exact \| prefix \| regex`	Type de comparaison pour l’argument à cette position.
`plugins.<plugin>.mcp_servers.<server>.identity.command.args[].value`	`string`	Valeur de comparaison pour un critère d’argument de type `exact` ou `prefix`.
`plugins.<plugin>.mcp_servers.<server>.identity.command.executable`	`string`	Exécutable auquel la commande configurée pour le serveur stdio fourni avec le plugin doit correspondre exactement.
`plugins.<plugin>.mcp_servers.<server>.identity.url`	`string \| table`	Pour autoriser un serveur MCP du plugin qui utilise HTTP en streaming, indiquez son URL exacte ou utilisez une table pour définir un critère de correspondance de type `exact`, `prefix` ou `regex` pour l’URL.
`plugins.<plugin>.mcp_servers.<server>.identity.url.expression`	`string`	Expression régulière utilisée par un critère d’URL de type `regex`. Elle doit correspondre à l’URL complète.
`plugins.<plugin>.mcp_servers.<server>.identity.url.match`	`exact \| prefix \| regex`	Type de comparaison pour l’URL du serveur MCP fourni avec le plugin.
`plugins.<plugin>.mcp_servers.<server>.identity.url.value`	`string`	Valeur de comparaison pour un critère d’URL de type `exact` ou `prefix`.
`remote_sandbox_config`	`array<table>`	Exigences relatives au bac à sable propres à chaque hôte. La première entrée dont l’un des motifs `hostname_patterns` correspond au nom d’hôte résolu remplace la valeur de `allowed_sandbox_modes` définie à la racine de cette source d’exigences. Actuellement, les entrées propres à un hôte ne redéfinissent que les modes du bac à sable.
`remote_sandbox_config[].allowed_sandbox_modes`	`array<string>`	Modes de bac à sable autorisés lorsque le nom d’hôte correspond à l’un des motifs de cette entrée.
`remote_sandbox_config[].hostname_patterns`	`array<string>`	Motifs de noms d’hôte insensibles à la casse. `*` représente une suite quelconque de caractères et `?` un seul caractère.
`rules`	`table`	Règles de commande imposées par l’administrateur et fusionnées avec celles des fichiers `.rules`. Les règles définies dans les exigences doivent être restrictives.
`rules.prefix_rules`	`array<table>`	Liste des règles de préfixe imposées. Chaque règle doit inclure `pattern` et `decision`.
`rules.prefix_rules[].decision`	`prompt \| forbidden`	Obligatoire. Les règles définies dans les exigences peuvent uniquement demander une approbation ou interdire la commande. Elles ne peuvent pas l’autoriser.
`rules.prefix_rules[].justification`	`string`	Justification facultative affichée dans les demandes d’approbation ou les messages de rejet. Si vous la renseignez, elle doit contenir du texte.
`rules.prefix_rules[].pattern`	`array<table>`	Préfixe de commande décrit par une suite de tokens. Pour chaque token du motif, définissez soit `token`, soit `any_of`.
`rules.prefix_rules[].pattern[].any_of`	`array<string>`	Liste des tokens dont chacun est accepté à cette position.
`rules.prefix_rules[].pattern[].token`	`string`	Token littéral unique à cette position.
`sqlite_home`	`string (path)`	Imposez le répertoire dans lequel Codex stocke ses données d’état d’exécution au format SQLite.
`unsafe_enforce_sqlite_journal_mode`	`boolean`	Sous Linux, définissez ce paramètre sur `true` pour faire passer les bases de données SQLite existantes sur NFS du mode de journalisation WAL au mode DELETE avant de les ouvrir en écriture. La valeur par défaut est `false`. Le montage NFS doit prendre en charge les verrous POSIX entre hôtes. Sur chaque hôte, arrêtez tous les autres clients SQLite qui utilisent ces bases et attendez que la migration réussisse avant de les redémarrer. Les fichiers de remplacement conservent les bits de mode des fichiers d’origine, mais appartiennent à l’utilisateur qui exécute la migration. La migration ne recopie ni le propriétaire, ni le groupe, ni les ACL étendues des fichiers d’origine.
`windows`	`table`	Exigences relatives au bac à sable natif Windows.
`windows.allow_mxc`	`boolean`	Utilisez `false` pour interdire aussi bien la sélection explicite de MXC que sa sélection automatique via `features.prefer_mxc`. Si vous omettez cette exigence ou la définissez sur `true`, vous autorisez MXC sans l’activer ni l’imposer. En cas de repli, les restrictions sur les anciennes implémentations continuent de s’appliquer.
`windows.allowed_sandbox_implementations`	`array<string>`	Anciennes implémentations du bac à sable natif Windows autorisées (`elevated` et `unelevated`). La liste doit contenir au moins une entrée. Si les deux sont autorisées et qu’aucun mode n’est sélectionné, Codex privilégie `elevated`. Cette liste ne restreint pas le bac à sable `mxc` lorsqu’il est disponible.
`windows.require_mxc`	`boolean`	Sous Windows, utilisez `true` pour que Codex rejette toute configuration où l’implémentation effective du bac à sable est autre que MXC. Sélectionnez MXC séparément. Si Codex ne peut pas l’utiliser, la configuration échoue sans repli sur un ancien bac à sable.

Key

additional_developer_instructions

Type / Values

string

Details

Instructions de développeur gérées, ajoutées dans un message de développeur distinct. Codex rejette les instructions dont la taille estimée dépasse 10 000 tokens, marqueurs de contexte compris.

Key

allow_appshots

Type / Values

boolean

Details

Utilisez false pour désactiver Appshots pour les utilisateurs soumis à la politique. Si vous omettez ce paramètre, les exigences ne restreignent pas Appshots et les conditions habituelles de disponibilité du produit s’appliquent.

Key

allow_browser_and_computer_use

Type / Values

boolean

Details

Utilisez false pour bloquer à la fois la fonctionnalité Navigateur pilotée par l’agent et la fonctionnalité Utilisation de l’ordinateur dans les applications natives. Si vous utilisez true ou omettez ce paramètre, cela n’active aucune des deux fonctionnalités. Les autres vérifications liées aux fonctionnalités, aux politiques et aux approbations continuent de s’appliquer.

Key

allow_login_shell

Type / Values

boolean

Details

Autorisez ou interdisez aux outils shell de lancer un shell de connexion.

Key

allow_managed_hooks_only

Type / Values

boolean

Details

Si ce paramètre vaut true, Codex ignore les hooks de l’utilisateur, du projet, de la session et des plugins, mais autorise les hooks gérés provenant de requirements.toml et des autres couches de configuration gérées.

Key

allow_remote_control

Type / Values

boolean

Details

Utilisez false pour désactiver le contrôle à distance des appareils pour les utilisateurs soumis à la politique. Si vous omettez ce paramètre, les exigences ne restreignent pas le contrôle à distance et les conditions habituelles de disponibilité du produit s’appliquent.

Key

allowed_approval_policies

Type / Values

array<string>

Details

Politiques d’approbation autorisées, par exemple on-request, never et granular. Incluez untrusted pour autoriser la politique plus stricte qui s’applique lorsqu’un projet n’est pas considéré comme fiable. Vous ne pouvez pas sélectionner cette politique directement avec approval_policy.

Key

allowed_approvals_reviewers

Type / Values

array<string>

Details

Valeurs autorisées pour approvals_reviewer, par exemple user et auto_review.

Key

allowed_chatgpt_workspaces

Type / Values

array<string>

Details

Limitez la connexion à ChatGPT, y compris via les jetons d’accès Codex, aux espaces de travail dont les identifiants figurent dans la liste. Une liste vide désactive la connexion à ChatGPT. L’authentification par API reste disponible si elle est autorisée. Définissez ce paramètre dans le fichier local d’exigences système ou via MDM sous macOS. Codex ignore les valeurs gérées dans le cloud.

Key

allowed_login_methods

Type / Values

array<string>

Details

Autorisez chatgpt, api ou les deux. Si vous omettez ce paramètre, il ne restreint pas les méthodes de connexion. Si vous le définissez, 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 MDM sous macOS. Codex ignore les valeurs gérées dans le cloud.

Key

allowed_permission_profiles

Type / Values

table<boolean>

Details

Liste complète des profils d’autorisations admis. Codex autorise les profils définis sur true et refuse ceux qui sont omis ou définis sur false, y compris les profils ajoutés dans les versions futures. Lors de la fusion de plusieurs sources d’exigences, Codex associe les entrées par nom de profil.

Key

allowed_permission_profiles.<name>

Type / Values

boolean

Details

Autorise ou interdit 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). La valeur disabled est toujours autorisée. Si la liste est vide, seule la valeur disabled est autorisée.

Key

application

Type / Values

table

Details

Exigences applicables à l’application de bureau dans le cadre d’une configuration gérée.

Key

application.network

Type / Values

table

Details

Restrictions sur les destinations des requêtes réseau de l’application de bureau. Elles sont distinctes des règles qui régissent l’accès des commandes au réseau et des règles d’origine du navigateur. Ces restrictions ne s’appliquent ni aux modules natifs ni aux processus lancés par l’application.

Key

application.network.domains

Type / Values

table<allow | deny>

Details

Règles de correspondance exacte des noms de domaine pour les requêtes de l’application de bureau. Lorsque la politique est activée, seules les requêtes HTTPS et WSS vers des domaines explicitement autorisés sont permises. L’autorisation d’un domaine ne s’étend pas à ses sous-domaines.

Key

application.network.domains.<domain>

Type / Values

allow | deny

Details

Autorise ou interdit un domaine précis. Utilisez des noms de domaine sans schéma d’URL, port ni caractère générique.

Key

application.network.enabled

Type / Values

boolean

Details

La valeur par défaut est true si la table est présente. Si ce paramètre vaut true, toute requête externe de l’application de bureau doit viser un domaine explicitement autorisé. Une table de domaines vide n’autorise aucune destination externe. Si la politique réseau de l’application est absente ou si ce paramètre vaut false, aucune restriction de destination ne s’applique au titre de cette politique.

Key

application.storage

Type / Values

table

Details

Fixez les emplacements de stockage des nouveaux projets et discussions dans les versions de l’application de bureau qui prennent en charge le stockage géré. Chaque chemin remplace indépendamment la préférence locale correspondante. Les paramètres de stockage ne restreignent pas l’accès au système de fichiers.

Key

application.storage.default_project_parent

Type / Values

string (absolute path)

Details

Répertoire parent des nouveaux projets locaux créés avec l’option Partir de zéro.

Key

application.storage.projectless_workspace_root

Type / Values

string (absolute path)

Details

Répertoire racine des nouvelles discussions créées sans projet.

Key

apps

Type / Values

table

Details

Exigences gérées pour les applications, indexées par identifiant d’application. Elles peuvent désactiver une application ou restreindre les modes d’approbation autorisés pour chacun de ses outils.

Key

apps.<id>.enabled

Type / Values

boolean

Details

Utilisez false pour désactiver une application. La désactivation reste en vigueur 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 imposé pour un outil de l’application.

Key

auto_review

Type / Values

table

Details

Exigences gérées pour la fonctionnalité Révision automatique.

Key

auto_review.ignore_rules

Type / Values

array<string>

Details

Slugs complets des modèles pour lesquels Codex ignore les règles de préfixe allow de la politique d’exécution des commandes. Indiquez le slug exact, avec l’espace de noms du fournisseur s’il en comporte un. Contrairement à required_on_models, ce paramètre n’accepte pas d’alias sans espace de noms. Les règles d’interdiction et les règles réseau restent applicables.

Key

auto_review.required_on_models

Type / Values

array<string>

Details

Slugs des modèles pour lesquels la révision automatique est obligatoire. Chaque slug doit être non vide, sans espace de noms de fournisseur ni caractère d’espacement en début ou en fin de chaîne. Codex combine les listes provenant de plusieurs sources d’exigences.

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

Utilisez 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 de ce type déjà enregistrées sont ignorées mais conservées. Si vous utilisez true ou omettez ce paramètre, aucune approbation n’est créée.

Key

browser_use.allow_history_access

Type / Values

boolean

Details

Utilisez false pour empêcher la fonctionnalité Navigateur de lire l’historique de navigation. Si vous utilisez true ou omettez ce paramètre, les paramètres habituels de l’historique et les vérifications de disponibilité continuent de s’appliquer.

Key

browser_use.allow_webmcp

Type / Values

boolean

Details

Autorisez l’accès aux outils des sites (WebMCP) via la politique de l’espace de travail pour les offres gérées éligibles. Si vous utilisez true ou omettez ce paramètre, cette politique autorise l’accès. Avec false, elle cesse de l’accorder. Les utilisateurs peuvent toujours accéder à ces outils si la fonctionnalité est déployée pour leur compte. Les paramètres du navigateur et les autorisations des sites s’appliquent.

Key

browser_use.default_origin_policy

Type / Values

table

Details

Pour chaque paramètre de la fonctionnalité Navigateur, la valeur de repli s’applique lorsqu’aucune entrée correspondante sous browser_use.origins ne définit ce paramètre. Si une règle correspondant à l’origine définit ce paramètre, sa valeur remplace la valeur de repli pour la source de configuration concernée. Codex compare ensuite le résultat des exigences gérées à celui de la configuration utilisateur et applique le plus restrictif des deux.

Key

browser_use.default_origin_policy.access

Type / Values

allow | deny

Details

Utilisez deny pour bloquer la fonctionnalité Navigateur sur les origines auxquelles la valeur de repli s’applique. Ce blocage interdit aussi les envois et les téléchargements de fichiers, l’accès complet aux fonctions de débogage du navigateur et la révision automatique sur ces origines. allow permet uniquement de poursuivre les vérifications habituelles d’approbation et de conformité aux politiques.

Key

browser_use.default_origin_policy.access_approval_lifetime

Type / Values

turn | thread

Details

Définissez la durée de validité d’une approbation non persistante d’accès à un site. Avec turn, elle expire à la fin du tour en cours. Avec thread, elle reste valable jusqu’à la fin du fil en cours. Le paramètre persistent_approval détermine séparément si l’option Always allow est disponible. La valeur par défaut est thread.

Key

browser_use.default_origin_policy.auto_review

Type / Values

allow | deny

Details

Utilisez deny pour désactiver la révision automatique sur les origines auxquelles la valeur de repli s’applique et demander directement l’approbation de l’utilisateur. Avec allow, la révision automatique reste disponible si les autres paramètres le permettent.

Key

browser_use.default_origin_policy.downloads

Type / Values

allow | deny

Details

Utilisez deny pour bloquer les téléchargements via la fonctionnalité Navigateur sur les origines auxquelles la valeur de repli s’applique. allow permet uniquement de poursuivre les vérifications habituelles d’approbation et de conformité aux politiques.

Key

browser_use.default_origin_policy.full_cdp_access

Type / Values

allow | deny

Details

Utilisez deny pour bloquer l’accès complet au protocole Chrome DevTools (CDP) sur les origines auxquelles la valeur de repli s’applique. allow permet uniquement de poursuivre les vérifications habituelles d’activation explicite et d’approbation.

Key

browser_use.default_origin_policy.persistent_approval

Type / Values

boolean

Details

Utilisez false pour empêcher la fonctionnalité Navigateur d’enregistrer ou d’appliquer une approbation Always allow sur les origines auxquelles la valeur de repli s’applique. Les approbations pour le tour ou le fil en cours peuvent toujours s’appliquer. La valeur true rend l’option Always allow disponible si les autres conditions le permettent, sans créer d’approbation.

Key

browser_use.default_origin_policy.uploads

Type / Values

allow | deny

Details

Utilisez deny pour bloquer les envois de fichiers via la fonctionnalité Navigateur sur les origines auxquelles la valeur de repli s’applique. allow permet uniquement de poursuivre les vérifications habituelles d’approbation et de conformité aux politiques.

Key

browser_use.disable_auto_review

Type / Values

boolean

Details

Utilisez true pour désactiver la révision automatique pour la fonctionnalité Navigateur et demander directement l’approbation de l’utilisateur. Si vous utilisez false ou omettez ce paramètre, la révision automatique reste disponible lorsque les autres paramètres le permettent.

Key

browser_use.extension

Type / Values

table

Details

Paramètres gérés de la fonctionnalité Navigateur dans les extensions Chromium prises en charge.

Key

browser_use.extension.request_headers

Type / Values

array<table>

Details

Ajoutez jusqu’à 16 en-têtes HTTP aux requêtes provenant des onglets pilotés par l’agent dans les extensions Chromium prises en charge. Utilisez une liste vide pour n’envoyer aucun en-tête géré.

Key

browser_use.extension.request_headers[].name

Type / Values

string

Details

Nom de l’en-tête. Les noms réservés, notamment Authorization et Cookie, sont interdits. La seule substitution possible dans les noms et les valeurs est {{session_id}}.

Key

browser_use.extension.request_headers[].value

Type / Values

string

Details

Valeur de l’en-tête à envoyer avec les requêtes correspondantes du navigateur.

Key

browser_use.origins

Type / Values

map<string, table>

Details

Politiques de la fonctionnalité Navigateur propres à chaque origine. Les clés ont la forme <scheme>://<host-pattern>[:<port>], avec http ou https. Utilisez un nom d’hôte exact, *.example.com pour les sous-domaines uniquement ou **.example.com pour le domaine de base et ses sous-domaines. Dans les autres motifs, le caractère générique * peut représenter une suite de caractères contenant des points. Ainsi, region*.example.com correspond aussi à region.api.example.com. Le motif d’hôte * correspond à tous les hôtes du schéma indiqué. La correspondance tient compte du schéma et des ports autres que le port par défaut. La normalisation supprime le port par défaut s’il est indiqué explicitement. Les chemins, les chaînes de requête, les noms d’utilisateur ou mots de passe intégrés et les caractères génériques dans le schéma ou le port sont invalides. En TOML, placez le motif entre guillemets, 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 retient la valeur la plus restrictive pour chaque capacité. deny prime 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 envois et les téléchargements de fichiers, l’accès complet au débogage du navigateur et la révision automatique. allow permet uniquement de poursuivre les vérifications habituelles relatives aux approbations et aux politiques applicables.

Key

browser_use.origins.<pattern>.access_approval_lifetime

Type / Values

turn | thread

Details

Définissez la durée de validité d’une approbation non persistante d’accès à un site pour les origines correspondantes. Avec turn, l’approbation vaut uniquement pour le tour en cours. Avec thread, elle reste valable jusqu’à la fin du fil en cours. Le paramètre persistent_approval détermine séparément si l’option Always allow est disponible.

Key

browser_use.origins.<pattern>.auto_review

Type / Values

allow | deny

Details

Utilisez deny pour demander directement l’approbation de l’utilisateur sans passer par la révision automatique sur les origines correspondantes. Avec allow, la révision automatique reste disponible si 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 effectués par la fonctionnalité Navigateur sur les origines correspondantes. allow permet uniquement de poursuivre les vérifications habituelles relatives aux approbations et aux politiques applicables.

Key

browser_use.origins.<pattern>.full_cdp_access

Type / Values

allow | deny

Details

Utilisez deny pour bloquer l’accès complet au protocole Chrome DevTools (CDP) sur les origines correspondantes. allow permet uniquement de poursuivre les vérifications habituelles d’activation explicite et d’approbation.

Key

browser_use.origins.<pattern>.persistent_approval

Type / Values

boolean

Details

Utilisez false pour empêcher la fonctionnalité Navigateur d’enregistrer ou d’appliquer une approbation Always allow sur les origines correspondantes. Les approbations accordées pour le tour ou le fil en cours peuvent toujours s’appliquer. La valeur true rend l’option Always allow disponible si les autres conditions le permettent, sans accorder d’approbation.

Key

browser_use.origins.<pattern>.uploads

Type / Values

allow | deny

Details

Utilisez deny pour bloquer les envois de fichiers effectués par la fonctionnalité Navigateur sur les origines correspondantes. allow permet uniquement de poursuivre les vérifications habituelles relatives aux approbations et aux politiques applicables.

Key

chatgpt_base_url

Type / Values

string

Details

Imposez l’URL de base du service ChatGPT avant l’authentification et la récupération de la politique depuis le 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 MDM sous macOS. Codex ignore les valeurs gérées dans le cloud.

Key

check_for_update_on_startup

Type / Values

boolean

Details

Imposez ou désactivez la recherche de mises à jour au démarrage de Codex.

Key

cli_auth_credentials_store

Type / Values

file | keyring | auto | ephemeral

Details

Imposez le mode de stockage des identifiants de la CLI avant le chargement de l’authentification. file utilise CODEX_HOME/auth.json. keyring exige 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 la durée du processus en cours. Définissez ce paramètre dans le fichier local d’exigences système ou via MDM sous macOS. Codex ignore les valeurs gérées dans le cloud.

Key

computer_use

Type / Values

table

Details

Exigences gérées pour les actions de l’agent dans les applications de bureau natives. Les règles gérées relatives aux applications et celles de config.toml s’appliquent conjointement. Les deux sources de règles doivent autoriser l’application.

Key

computer_use.allow_locked_computer_use

Type / Values

boolean

Details

Utilisez false pour empêcher les utilisateurs d’activer l’utilisation de l’ordinateur verrouillé sur un appareil macOS géré. Ce paramètre supprime les commandes d’activation sans désactiver la fonctionnalité si elle est déjà activée. Si vous omettez ce paramètre, les conditions habituelles de disponibilité s’appliquent.

Key

computer_use.allow_persistent_approval

Type / Values

boolean

Details

Utilisez false pour supprimer l’option permettant de conserver les approbations d’applications d’une session à l’autre. Les approbations pour la session en cours restent disponibles. Si vous choisissez true ou omettez ce paramètre, aucune application n’est approuvée de ce seul fait.

Key

computer_use.default_app_access

Type / Values

allow | deny

Details

Règle d’accès par défaut pour les applications natives qui ne correspondent à aucune règle propre à la plateforme. deny bloque l’accès. allow permet uniquement de poursuivre la procédure d’approbation et les contrôles de politique habituels. La valeur par défaut du produit est allow.

Key

computer_use.macos

Type / Values

table

Details

Règles de la fonctionnalité Utilisation de l’ordinateur pour les applications macOS.

Key

computer_use.macos.bundle_ids

Type / Values

map<string, allow | deny>

Details

Associez chaque identifiant exact de bundle macOS à allow ou deny. Une règle correspondante remplace computer_use.default_app_access au sein de la même source de politique. Tout refus provenant des exigences gérées ou de la configuration de l’utilisateur bloque l’accès.

Key

computer_use.macos.bundle_ids.<bundle-id>

Type / Values

allow | deny

Details

Utilisez deny pour bloquer l’application dont l’identifiant de bundle correspond exactement à celui indiqué. allow remplace uniquement la valeur par défaut de cette source de politique. Les autres sources de politique et la procédure habituelle d’approbation doivent aussi autoriser l’application.

Key

computer_use.windows

Type / Values

table

Details

Règles de la fonctionnalité Utilisation de l’ordinateur pour les applications Windows distribuées avec ou sans package.

Key

computer_use.windows.aumids

Type / Values

map<string, allow | deny>

Details

Associez l’identifiant Application User Model ID (AUMID) de chaque application signée distribuée en package à allow ou deny. Utilisez l’identifiant exact tel qu’il est enregistré. 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’application distribuée en package dont l’identité correspond exactement à celle indiquée. allow remplace uniquement la valeur par défaut de cette source de politique. Les autres sources de politique et la procédure habituelle d’approbation doivent aussi autoriser l’application.

Key

computer_use.windows.exes

Type / Values

array<table>

Details

Règles pour les exécutables Windows signés distribués sans package. La correspondance se fonde sur l’éditeur vérifié et les informations de version signées de l’exécutable, indépendamment de son chemin ou du nom actuel du fichier. Si plusieurs règles correspondent, une interdiction l’emporte sur toute autorisation. Les exécutables non signés relèvent de 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 correspondant à la règle. deny bloque l’accès. allow remplace uniquement la valeur par défaut de cette source de politique. Les autres sources de politique et la procédure habituelle d’approbation doivent aussi autoriser l’application.

Key

computer_use.windows.exes[].binary_name

Type / Values

string

Details

Valeur facultative de OriginalFilename dans les informations de version signées de l’exécutable. La comparaison est insensible à la casse. Si une règle correspondant à l’éditeur et au produit exige cette valeur et 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

Indiquez la valeur exacte de ProductName figurant dans les informations de version signées de l’exécutable. Cette valeur est obligatoire.

Key

computer_use.windows.exes[].publisher_name

Type / Values

string

Details

Indiquez le nom exact de l’éditeur tel qu’il figure dans le certificat de signature de confiance de l’exécutable, au format de nom distinctif X.500 de Windows. Cette valeur est obligatoire.

Key

config_server

Type / Values

table

Details

Rattachez Codex à un serveur de configuration. Définissez ce paramètre dans les exigences locales contrôlées par l’administrateur.

Key

config_server

Type / Values

table

Details

Rattachez Codex à un serveur de configuration à l’aide des exigences gérées localement. Codex récupère son ensemble de politiques auprès de ce serveur. Une politique gérée dans le cloud ne peut pas configurer son propre serveur.

Key

config_server.base_url

Type / Values

string (HTTPS URL)

Details

URL de base du serveur de configuration enregistré par l’administrateur. Codex ajoute /codex/config/bundle à la fin de cette URL.

Key

config_server.base_url

Type / Values

string

Details

URL de base HTTPS obligatoire. Codex y ajoute /codex/config/bundle. Omettez les identifiants, les paramètres de requête et les fragments de l’URL de base.

Key

config_server.oauth

Type / Values

table

Details

Paramètres facultatifs de connexion au compte d’entreprise. Omettez cette table pour récupérer le paquet de configuration sans identifiants.

Key

config_server.oauth

Type / Values

table

Details

Paramètres OAuth pour la connexion au serveur de configuration. Indiquez authorization_url, token_url et un client_id non vide. Les champs facultatifs sont device_authorization_url, resource, scopes (liste vide par défaut) et redirect_port (valeur différente de zéro). Toutes les URL des points de terminaison doivent utiliser HTTPS.

Key

config_server.oauth.authorization_url

Type / Values

string (HTTPS URL)

Details

Point de terminaison d’autorisation pour la connexion au compte d’entreprise dans le navigateur. Obligatoire si OAuth est configuré.

Key

config_server.oauth.client_id

Type / Values

string

Details

Identifiant client OAuth public enregistré pour Codex. Obligatoire si OAuth est configuré.

Key

config_server.oauth.redirect_port

Type / Values

number

Details

Port facultatif pour le rappel du navigateur sur 127.0.0.1. Par défaut, Codex choisit un port disponible.

Key

config_server.oauth.resource

Type / Values

string

Details

Identifiant facultatif de la ressource OAuth à fournir si le fournisseur d’identité l’exige.

Key

config_server.oauth.scopes

Type / Values

array<string>

Details

Autorisations OAuth facultatives à demander au fournisseur d’identité.

Key

config_server.oauth.token_url

Type / Values

string (HTTPS URL)

Details

Point de terminaison utilisé pour obtenir les jetons lors de la connexion au compte d’entreprise et pour les renouveler. Obligatoire si OAuth est configuré.

Key

default_permissions

Type / Values

string

Details

Profil d’autorisations par défaut défini par la configuration gérée. Il doit être autorisé par allowed_permission_profiles. Définissez-le explicitement pour obtenir un comportement prévisible. Si vous omettez ce paramètre, Codex ne choisit :workspace par défaut que si :workspace et :read-only sont tous deux explicitement autorisés.

Key

enforce_residency

Type / Values

string

Details

Impose une région de résidence des données prise en charge pour le trafic des services Codex. La valeur actuellement acceptée est us.

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. Cette table accepte aussi les clés d’exigences documentées propres à l’application.

Key

features.<name>

Type / Values

boolean

Details

Imposez l’état activé ou désactivé d’une fonctionnalité documentée de l’environnement d’exécution ou de l’application.

Key

features.api_key_cyber_access_programs

Type / Values

boolean

Details

En cas d’authentification par clé API, autorisez Codex à indiquer dans ses requêtes au fournisseur OpenAI intégré le programme d’accès aux fonctionnalités de cybersécurité qui a été explicitement sélectionné. Le compte et le modèle doivent déjà avoir accès à ce programme.

Key

features.apps

Type / Values

boolean

Details

Imposez l’activation ou la désactivation de l’intégration Applications pour les utilisateurs soumis à la politique.

Key

features.browser_annotation_api

Type / Values

boolean

Details

Utilisez false pour empêcher les sites web de personnaliser les annotations dans le navigateur intégré. Les utilisateurs peuvent toujours annoter les pages eux-mêmes. Utilisez true pour autoriser ces personnalisations lorsque l’application et le compte les prennent en charge.

Key

features.browser_use

Type / Values

boolean

Details

Utilisez false dans requirements.toml pour désactiver la fonctionnalité Navigateur pilotée par l’agent.

Key

features.browser_use_external

Type / Values

boolean

Details

Utilisez false dans requirements.toml pour empêcher Codex de piloter les navigateurs pris en charge via l’extension de navigateur ChatGPT, y compris dans les onglets existants et les sessions déjà authentifiées.

Key

features.browser_use_full_cdp_access

Type / Values

boolean

Details

Utilisez false dans requirements.toml pour désactiver l’accès complet au protocole Chrome DevTools dans l’environnement d’exécution local, y compris le mode développeur du navigateur, et empêcher l’application de bureau ChatGPT d’activer le paramètre correspondant. Si vous omettez ce paramètre, les conditions habituelles de disponibilité du produit s’appliquent.

Key

features.computer_use

Type / Values

boolean

Details

Utilisez false dans requirements.toml pour désactiver les fonctionnalités « Utilisation de l’ordinateur » et « Enregistrement et relecture », ainsi que les procédures d’installation ou d’activation associées.

Key

features.fast_mode

Type / Values

boolean

Details

Autorisez ou bloquez le mode Rapide pour les utilisateurs soumis à la politique. Les anciennes versions du serveur d’application utilisent aussi ce paramètre pour contrôler l’accès au mode ultrarapide.

Key

features.guardian_approval

Type / Values

boolean

Details

Autorisez ou bloquez l’accès à l’approbation par Guardian pour les utilisateurs soumis à la politique.

Key

features.in_app_browser

Type / Values

boolean

Details

Utilisez 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_chat

Type / Values

boolean

Details

Utilisez false pour masquer, dans l’application de bureau ChatGPT, les écrans de conversation de ChatGPT et de ChatGPT Work ainsi que les éléments d’interface associés aux automatisations dans le cloud. Ce paramètre ne bloque pas ChatGPT Voice et n’arrête pas les tâches existantes dans le cloud. Avec la valeur true, les vérifications liées au compte, aux autorisations de l’espace de travail et au déploiement restent en vigueur.

Key

features.in_app_dictation

Type / Values

boolean

Details

Utilisez false pour désactiver la dictée intégrée à l’application de bureau ChatGPT. Avec la valeur true, les autres vérifications de disponibilité restent en vigueur.

Key

features.in_app_local_automation

Type / Values

boolean

Details

Utilisez false pour désactiver les tâches planifiées locales dans l’application de bureau ChatGPT. Avec la valeur true, les autres vérifications de disponibilité restent en vigueur.

Key

features.in_app_updates

Type / Values

boolean

Details

Utilisez false dans requirements.toml pour désactiver les mises à jour depuis l’application. Les mises à jour restent activées par défaut si vous omettez cette exigence.

Key

features.in_app_voice

Type / Values

boolean

Details

Utilisez false pour désactiver les échanges vocaux en temps réel avec Codex dans l’application de bureau ChatGPT. Utilisez features.in_app_dictation pour gérer la dictée séparément.

Key

features.memories

Type / Values

boolean

Details

Autorisez ou bloquez l’accès aux Mémoires pour les utilisateurs soumis à la politique.

Key

features.multi_agent

Type / Values

boolean

Details

Autorisez ou bloquez l’accès aux fonctionnalités multi-agents pour les utilisateurs soumis à la politique.

Key

features.plugin_sharing

Type / Values

boolean

Details

Utilisez 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

Autorisez ou bloquez l’accès aux plugins pour les utilisateurs soumis à la politique.

Key

features.realtime_conversation

Type / Values

boolean

Details

Utilisez false pour désactiver la commande expérimentale /voice dans la CLI Codex. Ne vous fiez pas à ce paramètre pour bloquer ChatGPT Voice dans l’application de bureau ChatGPT ou dans les sessions vocales de l’App Server. La valeur true ne permet pas de contourner les vérifications liées au client ou au déploiement.

Key

features.remote_plugin

Type / Values

boolean

Details

Autorisez ou bloquez l’accès au catalogue distant de plugins pour les utilisateurs soumis à la politique.

Key

features.standalone_web_search

Type / Values

boolean

Details

Paramètre expérimental. Utilisez true pour conserver la configuration native de recherche web de l’application de bureau ChatGPT lorsque la recherche hébergée serait autrement disponible via MCP.

Key

features.ultrafast_mode

Type / Values

boolean

Details

Autorisez ou bloquez le mode ultrarapide pour les utilisateurs soumis à la politique. Sur les serveurs d’application qui prennent en charge des réglages de vitesse indépendants, ce paramètre s’applique même si le mode Rapide est désactivé. La disponibilité du mode ultrarapide dépend du modèle et du compte.

Key

features.workspace_dependencies

Type / Values

boolean

Details

Autorisez ou bloquez l’accès à l’environnement d’exécution fourni pour les dépendances de l’espace de travail pour les utilisateurs soumis à la politique.

Key

feedback

Type / Values

table

Details

Paramètres gérés pour l’envoi de commentaires.

Key

feedback.enabled

Type / Values

boolean

Details

Autorisez ou interdisez aux utilisateurs d’envoyer des commentaires depuis tous les clients Codex.

Key

guardian_policy_config

Type / Values

string

Details

Texte Markdown géré qui remplace la politique par défaut de la fonctionnalité Révision automatique. Il prévaut sur la valeur locale de [auto_review].policy. Codex ignore les valeurs vides ou composées uniquement de caractères d’espacement.

Key

hooks

Type / Values

table

Details

Hooks gérés que l’administrateur impose pour les événements du cycle de vie. Ils nécessitent un répertoire de hooks gérés et utilisent le même schéma d’événements que les hooks définis directement sous [hooks] 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 PreModelRequest, PostModelRequest, PreToolUse, PermissionRequest, PostToolUse, PreCompact, PostCompact, SessionStart, SessionEnd, SubagentStart, SubagentStop, UserPromptSubmit ou Stop.

Key

hooks.<Event>[].hooks

Type / Values

array<table>

Details

Key

hooks.<Event>[].hooks[].additionalContextLimit

Type / Values

integer

Details

Seuil approximatif, exprimé en tokens pour chaque gestionnaire, au-delà duquel Codex enregistre additionalContext sur disque et présente un aperçu plus court au modèle. La valeur par défaut est 2500. Avec 0, le modèle reçoit directement tout le contexte. Consultez Sorties volumineuses des hooks.

Key

hooks.<Event>[].hooks[].async

Type / Values

boolean

Details

Exécute un hook de commande en arrière-plan sans retarder l’opération qui le déclenche. La valeur par défaut est false. Les hooks de l’événement SessionEnd s’exécutent toujours de façon synchrone. Consultez Exécuter des hooks en arrière-plan.

Key

hooks.<Event>[].hooks[].commandWindows

Type / Values

string

Details

Commande de remplacement propre à Windows pour les hooks de commande. Codex accepte également l’alias TOML command_windows.

Key

hooks.managed_dir

Type / Values

string (absolute path)

Details

Répertoire contenant les scripts de hooks gérés sous macOS et Linux. Codex vérifie que le chemin est absolu et que le répertoire 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 sous Windows. Codex vérifie que le chemin est absolu et que le répertoire existe avant de charger les hooks gérés.

Key

in_app_browser

Type / Values

table

Details

Exigences applicables 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

Utilisez false pour empêcher les utilisateurs d’importer dans le navigateur intégré les paramètres ou les données de navigation d’un navigateur externe. Si vous utilisez true ou omettez ce paramètre, l’importation reste disponible lorsque les autres vérifications du produit le permettent. Ce paramètre est réservé à la configuration gérée. Vous ne pouvez pas le redéfinir dans config.toml.

Key

log_dir

Type / Values

string (path)

Details

Imposez le répertoire dans lequel Codex écrit ses fichiers journaux locaux.

Key

marketplaces

Type / Values

table

Details

Exigences de l’administrateur pour les sources des marketplaces de plugins. Les règles s’appliquent 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. L’administrateur choisit ces noms. Lors de la fusion des couches d’exigences, les règles de noms distincts se cumulent. Pour les règles de même nom, l’ordre de priorité habituel des couches s’applique à chaque champ.

Key

marketplaces.allowed_sources.<name>

Type / Values

table

Details

Règle autorisant une source. Après la fusion des exigences, la valeur finale de source détermine quels autres champs de la même table Codex interprète.

Key

marketplaces.allowed_sources.<name>.host_pattern

Type / Values

string

Details

Expression régulière obligatoire lorsque source = "host_pattern". Codex extrait le nom d’hôte d’une source Git au format HTTPS, SSH ou de type SCP, le convertit en minuscules et le compare à l’expression. Utilisez ^ et $ pour exiger que l’expression corresponde au nom d’hôte entier.

Key

marketplaces.allowed_sources.<name>.path

Type / Values

string (absolute path)

Details

Répertoire local de la marketplace, obligatoire 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 vous l’omettez, 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 la source de marketplace. Utilisez git pour un seul dépôt, host_pattern pour les hôtes Git dont le nom correspond à une expression régulière ou local pour un seul répertoire.

Key

marketplaces.allowed_sources.<name>.url

Type / Values

string

Details

URL du dépôt Git, obligatoire lorsque source = "git". Codex normalise l’URL configurée et l’URL autorisée, puis exige qu’elles désignent exactement le même dépôt.

Key

marketplaces.restrict_to_allowed_sources

Type / Values

boolean

Details

Si ce paramètre vaut true, les sources de marketplace configurées doivent correspondre à une règle de 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 aussi correspondre à une règle de la liste d’autorisation. Les plugins fournis avec l’espace de travail et ceux qui y sont installés à distance sont gérés séparément de cette politique relative aux sources Git sélectionnées.

Key

mcp_servers

Type / Values

table

Details

Liste des serveurs MCP dont l’activation est autorisée. Le nom du serveur (<id>) et son identité doivent tous deux correspondre à une même entrée de la liste pour que le serveur puisse être activé. Codex désactive tout serveur MCP configuré qui ne figure pas dans la liste ou dont l’identité ne correspond pas à celle de l’entrée.

Key

mcp_servers.<id>.identity

Type / Values

table

Details

Règle d’identité d’un serveur MCP. Définissez soit command (stdio), soit url (HTTP en streaming).

Key

mcp_servers.<id>.identity.command

Type / Values

string | table

Details

Pour autoriser un serveur MCP stdio, indiquez la chaîne de commande exacte ou utilisez une table de critères pour exiger une correspondance exacte de l’exécutable et vérifier chaque argument à sa position. Si vous indiquez une chaîne, Codex ne vérifie ni les arguments, ni cwd, ni env, ni env_vars.

Key

mcp_servers.<id>.identity.command.args

Type / Values

array<table>

Details

Liste ordonnée de critères de correspondance pour les arguments d’un serveur stdio. La liste d’arguments configurée doit avoir la même longueur que la liste de critères. Chaque argument doit satisfaire au critère qui occupe la même position. Les critères de commande ne vérifient 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 d’argument de type regex. Elle doit être valide et correspondre à la valeur complète de l’argument.

Key

mcp_servers.<id>.identity.command.args[].match

Type / Values

exact | prefix | regex

Details

Type de comparaison pour l’argument à cette position.

Key

mcp_servers.<id>.identity.command.args[].value

Type / Values

string

Details

Valeur de comparaison pour un critère d’argument de type exact ou prefix.

Key

mcp_servers.<id>.identity.command.executable

Type / Values

string

Details

Exécutable auquel la valeur de command configurée pour le serveur stdio doit correspondre exactement.

Key

mcp_servers.<id>.identity.url

Type / Values

string | table

Details

Pour autoriser un serveur MCP utilisant le transport HTTP en streaming, indiquez l’URL exacte sous forme de chaîne ou utilisez une table qui définit un critère de correspondance 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 d’URL de type regex. Elle doit être valide et correspondre à l’URL complète.

Key

mcp_servers.<id>.identity.url.match

Type / Values

exact | prefix | regex

Details

Type de comparaison pour l’URL configurée du serveur MCP.

Key

mcp_servers.<id>.identity.url.value

Type / Values

string

Details

Valeur de comparaison pour un critère d’URL de type exact ou prefix.

Key

model_catalog_json

Type / Values

string (path)

Details

Imposez le catalogue de modèles au format JSON que Codex utilise au démarrage.

Key

model_provider

Type / Values

string

Details

Impose l’identifiant du fournisseur de modèles. Cette valeur prévaut sur celles de la configuration locale et de la configuration de session.

Key

model_providers

Type / Values

map<string, table>

Details

Définitions gérées des fournisseurs de modèles. Chaque entrée remplace intégralement la définition du fournisseur configuré sous le même identifiant. Codex ne fusionne pas les champs de cette entrée avec ceux de la définition de l’utilisateur. Les fournisseurs portant d’autres identifiants restent disponibles.

Key

model_providers.<id>

Type / Values

table

Details

Définition complète d’un fournisseur géré. Elle utilise les mêmes champs de fournisseur que config.toml, notamment name, base_url et les paramètres d’authentification et de transport.

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 qui s’appliquent au démarrage d’un nouveau fil local. Elles ont priorité sur les valeurs par défaut de l’utilisateur et du projet, mais vous pouvez les remplacer explicitement.

Key

models.new_thread.model

Type / Values

string

Details

Modèle par défaut pour les nouveaux fils. Si vous redéfinissez explicitement le modèle ou l’effort de raisonnement, Codex ignore les deux champs.

Key

models.new_thread.model_reasoning_effort

Type / Values

string

Details

Effort de raisonnement par défaut pour les nouveaux fils. Si vous redéfinissez explicitement le modèle ou l’effort de raisonnement, Codex ignore les deux champs.

Key

models.new_thread.service_tier

Type / Values

string

Details

Offre par défaut pour les nouveaux fils. Si vous redéfinissez explicitement l’offre, Codex ignore ce champ.

Key

network_proxy

Type / Values

table

Details

Exigences réseau gérées par l’administrateur pour les commandes locales exécutées en bac à sable. Codex 0.166.0 accepte [network_proxy] et son alias [experimental_network]. Utilisez un seul de ces noms par couche d’exigences. Conservez l’alias dans les politiques publiées jusqu’à ce que tous les clients et validateurs de politiques prennent en charge le nouveau nom. L’activation de ces exigences peut démarrer le proxy réseau des commandes même si features.network_proxy est désactivé. Les outils du navigateur vérifient séparément les interdictions réseau gérées et les listes d’autorisation exclusives. Ces exigences ne font pas passer le trafic du navigateur par le proxy et ne contrôlent ni la recherche web, ni les applications, ni les serveurs MCP, ni le trafic des applications natives, ni le trafic propre à d’autres fonctionnalités. Pour les modes d’exécution gérés pris en charge dans Codex Cloud, elles limitent l’accès réseau des commandes en complément des paramètres d’accès à Internet propres à l’environnement Cloud. Une commande dont l’exécution entièrement hors du bac à sable a été approuvée peut contourner le proxy des commandes si la politique le permet. Work Cloud n’hérite pas de ces exigences.

Key

network_proxy.allow_local_binding

Type / Values

boolean

Details

Autorise un accès plus large aux réseaux locaux ou privés depuis le bac à sable. Pour les connexions qui empruntent le chemin pris en charge via le proxy de Codex Cloud, une valeur false explicite peut empêcher l’accès au proxy amont même si un domaine est autorisé. La valeur par défaut est true uniquement si aucune exigence applicable, aucun profil réseau sélectionné et aucun paramètre de la fonctionnalité de proxy ne fournit de valeur. Une valeur false héritée reste explicite. Un réglage Cloud pris en charge et de priorité supérieure peut remplacer cette valeur sans élargir les autorisations de Global pour Local ni ajouter d’entrées d’autorisation de domaines. Vérifiez que l’exécuteur prend en charge ce réglage. N’appliquez pas cette valeur par défaut de Cloud à Local.

Key

network_proxy.allow_upstream_proxy

Type / Values

boolean

Details

Autorise le trafic réseau du bac à sable à passer par un proxy amont défini dans l’environnement.

Key

network_proxy.allowed_domains

Type / Values

array<string>

Details

Règles d’autorisation définies par l’administrateur pour l’accès réseau des commandes exécutées dans le bac à sable lorsque le proxy réseau géré est activé. Elles ne s’appliquent ni à la recherche web, ni aux applications, ni aux serveurs MCP. Ne combinez pas ce paramètre avec network_proxy.domains.

Key

network_proxy.dangerously_allow_all_unix_sockets

Type / Values

boolean

Details

Autorise l’accès à n’importe quel socket Unix, même s’il ne figure pas sur la liste d’autorisation. Utilisez ce paramètre uniquement dans des environnements strictement contrôlés.

Key

network_proxy.dangerously_allow_non_loopback_proxy

Type / Values

boolean

Details

Autorise les adresses d’écoute hors de l’interface de bouclage pour les exigences [network_proxy]. L’activation de ce paramètre peut rendre les services en écoute accessibles au-delà de localhost.

Key

network_proxy.denied_domains

Type / Values

array<string>

Details

Liste des règles d’interdiction définies par l’administrateur pour l’accès réseau depuis le bac à sable. Ne combinez pas ce paramètre avec network_proxy.domains.

Key

network_proxy.domains

Type / Values

map<string, allow | deny>

Details

L’administrateur définit dans une table les règles d’accès aux domaines depuis le bac à sable. Vous pouvez indiquer un nom d’hôte exact, *.example.com pour les sous-domaines uniquement, **.example.com pour le domaine racine et ses sous-domaines, ou une règle d’autorisation globale *. Privilégiez les règles ciblées, car * ouvre largement l’accès sortant au réseau public. Au sein d’une même politique, une règle définie pour un environnement peut remplacer une règle globale ayant la même clé de domaine. Pour une même clé, la valeur de priorité supérieure l’emporte. Les autres clés héritées sont conservées. Après fusion, toute autre règle deny qui correspond à la requête la bloque, même si cette règle utilise un motif générique hérité. Une table vide au niveau de l’environnement n’efface pas les règles globales. Vérifiez que l’exécuteur prend en charge ce paramètre. Ne combinez ce paramètre ni avec network_proxy.allowed_domains ni avec network_proxy.denied_domains.

Key

network_proxy.domains.<pattern>

Type / Values

allow | deny

Details

Autorise ou interdit l’accès réseau depuis le bac à sable aux domaines correspondant au motif. Si plusieurs motifs correspondent, une règle d’interdiction l’emporte.

Key

network_proxy.enabled

Type / Values

boolean

Details

Active les exigences réseau du bac à sable. Ce paramètre n’accorde pas d’accès réseau aux commandes si le bac à sable actif bloque cet accès.

Key

network_proxy.http_port

Type / Values

integer

Details

Port d’écoute HTTP sur l’interface de bouclage pour les exigences [network_proxy].

Key

network_proxy.managed_allowed_domains_only

Type / Values

boolean

Details

Si les exigences réseau sont activées et que ce paramètre vaut true, ni la configuration utilisateur ordinaire ni les approbations par domaine ne peuvent élargir la liste d’autorisation du proxy géré. Si aucune entrée d’autorisation configurée ou héritée ne s’applique, les commandes gérées ordinaires n’ont aucune destination autorisée. Une politique composée uniquement d’interdictions n’autorise pas le reste d’Internet. Certains outils échappent à cette restriction, tout comme les élévations approuvées donnant un accès complet hors du bac à sable.

Key

network_proxy.review_domains

Type / Values

array<string>

Details

Soumet les requêtes vers les hôtes correspondants à une approbation réseau, même si une règle d’autorisation s’applique. Une interdiction explicite l’emporte. Les requêtes approuvées restent soumises aux vérifications DNS et aux contrôles des adresses privées. La liste est vide par défaut.

Key

network_proxy.socks_port

Type / Values

integer

Details

Port d’écoute SOCKS5 sur l’interface de bouclage pour les exigences [network_proxy].

Key

network_proxy.unix_sockets

Type / Values

map<string, allow | deny>

Details

Liste des sockets Unix autorisés pour l’accès réseau depuis le bac à sable sous macOS. L’administrateur gère cette liste. Les chemins doivent être absolus.

Key

network_proxy.unix_sockets.<path>

Type / Values

allow | deny

Details

Sous macOS, allow ajoute le chemin absolu d’un socket Unix à la liste d’autorisation et deny le laisse hors de cette liste. Une entrée deny ne peut pas bloquer un socket si l’option autorisant tous les sockets Unix est activée.

Key

otel

Type / Values

table

Details

Impose les paramètres OpenTelemetry indiqués. Chaque définition d’exportateur remplace intégralement la définition correspondante. Les attributs des segments de trace et les champs tracestate remplacent uniquement les entrées correspondantes.

Key

otel.environment

Type / Values

string

Details

Impose l’étiquette d’environnement des données de télémétrie.

Key

otel.exporter

Type / Values

none | otlp-http | otlp-grpc

Details

Impose l’exportateur de journaux, y compris son point de terminaison, ses en-têtes et ses paramètres TLS.

Key

otel.log_agent_responses

Type / Values

boolean

Details

Détermine si les journaux OTLP incluent le texte des réponses finales de l’agent principal et des sous-agents lancés.

Key

otel.log_guardian_assessments

Type / Values

boolean

Details

Détermine si les journaux OTLP incluent, pour chaque demande d’approbation dont l’évaluation automatique est terminée, cette évaluation et sa justification.

Key

otel.log_user_prompt

Type / Values

boolean

Details

Détermine si les journaux exportés incluent le texte des prompts de l’utilisateur.

Key

otel.metrics_exporter

Type / Values

none | statsig | otlp-http | otlp-grpc

Details

Impose l’exportateur de métriques. L’activation de l’exportateur Statsig dépend du paramètre analytics.enabled. Les exportateurs de métriques OTLP configurés explicitement fonctionnent indépendamment de ce paramètre.

Key

otel.span_attributes

Type / Values

map<string,string>

Details

Impose, attribut par attribut, des valeurs de type chaîne sur les segments de trace exportés. Pour un même attribut, l’exigence de priorité supérieure l’emporte.

Key

otel.tool_result

Type / Values

table

Details

Impose en bloc les paramètres de journalisation des résultats d’outils. Une table vide impose la limite par défaut en octets.

Key

otel.tool_result.max_bytes

Type / Values

integer (nonnegative)

Details

Nombre maximal d’octets de texte (encodé en UTF-8) à inclure dans les journaux pour un résultat d’outil avant l’avis de troncature. La valeur par défaut est 2048 lorsque la table gérée est présente.

Key

otel.trace_exporter

Type / Values

none | otlp-http | otlp-grpc

Details

Impose l’exportateur de traces, y compris son point de terminaison, ses en-têtes et ses paramètres TLS.

Key

otel.tracestate

Type / Values

map<string,map<string,string>>

Details

Impose les valeurs de champs individuels au sein des membres du tracestate W3C. Pour un même champ d’un même membre, l’exigence de priorité supérieure l’emporte.

Key

permissions

Type / Values

table

Details

Profils d’autorisation définis par l’administrateur. Chaque clé correspond au nom d’un profil. Ces profils utilisent les mêmes champs que ceux de config.toml.

Key

permissions.<name>

Type / Values

table

Details

Profil d’autorisation défini par l’administrateur. Son nom ne peut ni commencer par :, ni être le nom réservé filesystem, ni reprendre le nom d’un profil d’une configuration chargée. Ce profil utilise les mêmes champs que les profils de config.toml. Consultez le guide des autorisations pour connaître le schéma complet d’un profil.

Key

permissions.filesystem.deny_read

Type / Values

array<string>

Details

Interdictions de lecture imposées par l’administrateur sur le système de fichiers. Les entrées peuvent être des chemins ou des motifs glob. Les utilisateurs ne peuvent pas assouplir ces interdictions dans leur configuration locale.

Key

plugins

Type / Values

table

Details

Listes d’autorisation des serveurs MCP, avec une liste par identifiant de plugin. Si cette table est présente, Codex désactive tout serveur fourni avec un plugin pour lequel 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. Pour ces serveurs, spécifiez les identités exactes et les critères de correspondance dans les mêmes formats que pour les exigences de la table mcp_servers de premier niveau.

Key

plugins.<plugin>.mcp_servers.<server>.identity

Type / Values

table

Details

Règle d’identité d’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

Pour autoriser un serveur MCP stdio du plugin, indiquez la chaîne de commande exacte ou utilisez une table pour spécifier l’exécutable exact et, dans l’ordre, un critère de correspondance par argument.

Key

plugins.<plugin>.mcp_servers.<server>.identity.command.args

Type / Values

array<table>

Details

Liste ordonnée de critères de correspondance pour les arguments d’un serveur stdio fourni avec un plugin. La liste des arguments configurés doit avoir la même longueur que celle des critères, et chaque argument doit satisfaire au critère situé à la même 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 d’argument de type regex. Elle 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

Type de comparaison pour l’argument à cette position.

Key

plugins.<plugin>.mcp_servers.<server>.identity.command.args[].value

Type / Values

string

Details

Valeur de comparaison pour un critère d’argument de type 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

Pour autoriser un serveur MCP du plugin qui utilise HTTP en streaming, indiquez son URL exacte ou utilisez une table pour définir un critère de correspondance de type exact, prefix ou regex pour l’URL.

Key

plugins.<plugin>.mcp_servers.<server>.identity.url.expression

Type / Values

string

Details

Expression régulière utilisée par un critère d’URL de type regex. Elle doit correspondre à l’URL complète.

Key

plugins.<plugin>.mcp_servers.<server>.identity.url.match

Type / Values

exact | prefix | regex

Details

Type de comparaison pour l’URL du serveur MCP fourni avec le plugin.

Key

plugins.<plugin>.mcp_servers.<server>.identity.url.value

Type / Values

string

Details

Valeur de comparaison pour un critère d’URL de type exact ou prefix.

Key

remote_sandbox_config

Type / Values

array<table>

Details

Exigences relatives au bac à sable propres à chaque hôte. La première entrée dont l’un des motifs hostname_patterns correspond au nom d’hôte résolu remplace la valeur de allowed_sandbox_modes définie à la racine de cette source d’exigences. Actuellement, les entrées propres à un hôte ne redéfinissent que les modes du bac à sable.

Key

remote_sandbox_config[].allowed_sandbox_modes

Type / Values

array<string>

Details

Modes de bac à sable autorisés lorsque le nom d’hôte correspond à l’un des motifs de cette entrée.

Key

remote_sandbox_config[].hostname_patterns

Type / Values

array<string>

Details

Motifs de noms d’hôte insensibles à la casse. * représente une suite quelconque de caractères et ? un seul caractère.

Key

rules

Type / Values

table

Details

Règles de commande imposées par l’administrateur et fusionnées avec celles des 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 la commande. Elles ne peuvent pas l’autoriser.

Key

rules.prefix_rules[].justification

Type / Values

string

Details

Justification facultative affichée dans les demandes d’approbation ou les messages de rejet. Si vous la renseignez, elle doit contenir du texte.

Key

rules.prefix_rules[].pattern

Type / Values

array<table>

Details

Préfixe de commande décrit par une suite de tokens. Pour chaque token du motif, définissez soit token, soit any_of.

Key

rules.prefix_rules[].pattern[].any_of

Type / Values

array<string>

Details

Liste des tokens dont chacun est accepté à cette position.

Key

rules.prefix_rules[].pattern[].token

Type / Values

string

Details

Token littéral unique à cette position.

Key

sqlite_home

Type / Values

string (path)

Details

Imposez le répertoire dans lequel Codex stocke ses données d’état d’exécution au format SQLite.

Key

unsafe_enforce_sqlite_journal_mode

Type / Values

boolean

Details

Sous Linux, définissez ce paramètre sur true pour faire passer les bases de données SQLite existantes sur NFS du mode de journalisation WAL au mode DELETE avant de les ouvrir en écriture. La valeur par défaut est false. Le montage NFS doit prendre en charge les verrous POSIX entre hôtes. Sur chaque hôte, arrêtez tous les autres clients SQLite qui utilisent ces bases et attendez que la migration réussisse avant de les redémarrer. Les fichiers de remplacement conservent les bits de mode des fichiers d’origine, mais appartiennent à l’utilisateur qui exécute la migration. La migration ne recopie ni le propriétaire, ni le groupe, ni les ACL étendues des fichiers d’origine.

Key

windows

Type / Values

table

Details

Exigences relatives au bac à sable natif Windows.

Key

windows.allow_mxc

Type / Values

boolean

Details

Utilisez false pour interdire aussi bien la sélection explicite de MXC que sa sélection automatique via features.prefer_mxc. Si vous omettez cette exigence ou la définissez sur true, vous autorisez MXC sans l’activer ni l’imposer. En cas de repli, les restrictions sur les anciennes implémentations continuent de s’appliquer.

Key

windows.allowed_sandbox_implementations

Type / Values

array<string>

Details

Anciennes implémentations du bac à sable natif Windows autorisées (elevated et unelevated). La liste doit contenir au moins une entrée. Si les deux sont autorisées et qu’aucun mode n’est sélectionné, Codex privilégie elevated. Cette liste ne restreint pas le bac à sable mxc lorsqu’il est disponible.

Key

windows.require_mxc

Type / Values

boolean

Details

Sous Windows, utilisez true pour que Codex rejette toute configuration où l’implémentation effective du bac à sable est autre que MXC. Sélectionnez MXC séparément. Si Codex ne peut pas l’utiliser, la configuration échoue sans repli sur un ancien bac à sable.

Suggestions

Premiers pas

Notions fondamentales

SDK et CLI

Fournisseurs de services cloud

Ressources

Anciennes API

Choisissez un modèle

Texte et code

Rédaction de prompts

Raisonnement

Images

Temps réel et audio

Modèles spécialisés

API Agents

Agents SDK

ChatKit

Recherche et récupération d’informations

Connectez des outils et des sources de données

Créez des workflows qui font appel à des outils

Ordinateur et code

Médias

GPT-Live

Realtime API

Créer des applications vocales

Connexions

Traitement audio

Mise en production

Performances et qualité

Évaluation

Coût et débit

Sécurité et gouvernance

Infrastructure et accès

Opérations

Concepts clés

Planification

Développement

Tests et publication

Spécifications de conversion

Guides

Ressources

Identité

Utilisation du forfait ChatGPT

Guides

Envoi de fichiers

API

Mesure des performances

API pour les annonceurs

Référence de l’API

Premiers pas

Premiers pas

Notions de base

Explorer

Disponible sur

Versions

Workflows

Capacités

Sites

dots

Espace ChatGPT

Référence

Personnalisation

Fichier de configuration

Configuration des agents

Étendre les fonctionnalités de ChatGPT et de Codex

Linux

Windows

Workflows de développement

Extensions et automatisation

Environnements

Codex Cloud

Développer avec Codex

Intégrations tierces

Référence

Autorisations

Codex Security

Cybersécurité

Premiers pas

Configuration des fonctionnalités

Identité et accès

`config.toml`

`requirements.toml`