{"meta":{"title":"GitHub Copilot le répertoire de configuration du CLI","intro":"Recherchez des informations sur le ~/.copilot répertoire, où Copilot CLI stocke la configuration, les données de session et les personnalisations.","product":"GitHub Copilot","breadcrumbs":[{"href":"/fr/copilot","title":"GitHub Copilot"},{"href":"/fr/copilot/reference","title":"Informations de référence"},{"href":"/fr/copilot/reference/copilot-cli-reference","title":"Copilot CLI référence"},{"href":"/fr/copilot/reference/copilot-cli-reference/cli-config-dir-reference","title":"Répertoire de configuration CLI"}],"documentType":"article"},"body":"# GitHub Copilot le répertoire de configuration du CLI\n\nRecherchez des informations sur le ~/.copilot répertoire, où Copilot CLI stocke la configuration, les données de session et les personnalisations.\n\nCopilot CLI stocke sa configuration, son historique de session, ses journaux et ses personnalisations dans un seul répertoire sur votre ordinateur. Par défaut, ce répertoire est `~/.copilot` (autrement dit, `$HOME/.copilot`).\n\nCet article décrit le contenu de ce répertoire et la façon dont vous pouvez les utiliser.\n\n## Vue d’ensemble du répertoire\n\nLe `~/.copilot` répertoire contient les éléments de niveau supérieur suivants.\n\n| Chemin | Type | Description |\n| ------------------------- | ---------- | ------------------------------------------------------------------------------------------------------------- |\n| `agents/` | Répertoire | Définitions d’agents personnalisés personnels |\n| `config.json` | Fichier | État de l’application gérée automatiquement (authentification, plug-ins installés et autres données internes) |\n| `copilot-instructions.md` | Fichier | Instructions personnalisées personnelles (appliquées à toutes les sessions) |\n| `extensions/` | Répertoire | Extensions personnelles chargées par l’interface CLI |\n| `hooks/` | Répertoire | Scripts de hook au niveau de l’utilisateur |\n| `ide/` | Répertoire | État d’intégration de l’IDE |\n| `installed-plugins/` | Répertoire | Fichiers de plug-in installés |\n| `instructions/` | Répertoire | Fichiers personnels `*.instructions.md` supplémentaires |\n| `logs/` | Répertoire | Fichiers journaux de session |\n| `lsp-config.json` | Fichier | Définitions de serveur LSP au niveau de l’utilisateur |\n| `mcp-config.json` | Fichier | Définitions de serveur MCP au niveau de l’utilisateur |\n| `mcp-oauth-config/` | Répertoire | Jeton OAuth MCP et stockage de repli pour l’inscription |\n| `mcp-secrets/` | Répertoire | Stockage local de secours et index pour les espaces réservés des secrets MCP |\n| `permissions-config.json` | Fichier | Paramètres d'outils enregistrés et permissions des répertoires par projet |\n| `plugin-data/` | Répertoire | Données persistantes pour les plug-ins installés |\n| `session-state/` | Répertoire | Historique des sessions et données d’espace de travail |\n| `command-history-state/` | Répertoire | Données d’historique des commandes |\n| `session-store.db` | Fichier | Base de données SQLite pour les données entre sessions |\n| `settings.json` | Fichier | Vos paramètres de configuration personnels |\n| `skills/` | Répertoire | Définitions de compétences personnalisées personnelles |\n\n> \\[!NOTE]\n> Tous ces éléments n’apparaissent pas immédiatement. Certaines sont créées à la demande la première fois que vous utilisez une fonctionnalité particulière, par exemple, `installed-plugins/` s’affiche uniquement après avoir installé votre premier plug-in.\n\n## Fichiers modifiables par l’utilisateur\n\nLes fichiers suivants sont conçus pour être modifiés directement ou gérés par le biais de commandes CLI.\n\n### `settings.json`\n\nIl s’agit du fichier de configuration principal pour Copilot CLI. Dans une session, vous pouvez utiliser la commande interactive `/settings` pour modifier des valeurs spécifiques ou exécuter `/settings KEY VALUE` pour définir une valeur unique. Consultez « [Modification des paramètres avec la \\`/settings\\` commande](/fr/copilot/how-tos/copilot-cli/customize-copilot/change-settings) ». Vous pouvez également modifier le `settings.json` fichier directement dans un éditeur de texte. Le fichier prend en charge JSON avec des commentaires (JSONC).\n\nPar défaut, ce fichier se trouve dans le `~/.copilot` répertoire, qui est le répertoire de configuration au niveau de l’utilisateur. Il contient des valeurs par défaut globales au niveau de l’utilisateur pour tous les référentiels. Vous pouvez modifier l’emplacement de ce répertoire en définissant la `COPILOT_HOME` variable d’environnement sur un chemin différent.\n\n> \\[!NOTE]\n> Les paramètres modifiables par l’utilisateur ont été stockés à l’origine dans `config.json`. Ils ont été déplacés vers `settings.json`. Tous les paramètres utilisateur présents au `config.json` démarrage sont automatiquement migrés vers `settings.json`.\n\nSi `settings.json` ne parvient pas à lire, à analyser ou à valider, Copilot CLI ignore les valeurs non valides (les valeurs `config.json` reconnues sont toujours fusionnées) et affiche un avertissement de démarrage dans la chronologie, vous invitant à consulter l’onglet **Problèmes** de la commande `/settings`. Ouvrez cet onglet pour afficher l’erreur spécifique, puis corrigez le problème signalé pour restaurer les paramètres affectés.\n\nSi `settings.json` elle contient une clé de niveau supérieur qui n’est pas un paramètre reconnu (par exemple, une faute de frappe), Copilot CLI la répertorie dans l’onglet **Problèmes** de la `/settings` commande au lieu de la chronologie ou dans stderr. L’étiquette de l’onglet affiche un nombre (par exemple, `Problems (2)`) lorsqu’un périmètre de configuration présente un problème.\n`$schema` est toléré et n’est jamais signalé.\n\nSi `~/.copilot/settings.json` est un lien symbolique — par exemple, pour synchroniser des paramètres via un dépôt de fichiers de configuration — les écritures effectuées par la commande `/settings` suivent le lien symbolique et mettent à jour sa cible au lieu de remplacer le lien symbolique par un fichier ordinaire.\n\nPour obtenir la liste complète des paramètres et la façon dont ils interagissent avec la configuration au niveau du référentiel, consultez [les paramètres du fichier de configuration](#configuration-file-settings) plus loin dans cet article.\n\n> \\[!TIP]\n> Exécutez `copilot help config` dans votre terminal pour obtenir une référence rapide.\n\n### `copilot-instructions.md`\n\nInstructions personnalisées personnelles qui s’appliquent à toutes vos sessions, quel que soit le projet dans lequel vous travaillez. Ce fichier fonctionne de la même façon qu’au niveau `copilot-instructions.md` du référentiel, mais s’applique globalement.\n\nPour plus d’informations, consultez « [Ajout d’instructions personnalisées de référentiel pour GitHub Copilot](/fr/copilot/how-tos/copilot-on-github/customize-copilot/add-custom-instructions/add-repository-instructions) ».\n\n### `instructions/`\n\nStockez ici des fichiers d’instructions personnelles supplémentaires sous forme de `*.instructions.md` fichiers. Celles-ci sont chargées en même temps que `copilot-instructions.md` et s'appliquent à toutes vos sessions. Vous pouvez organiser des instructions par rubrique, par exemple `~/.copilot/instructions/code-style.instructions.md`.\n\n### `mcp-config.json`\n\nDéfinit les serveurs MCP (Model Context Protocol) disponibles au niveau de l’utilisateur. Ces serveurs sont disponibles dans toutes vos sessions, quel que soit le répertoire de projet dans lequel vous vous trouvez. Configurations MCP de niveau projet (dans `.mcp.json` ou `.github/mcp.json`) ont la priorité sur les définitions au niveau de l’utilisateur lorsque les noms de serveurs sont en conflit.\n\nPour plus d’informations, consultez « [Ajout de serveurs MCP pour GitHub Copilot CLI](/fr/copilot/how-tos/copilot-cli/customize-copilot/add-mcp-servers) ».\n\n### `lsp-config.json`\n\nDéfinit les serveurs LSP (Language Server Protocol) disponibles au niveau de l’utilisateur. Ces serveurs fournissent une intelligence linguistique (diagnostics, autocomplétions, etc.) à l’agent. Gérez ce fichier à l’aide de la `/lsp` commande de barre oblique ou modifiez-le directement.\n\nPour plus d’informations, consultez « [Ajout de serveurs LSP pour GitHub Copilot CLI](/fr/copilot/how-tos/copilot-cli/set-up-copilot-cli/add-lsp-servers) ».\n\n### `agents/`\n\nStockez les définitions d’agent personnalisé personnelles ici sous forme de `.agent.md` fichiers. Les agents placés dans ce répertoire sont disponibles dans toutes vos sessions. Les agents de niveau projet (dans `.github/agents/`) sont prioritaires sur les agents personnels s’ils partagent le même nom.\n\nPour plus d’informations, consultez « [Création et utilisation d’agents personnalisés pour GitHub Copilot CLI](/fr/copilot/how-tos/copilot-cli/customize-copilot/create-custom-agents-for-cli) ».\n\n### `skills/`\n\nStockez les définitions de compétences personnalisées personnelles ici. Chaque compétence se trouve dans un sous-répertoire contenant un `SKILL.md` fichier, par exemple `~/.copilot/skills/my-skill/SKILL.md`. Les compétences personnelles sont présentes dans toutes vos sessions. Les compétences de niveau projet ont la priorité sur les compétences personnelles si elles partagent le même nom.\n\nPour plus d’informations, consultez « [Ajout de compétences d’agent pour GitHub Copilot CLI](/fr/copilot/how-tos/copilot-cli/customize-copilot/add-skills) ».\n\n### `hooks/`\n\nStockez les scripts de hook au niveau de l’utilisateur ici. Ces hooks s’appliquent à toutes vos sessions. Vous pouvez également définir des hooks inline dans votre fichier de configuration utilisateur (`~/.copilot/settings.json`) à l’aide de la `hooks` clé. Les hooks au niveau du référentiel (in `.github/hooks/`) sont chargés en même temps que les hooks au niveau de l’utilisateur.\n\nPour plus d’informations, consultez « [Utilisation de crochets avec GitHub Copilot CLI](/fr/copilot/how-tos/copilot-cli/customize-copilot/use-hooks) ».\n\n### `extensions/`\n\nStockez les fichiers d’extension au niveau de l’utilisateur ici. Les extensions de ce répertoire sont disponibles entre les sessions.\n\nVous pouvez créer manuellement des fichiers dans ce répertoire ou générer une extension, puis modifier le fichier généré.\n\n## Fichiers gérés automatiquement\n\nLes éléments suivants sont gérés par l’interface CLI. Vous ne devez généralement pas les modifier manuellement.\n\n### `config.json`\n\nStocke l’état d’application interne géré automatiquement par l’interface CLI, notamment les données d’authentification, les métadonnées du plug-in installé et d’autres informations d’exécution. Vous ne devez normalement pas avoir besoin de modifier ce fichier.\n\n> \\[!NOTE]\n> Les versions antérieures de Copilot CLI stockaient à la fois les paramètres utilisateur et l’état de l'application dans `config.json`. Les paramètres modifiables par l’utilisateur se trouvent désormais dans `settings.json`. Tous les paramètres utilisateur dans `config.json` au démarrage sont automatiquement migrés vers `settings.json`. Les champs d’état de l’application( tels que `loggedInUsers`, , `installedPlugins``firstLaunchAt`et `staff`) restent dans `config.json` et ne sont pas migrés.\n\n### `permissions-config.json`\n\nStocke vos décisions enregistrées concernant les autorisations d'outils et de répertoires, organisées par emplacement de projet. Lorsque vous approuvez un outil ou accordez l’accès à un répertoire pour l’emplacement actuel, l’interface CLI enregistre la décision ici afin de ne pas être invité à nouveau dans le même référentiel ou répertoire.\n\n> \\[!NOTE]\n> Si vous souhaitez réinitialiser les autorisations d’un projet, vous pouvez supprimer l’entrée appropriée de ce fichier. Toutefois, la modification du fichier pendant l’exécution d’une session peut entraîner un comportement inattendu. L’interface CLI supprime automatiquement les entrées dont le chemin d’accès d’emplacement n’existe plus sur le disque.\n\n#### Emplacement du fichier\n\nCopilot CLI résout le fichier à partir du répertoire de configuration.\n\n| Priority | Source | Fichier utilisé |\n| -------- | ------------------------ | --------------------------------------- |\n| 1 | `--config-dir=DIRECTORY` | `DIRECTORY/permissions-config.json` |\n| 2 | `COPILOT_HOME` | `$COPILOT_HOME/permissions-config.json` |\n| 3 | Default | `~/.copilot/permissions-config.json` |\n\nL’interface CLI utilise uniquement le premier répertoire de configuration applicable dans cet ordre. Ne charge pas non plus `permissions-config.json` depuis des emplacements de priorité inférieure.\n\nL’option `--config-dir` est une option héritée. Préférez `COPILOT_HOME` lorsque vous devez modifier le répertoire de configuration.\n\nSur Windows, le fichier par défaut est généralement :\n\n```text\nC:\\Users\\YOUR-USER\\.copilot\\permissions-config.json\n```\n\nLes builds plus anciennes utilisaient un fichier sans extension nommé `permissions-config`. Si `permissions-config.json` n’existe pas, mais que le fichier sans extension existe, l’interface de ligne de commande continue de prendre en compte l’ancien fichier. Utiliser `permissions-config.json` pour les nouvelles modifications.\n\nLes anciens emplacements de configuration basés sur XDG sont transférés vers `~/.copilot` au démarrage lorsque `COPILOT_HOME` n’est pas défini.\n\n#### Clés de localisation\n\nL’objet `locations` de niveau supérieur a pour clé un chemin absolu.\n\n* Pour un dépôt Git, utilisez la racine Git servant à définir la portée des autorisations.\n* Les arborescences de travail liées renvoient à la racine du référentiel principal, de sorte qu’elles partagent les mêmes droits que l’arborescence de travail principale.\n* Les sous-modules utilisent leur propre répertoire de travail.\n* Pour un répertoire qui ne se trouve pas dans un référentiel Git, utilisez le répertoire de travail actuel normalisé.\n\nLa clé doit correspondre à l’emplacement où Copilot CLI s’exécute. Si la clé ne correspond pas, les approbations enregistrées ne s’appliquent pas.\n\nL’interface CLI charge les approbations de l’emplacement correspondant lorsqu’une session démarre et lorsque le répertoire de travail actif change.\n\n#### Schema\n\nLe fichier doit contenir un objet JSON.\n\n| Champ | Type | Obligatoire | Default | Valeurs autorisées | Description |\n| ---------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------- | --------------------------------------- | ------- | ------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |\n| `locations` | Object | Non | `{}` | Clés de chemin d’accès absolus | Mappage des clés de localisation aux approbations enregistrées. |\n| `locations.` | Object | Non | `{}` | Toute clé de localisation absolue | Approbations enregistrées pour un référentiel ou un répertoire. |\n| `locations..tool_approvals` | Array | Non | `[]` | Objets de validation | Outils approuvés pour cet emplacement. |\n| `locations..allowed_directories` | Tableau de chaînes | Non | `[]` | Chemins d’accès absolus au répertoire | Répertoires supplémentaires auxquels la porte de chemin d’accès peut accéder pour cet emplacement. Chaque répertoire doit exister lorsque l’interface CLI applique la configuration. |\n| `locations..tool_approvals[].kind` | String | Oui | None | | |\n| `commands`, `read`, `write`, `mcp`, `mcp-sampling`, `memory`, `custom-tool`, `extension-management`, `extension-permission-access` | Sélectionne le type d’approbation. | | | | |\n| `commandIdentifiers` | Tableau de chaînes | Oui, pour `commands` | None | Identificateurs de commande | Identifiants des commandes shell à approuver. |\n| `serverName` | String | Oui, pour `mcp` et `mcp-sampling` | None | Nom du serveur MCP | Serveur MCP à approuver. |\n| `toolName` | Chaîne ou `null` | Oui, pour `mcp` | None | Nom de l’outil MCP ou `null` | Outil MCP à approuver. Utilisez `null` pour approuver tous les outils sur le serveur. |\n| `toolName` | String | Oui, pour `custom-tool` | None | Nom de l’outil personnalisé | Outil personnalisé à approuver par son nom exact. |\n| `operation` | String | Non, pour `extension-management` | Omis | Nom de l’opération d’extension | Opération de gestion des extensions à approuver. Omettez ce champ pour approuver toutes les opérations de gestion des extensions. |\n| `extensionName` | String | Oui, pour `extension-permission-access` | None | Nom de l’extension | Extension dont l’accès aux fonctionnalités avec contrôle d’autorisation est approuvé. |\n\n`permissions-config.json` ne prend pas en charge les règles de refus, les règles « ask », les modes par défaut, les règles d’URL, le filtrage d’outils ou la stratégie partagée locale du référentiel. Pour ces comportements, utilisez des options de ligne de commande telles que `--deny-tool`, , `--available-tools``--excluded-tools`, `--allow-url`, , et `--deny-url`. Les règles d’URL enregistrées sont stockées dans `settings.json`, et non dans `permissions-config.json`.\n\nLes champs inconnus ne font pas partie du schéma. L’interface CLI peut les ignorer, et les écritures ultérieures peuvent les supprimer.\n\n#### Types d’approbation\n\nChaque élément dans `tool_approvals` doit être l’un des objets suivants.\n\n| `kind` | Champs obligatoires | Champs facultatifs | Meaning |\n| ----------------------------- | -------------------- | ------------------------------------------------------------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |\n| `commands` | `commandIdentifiers` | None | Approuve les identificateurs de commande shell correspondants. |\n| `read` | None | None | Approuve les demandes d’accès à l’outil de lecture. Les sessions CLI interactives approuvent déjà les lectures automatiquement, ce qui est généralement inutile. |\n| `write` | None | None | Approuve les demandes d’outils de création et de modification de fichier. Une invite de chemin peut encore s’appliquer à des chemins situés hors des répertoires autorisés. |\n| `mcp` | | | |\n| `serverName`, `toolName` | None | Approuve un outil MCP, ou chaque outil sur le serveur quand `toolName` c’est `null`. | |\n| `mcp-sampling` | `serverName` | None | Approuve les demandes d’échantillonnage MCP pour un serveur. |\n| `memory` | None | None | Approuve les demandes d’écriture en mémoire et de vote. |\n| `custom-tool` | `toolName` | None | Approuve un outil personnalisé par son nom exact. |\n| `extension-management` | None | `operation` | Autorise la gestion des extensions. Si `operation` est omis, toutes les opérations de gestion des extensions s’appliquent. |\n| `extension-permission-access` | `extensionName` | None | Approuve l’accès d’une extension aux fonctionnalités de contrôle d’autorisation. |\n\nPour les approbations MCP, `serverName` doit correspondre exactement au nom du serveur MCP configuré. Utilisez le nom de serveur brut de votre configuration MCP, et non un préfixe de nom d’outil nettoyé.\n\n#### Correspondance des commandes shell\n\n`permissions-config.json` ne prend pas en charge les expressions régulières ni les motifs génériques de type glob. Les valeurs de chaîne sont mises en correspondance de manière littérale, sauf qu’un `:*` final dans une valeur d’interpréteur de commandes `commandIdentifiers` correspond au texte situé avant `:*`, soit seul, soit suivi d’un espace et d’autre texte. Une plaine `*` n’a pas de signification particulière, donc `git*` ne correspond `git status`pas .\n\n| Modèle | Correspondances | Ne correspond pas |\n| ------------------------------------- | --------------- | -------------------- |\n| `git status` | `git status` | `git status --short` |\n| `git:*` | | |\n| `git`, `git status`, `git push` | `gitea` | |\n| `gh pr:*` | | |\n| `gh pr`, `gh pr view`, `gh pr create` | `gh repo view` | |\n\n#### Mise en correspondance des répertoires\n\nLes `allowed_directories` entrées permettent à Copilot CLI d’accéder aux chemins situés dans ces répertoires sans demande distincte de chemin d’accès. Ils n’approuvent pas le fonctionnement même de l’outil. Par exemple, la modification d’un fichier dans un répertoire autorisé peut toujours nécessiter une `write` approbation.\n\nChaque `allowed_directories` entrée doit être un répertoire absolu, non vide et accessible. L’interface en ligne de commande (CLI) résout les liens symboliques avant de comparer les chemins d’accès, bloque les chemins réseau UNC sauf s’il s’agit de chemins locaux de longueur étendue, compare les chemins d’accès sans tenir compte de la casse sous Windows et les compare en tenant compte de la casse sur les autres plateformes. Si une entrée ne peut pas être appliquée, l’interface CLI enregistre un avertissement et ignore cette entrée.\n\n#### Exemples\n\nAutorisez toutes les sous-commandes Git et accédez à un répertoire local supplémentaire :\n\n```json copy\n{\n \"locations\": {\n \"C:\\\\src\\\\my-repo\": {\n \"tool_approvals\": [\n {\n \"kind\": \"commands\",\n \"commandIdentifiers\": [\"git:*\"]\n }\n ],\n \"allowed_directories\": [\"C:\\\\src\\\\shared-docs\"]\n }\n }\n}\n```\n\nAutoriser les commandes sélectionnées tout en demandant toujours une confirmation avant toute écriture de fichier :\n\n```json copy\n{\n \"locations\": {\n \"/Users/YOUR-USER/src/my-repo\": {\n \"tool_approvals\": [\n {\n \"kind\": \"commands\",\n \"commandIdentifiers\": [\n \"git status\",\n \"git diff\",\n \"git log\",\n \"npm test\",\n \"npm run build\"\n ]\n }\n ]\n }\n }\n}\n```\n\nApprouver les écritures de fichiers et un serveur MCP pour un référentiel :\n\n```json copy\n{\n \"locations\": {\n \"/home/YOUR-USER/src/my-repo\": {\n \"tool_approvals\": [\n {\n \"kind\": \"write\"\n },\n {\n \"kind\": \"mcp\",\n \"serverName\": \"github-mcp-server\",\n \"toolName\": null\n }\n ]\n }\n }\n}\n```\n\nApprouvez un outil MCP, des écritures de mémoire et un accès aux autorisations d’extension :\n\n```json copy\n{\n \"locations\": {\n \"C:\\\\src\\\\my-repo\": {\n \"tool_approvals\": [\n {\n \"kind\": \"mcp\",\n \"serverName\": \"github-mcp-server\",\n \"toolName\": \"search_code\"\n },\n {\n \"kind\": \"memory\"\n },\n {\n \"kind\": \"extension-permission-access\",\n \"extensionName\": \"my-extension\"\n }\n ]\n }\n }\n}\n```\n\n### `session-state/`\n\nContient des données d’historique de session, organisées par ID de session dans les sous-répertoires. Chaque répertoire de session stocke un journal des événements (`events.jsonl`) et des artefacts d’espace de travail (plans, points de contrôle, fichiers suivis). Ces données activent la reprise de session (`--resume` ou `--continue`).\n\nLa suppression de fichiers de ce répertoire supprime uniquement les copies locales. Si vous avez synchronisé des sessions avec votre GitHub compte, les données synchronisées sont stockées séparément et ne sont pas affectées par la suppression de fichier local. Vous pouvez supprimer ou masquer les sessions synchronisées à partir de GitHub.com. Pour plus d’informations, consultez « [À propos des GitHub Copilot CLI données de session](/fr/copilot/concepts/agents/copilot-cli/chronicle#managing-your-session-data) ».\n\n### `command-history-state/`\n\nContient les données d’historique des commandes utilisées pour la recherche inversée (Ctrl+R) et la navigation dans l’historique dans l’interface interactive. Ce répertoire est géré automatiquement et ne doit pas être modifié.\n\n### `session-store.db`\n\nBase de données SQLite utilisée par l’interface CLI pour les données intersession, telles que l’indexation et la recherche de point de contrôle. Ce fichier est géré automatiquement et ne doit pas être modifié.\n\nSi vous supprimez ce fichier, vous pouvez le reconstruire à l’aide de la `/chronicle reindex` commande. La réindexation synchronise également vos données de session avec votre compte.\n\n### `logs/`\n\nContient des fichiers journaux pour les sessions CLI. Chaque session crée un fichier journal nommé `process-{timestamp}-{pid}.log`. Ces fichiers sont utiles pour déboguer des problèmes.\n\nL’interface CLI peut également créer des journaux propres à certaines extensions dans le répertoire `logs/extensions/`.\n\nCeci est distinct de `~/.copilot/extensions/`, qui stocke le code d’extension créé par l’utilisateur.\n\n> \\[!TIP]\n> Pour trouver le fichier journal de votre session active, entrez `/session` dans une session interactive. La sortie inclut le chemin complet du fichier journal, ainsi que d’autres détails de session tels que l’ID de session, la durée et le répertoire de travail.\n\n### `installed-plugins/`\n\nContient les fichiers des plug-ins que vous avez installés. Les plug-ins installés à partir d’une Place de marché sont stockés sous `installed-plugins/{marketplace-name}/{plugin-name}/`. Les plug-ins directement installés sont stockés sous `installed-plugins/_direct/`. Gérez les plug-ins à l’aide `copilot plugin` des commandes plutôt que de modifier ce répertoire directement.\n\nPour plus d’informations, consultez « [Référence du plug-in CLI GitHub Copilot](/fr/copilot/reference/copilot-cli-reference/cli-plugin-reference) ».\n\n### `plugin-data/`\n\nContient des données persistantes pour les plug-ins installés, organisées par nom de la Place de marché et du plug-in. Ces données sont gérées par les plug-ins eux-mêmes et ne doivent pas être modifiées manuellement.\n\n### `ide/`\n\nContient des fichiers de verrouillage et l'état pour les intégrations IDE (par exemple, lorsque Copilot CLI se connecte à Visual Studio Code). Ce répertoire est géré automatiquement.\n\n### `mcp-oauth-config/`\n\nContient les fichiers relatifs aux jetons OAuth MCP, à l’enregistrement et au mécanisme de secours PKCE lorsque le stockage basé sur le trousseau n’est pas disponible. Ce répertoire est géré automatiquement.\n\n### `mcp-secrets/`\n\nContient le stockage de secours sous forme de fichiers ainsi qu’un index des espaces réservés des secrets MCP lorsque le stockage basé sur le trousseau n’est pas disponible. Ce répertoire est géré automatiquement.\n\n## Modification de l’emplacement du répertoire de configuration\n\nPour remplacer l’emplacement par défaut `~/.copilot` , définissez la `COPILOT_HOME` variable d’environnement sur le chemin du répertoire que vous souhaitez utiliser.\n\n```bash copy\nexport COPILOT_HOME=/path/to/my/copilot-config\n```\n\n### Éléments à prendre en compte\n\n* `COPILOT_HOME` remplace l’intégralité du chemin d’accès `~/.copilot`. La valeur que vous définissez doit être le chemin complet du répertoire que vous souhaitez utiliser pour les fichiers de configuration et les sous-répertoires.\n* La modification du répertoire signifie que votre configuration existante, l’historique des sessions, les plug-ins installés et les autorisations enregistrées sont introuvables dans le nouvel emplacement. Copiez ou déplacez le contenu de `~/.copilot` vers le nouvel emplacement si vous souhaitez le conserver.\n* Le **répertoire de cache** (utilisé pour les caches de la Place de marché, les packages de mise à jour automatique et d’autres données éphémères) suit les conventions de plateforme et n’est pas affecté par `COPILOT_HOME`. Il se trouve à :\n\n * **macOS** : `~/Library/Caches/copilot`\n * **Linux** : `$XDG_CACHE_HOME/copilot` ou `~/.cache/copilot`\n * **Windows** : `%LOCALAPPDATA%/copilot`\n\n Pour remplacer le répertoire du cache séparément, définissez `COPILOT_CACHE_HOME`.\n\n## Ce que vous pouvez supprimer en toute sécurité\n\n| Élément | Sûr de supprimer ? | Résultat |\n| ------------------------------------------ | ------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |\n| `agents/`, `skills/`, `hooks/` | Non recommandé | Vous perdrez vos personnalisations personnelles. Sauvegardez d’abord. |\n| `config.json` | Avec précaution | Réinitialise l’état de l’application, y compris l’authentification. Il sera nécessaire de vous réauthentifier, et l’interface en ligne de commande (CLI) détectera de nouveau l’état interne lors du prochain lancement. |\n| `copilot-instructions.md`, `instructions/` | Non recommandé | Vous perdrez vos instructions personnalisées personnelles. Sauvegardez d’abord. |\n| `extensions/` | Non recommandé | Vous perdrez vos extensions personnelles. Sauvegardez d’abord. |\n| `installed-plugins/` | Non recommandé | Utilisez `copilot plugin uninstall` à la place pour vous assurer que les métadonnées `config.json` du plug-in restent précises. |\n| `logs/` | Oui | Les fichiers journaux sont recréés à chaque session. La suppression de ces éléments n’a aucun impact fonctionnel. |\n| `lsp-config.json` | Non recommandé | Vous perdrez vos définitions de serveur LSP au niveau de l’utilisateur. Sauvegardez d’abord. |\n| `mcp-config.json` | Non recommandé | Vous perdrez vos définitions de serveur MCP au niveau de l’utilisateur. Sauvegardez d’abord. |\n| `mcp-oauth-config/` | Avec précaution | Supprime l’état local de secours de l’authentification OAuth MCP. Vous devrez peut-être ré-authentifier les serveurs MCP. |\n| `mcp-secrets/` | Avec précaution | Supprime l’état local de secours des secrets MCP ainsi que les mappages associés. Les serveurs MCP sauvegardés par secret peuvent avoir besoin de reconfiguration. |\n| `permissions-config.json` | Avec précaution | Réinitialise toutes les autorisations enregistrées. L'interface CLI vous demandera à nouveau des approbations d'outils et de répertoires. |\n| `plugin-data/` | Oui | Les données persistantes du plug-in sont recréations si nécessaire. |\n| `session-state/` | Avec précaution | La suppression supprime l’historique des sessions. Vous ne pourrez plus reprendre les sessions passées. |\n| `command-history-state/` | Avec précaution | La suppression supprime l’historique des commandes. Vous ne pourrez plus rechercher les commandes précédentes avec Ctrl+R. |\n| `session-store.db` | Avec précaution | La suppression supprime les données entre sessions. Le fichier est recréé automatiquement. |\n| `settings.json` | Avec précaution | Réinitialise toutes les préférences utilisateur aux valeurs par défaut. Vous devez reconfigurer vos paramètres. |\n\n## Paramètres du fichier de configuration\n\nLes paramètres sont appliqués dans cet ordre (les suivants remplacent les précédents) :\n\n\n\n1. Valeurs par défaut intégrées\n2. Paramètres gérés par la gestion des appareils mobiles (MDM)\n3. Paramètres utilisateur (`~/.copilot/settings.json`)\n4. Paramètres du référentiel (`.github/copilot/settings.json`)\n5. Paramètres locaux (`.github/copilot/settings.local.json`)\n6. Variables d’environnement\n7. Indicateurs de ligne de commande\n\n\n\nLes paramètres gérés par MDM sont chargés au démarrage et fusionnent avec les paramètres utilisateur comme base de référence de la stratégie. Pour la plupart des clés, les paramètres utilisateur peuvent remplacer cette ligne de base. Pour `permissions.disableBypassPermissionsMode`, une valeur MDM de `\"disable\"` prévaut toujours. Pour plus d’informations, consultez [les paramètres managés MDM](#mdm-managed-settings).\n\n| Étendue | Location | Objectif |\n| ----------- | ------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------- |\n| User | `~/.copilot/settings.json` | Valeurs par défaut globales pour tous les référentiels. Utilisez la variable d’environnement `COPILOT_HOME` pour spécifier un autre chemin d’accès. |\n| Référentiel | `.github/copilot/settings.json` | Configuration du dépôt partagé (enregistrée dans le dépôt). |\n| Local | `.github/copilot/settings.local.json` | Remplacements personnels (ajouter à `.gitignore`). |\n\nL’interface CLI lit également `.claude/settings.json` et `.claude/settings.local.json` pour le sous-ensemble partagé de paramètres de dépôt commun à plusieurs outils (tels que `companyAnnouncements`, `disableAllHooks`, `enabledPlugins`, `extraKnownMarketplaces` et `hooks`).\n\n### Paramètres utilisateur (`~/.copilot/settings.json`)\n\nCes paramètres s’appliquent à toutes vos sessions et référentiels. Vous pouvez utiliser la `/settings` commande de barre oblique pour exécuter une boîte de dialogue interactive, ou utiliser des commandes de barre oblique spécifiques pour mettre à jour des valeurs individuelles ou modifier ce fichier directement.\n\n| Clé | Type | Default | Description |\n| --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |\n| `allowedUrls` | `string[]` | `[]` | URL ou domaines autorisés sans invite. Prend en charge les URL exactes, les modèles de domaine et les sous-domaines génériques (par exemple). `\"*.github.com\"` |\n| `askUser` | `boolean` | `true` | Autoriser l’agent à poser des questions de clarification. Régler sur `false` pour un fonctionnement entièrement autonome. Peut également être défini avec `--no-ask-user`. |\n| `autoUpdate` | `boolean` | `true` | Téléchargez automatiquement les mises à jour de l’interface CLI et mettez à jour les plug-ins internes au début de chaque session. |\n| `autoUpdatesChannel` | | | |\n| `\"stable\"` | | | |\n| \\| | | | |\n| `\"prerelease\"` | | | |\n| `\"stable\"` | Mettre à jour le canal. Définissez sur `\"prerelease\"` pour recevoir les mises à jour en préversion. | | |\n| `banner` | | | |\n| `\"always\"` | | | |\n| \\| | | | |\n| `\"once\"` | | | |\n| \\| | | | |\n| `\"never\"` | | | |\n| `\"once\"` | Fréquence d’affichage de bannière animée. | | |\n| `bashEnv` | `boolean` | `false` | Activez la `BASH_ENV` prise en charge des interpréteurs de commandes bash. Peut également être défini avec `--bash-env` ou `--no-bash-env`. |\n| `beep` | `boolean` | `true` | Émettez un bip sonore lorsque l'attention est nécessaire. |\n| `beepOnSchedule` | `boolean` | `true` | Émettre un bip sonore lorsqu’une exécution planifiée `/every` ou `/after` se termine. |\n| `builtInAgents.rubberDuck` | `boolean` | `true` | Active le sous-agent Rubber Duck, qui fournit des retours critiques concernant les plans élaborés par l’agent. |\n| `builtInAgents.rubberDuckAutoInvoke` | `boolean` | `false` | Active des invites proactives permettant d’invoquer automatiquement le sous-agent Rubber Duck. Définissez cette option sur `true` pour recevoir davantage de suggestions invitant à consulter Rubber Duck au cours des interactions avec l’agent. |\n| `colorMode` | | | |\n| `\"default\"` | | | |\n| \\| | | | |\n| `\"github\"` | | | |\n| \\| | | | |\n| `\"dim\"` | | | |\n| \\| | | | |\n| `\"high-contrast\"` | | | |\n| \\| | | | |\n| `\"colorblind\"` | | | |\n| `\"github\"` | Alias obsolète pour `theme`. Préférer `theme`. | | |\n| `commandHistoryMaxSize` | `number` | `50` | Nombre maximal de commandes récentes conservées pour l’historique des entrées et la recherche inversée. Doit être un entier compris entre `1` et `1000`. |\n| `compactPaste` | `boolean` | `true` | Réduisez les grands collages (plus de 10 lignes) en jetons compacts. |\n| `companyAnnouncements` | `string[]` | `[]` | Messages personnalisés affichés de manière aléatoire au démarrage. Un message est sélectionné de façon aléatoire chaque fois que l’interface CLI démarre. Utile pour les annonces ou les rappels au sein de l'équipe. |\n| `continueOnAutoMode` | `boolean` | `false` | Basculez automatiquement en mode automatique lorsque le taux est limité. Lorsque `true`, les erreurs de dépassement de débit admissibles déclenchent un passage automatique en mode automatique et une nouvelle tentative. Ne s’applique pas aux limites globales de taux ou aux fournisseurs BYOK. |\n| `copyOnSelect` | `boolean` | | |\n| `true` (macOS), `false` (autre) | Copiez automatiquement le texte sélectionné par la souris dans le Presse-papiers système. | | |\n| `customAgents.defaultLocalOnly` | `boolean` | `false` | Utilisez uniquement des agents personnalisés locaux (aucune organisation distante ni agent d’entreprise). |\n| `deniedUrls` | `string[]` | `[]` | URL ou domaines toujours refusés. Les règles de refus sont prioritaires sur les règles d’autorisation. |\n| `disableAllHooks` | `boolean` | `false` | Désactivez tous les hooks (au niveau du référentiel et au niveau de l’utilisateur). |\n| `disabledMcpServers` | `string[]` | `[]` | Noms de serveur MCP à désactiver. Les serveurs répertoriés sont configurés, mais pas démarrés. |\n| `disabledSkills` | `string[]` | `[]` | Noms de compétences à désactiver. Les compétences répertoriées sont identifiées, mais non chargées. |\n| `dynamicRetrieval` | `{ skills?: boolean }` | Non défini | Contrôle par catégorie de la récupération d’instructions dynamiques basée sur des incorporations. Définissez `skills` sur `false` pour désactiver la récupération pour les compétences. |\n| `effortLevel` | `string` | `\"medium\"` | Niveau d’effort de raisonnement pour la pensée étendue : `\"low\"`, `\"medium\"`, `\"high\"`, ou `\"xhigh\"`. Les niveaux supérieurs utilisent davantage de calcul. |\n| `enabledMcpServers` | `string[]` | `[]` | Activez les serveurs MCP intégrés qui sont désactivés par défaut. |\n| `enabledPlugins` | `Record` | `{}` | Installation automatique du plug-in déclaratif. Les clés sont des spécifications de plug-in ; les valeurs sont `true` (activées) ou `false` (désactivées). |\n| `experimental` | `boolean` | `false` | Activer les fonctionnalités expérimentales. Peut également être activé avec l'option `--experimental` de ligne de commande ou la commande slash `/experimental`. |\n| `extraKnownMarketplaces` | `Record` | `{}` | Places de marché de plug-in supplémentaires. Chaque clé est un nom de place de marché ; la valeur spécifie la valeur requise `source` (`\"directory\"`, `\"git\"`ou `\"github\"`). Définissez `autoUpdate: true` sur une entrée pour inclure les plugins installés depuis la place de marché dans la mise à jour automatique au démarrage de la session, au même titre que les plugins natifs. Ce choix d’activation s’applique uniquement aux sessions interactives et `-p` — les sessions SDK et les sessions serveur ne se mettent pas à jour automatiquement. L’option d’inscription est respectée quand elle est définie dans vos propres paramètres utilisateur ou dans les paramètres gérés (GPM/serveur). En cas de collision de noms, une place de marché propriétaire intégrée prévaut, puis une entrée gérée (qui remplace l’intégralité de l’entrée utilisateur du même nom ; ainsi, une entrée gérée sans `\"autoUpdate\": true` supprime le consentement de l’utilisateur), puis l’entrée propre à l’utilisateur. |\n| `footer` | `object` | — | Contrôle les éléments qui apparaissent dans la ligne d’état. Les sous-clés incluent `showModelEffort`, `showDirectory`, `showBranch`, `showContextWindow`, `showQuota`, `showAgent`, `showAiUsed`, `showCodeChanges`, `showUsername`, `showSandbox`, `showYolo` et `showCustom` (toutes `boolean`). Géré par la `/statusline` commande slash. |\n| `hooks` | `object` | — | Définitions de hooks au niveau utilisateur intégrées, indexées par nom d'événement. Utilise le même schéma que les `.github/hooks/*.json` fichiers. Consultez « [Utilisation de crochets avec GitHub Copilot CLI](/fr/copilot/how-tos/copilot-cli/customize-copilot/use-hooks) ». |\n| `ide.autoConnect` | `boolean` | `true` | Connectez-vous automatiquement à un espace de travail IDE au démarrage. Quand `false`, vous pouvez toujours vous connecter manuellement à l’aide de la commande `/ide`. |\n| `ide.openDiffOnEdit` | `boolean` | `true` | Ouvrez les différences de modification de fichier dans l’IDE connecté pour approbation. Lorsque `false`, les approbations de modification de fichier sont affichées uniquement dans le terminal. |\n| `includeCoAuthoredBy` | `boolean` | `true` | Ajoutez une mention `Co-authored-by` aux commits Git effectués par l’assistant.. |\n| `keepAlive` | | | |\n| `\"on\"` | | | |\n| \\| | | | |\n| `\"off\"` | | | |\n| \\| | | | |\n| `\"busy\"` | | | |\n| `\"off\"` | Mode maintien en vie appliqué au démarrage de l’interface CLI. | | |\n| `\"on\"` empêche toujours le système de se mettre en veille, `\"busy\"` empêche la mise en veille uniquement pendant l’exécution de l’agent, et `\"off\"` désactive le mode veille. Également configurable avec la commande `/keep-alive` slash. | | | |\n| `logLevel` | | | |\n| `\"none\"` | | | |\n| \\| | | | |\n| `\"error\"` | | | |\n| \\| | | | |\n| `\"warning\"` | | | |\n| \\| | | | |\n| `\"info\"` | | | |\n| \\| | | | |\n| `\"debug\"` | | | |\n| \\| | | | |\n| `\"all\"` | | | |\n| \\| | | | |\n| `\"default\"` | | | |\n| `\"default\"` | Verbosité de la journalisation. | | |\n| `mergeStrategy` | | | |\n| `\"rebase\"` | | | |\n| \\| | | | |\n| `\"merge\"` | | | |\n| — | Stratégie de résolution des conflits pour `/pr fix conflicts`. Lorsqu’il est défini sur `\"rebase\"`, les conflits sont résolus en appliquant un rebase sur la branche de base. Lorsque la valeur est définie `\"merge\"`, la branche de base est fusionnée dans la branche de fonctionnalité. S’il n’est pas configuré, une boîte de dialogue sélecteur s’affiche. | | |\n| `model` | `string` | varie | Modèle IA à utiliser. Définissez cette option `\"auto\"` pour laisser Copilot choisir automatiquement le modèle le mieux disponible. Géré par la `/model` commande slash. |\n| `mouse` | `boolean` | `true` | Activez la prise en charge de la souris. Peut également être défini avec `--mouse` ou `--no-mouse`. |\n| `permissions.disableBypassPermissionsMode` | `string` | — | Défini pour `\"disable\"` supprimer tous les indicateurs allow-all (`--allow-all-tools`, `--allow-all-paths`, `--allow-all-urls`, `--allow-all`, `--yolo`) au démarrage afin qu’ils ne puissent pas être utilisés pour accorder des autorisations élevées. Définissez sur `\"allow-auto-only\"` pour continuer à bloquer l’autorisation complète tout en permettant `/allow-all auto` (approbation automatique assistée par LLM). Consultez « [Référence de commande CLI pour GitHub Copilot](/fr/copilot/reference/copilot-cli-reference/cli-command-reference#restricting-the---allow-all-options) ». |\n| `pinnedPrompts` | `boolean` | `true` | Épinglez le prompt utilisateur de la section actuelle juste sous la barre supérieure lors du défilement de la chronologie, afin qu’il soit toujours clair à quelle requête correspond le résultat affiché. Concerne uniquement l’interface utilisateur CLI — n’a aucun effet sur les instructions envoyées au modèle. |\n| `powershellFlags` | `string[]` | `[\"-NoProfile\", \"-NoLogo\"]` | Indicateurs transmis à PowerShell au démarrage. Sur Windows, l’interface CLI préfère PowerShell 7+ (`pwsh`) et revient à Windows PowerShell (`powershell.exe`) quand `pwsh` n’est pas disponible. Windows uniquement. |\n| `proxyKerberosServicePrincipal` | `string` | Non défini | Nom du principal de service (SPN) pour l’authentification proxy Kerberos/Negotiate, qui remplace celui dérivé `HTTP/`. |\n| `proxyUrl` | `string` | Non défini | URL du proxy pour les requêtes HTTP(S) (par exemple, `http://proxy.corp.example:3128`). Remplacée par les variables d’environnement `HTTP_PROXY` ou `HTTPS_PROXY` (quelle que soit la casse). |\n| `remote` | | | |\n| `\"on\"` | | | |\n| \\| | | | |\n| `\"off\"` | | | |\n| `\"on\"` | Contrôle la synchronisation de session et l’accès à distance. Réglez cette option sur `\"off\"` pour conserver les données de session uniquement en local et désactiver le contrôle distant. Peut également être défini avec `--remote` ou `--no-remote`. | | |\n| `renderHexColors` | `boolean` | `true` | Affichez des codes de couleur hexadécimaux à six chiffres écrits sous forme de code inline (par exemple `` `#FF0000` ``) en tant que nuances de couleurs. |\n| `renderMarkdown` | `boolean` | `true` | Affichez Markdown dans la sortie du terminal. |\n| `remoteExport` | `boolean` | `true` | Exportez des sessions à distance lorsque la synchronisation de session est disponible. Définir sur `false` pour refuser l’exportation à distance par défaut. Le paramètre `remoteSessions`, lorsqu’il est défini sur `true`, ou l’indicateur `--remote`, active toujours l’exportation et le pilotage, quel que soit ce paramètre. |\n| `respectGitignore` | `boolean` | `true` | Excluez les fichiers gitignored du `@` sélecteur de mentions de fichier. Quand `false`, le sélecteur inclut des fichiers normalement exclus par `.gitignore`. |\n| `sandbox.allowBypass` | `boolean` | `true` | Autoriser les commandes en bac à sable à demander un contournement pour des opérations spécifiques (affiche une invite d’autorisations) afin que les outils comme `grep` et `glob` continuent à fonctionner lorsque le bac à sable les bloque autrement. Définissez la valeur sur `false` pour vous désinscrire. |\n| `sandbox.enabled` | `boolean` | `false` | Limitez les commandes shell, les serveurs MCP/LSP et les outils de fichiers/web intégrés à un environnement en bac à sable avec un système de fichiers limité et un accès réseau. Activez-le à partir de la `/sandbox` boîte de dialogue ou avec `/sandbox enable`. |\n| `sandbox.auth.git` | `boolean` | `true` | Injectez des informations d’identification Git dans le bac à sable afin que les commandes s’exécutant à l’intérieur de celle-ci puissent s’authentifier auprès de Git. Définissez sur `false` pour vous désinscrire. Renommé depuis `sandbox.gitAuth` ; l’ancienne clé n’est pas migrée et est ignorée partout où elle apparaît encore. |\n| `sandbox.auth.gh` | `boolean` | `true` | Injectez les identifiants GitHub CLI (`gh`) dans le sandbox afin que les commandes qui y sont exécutées puissent s’authentifier auprès du GitHub CLI. Définissez sur `false` pour vous désinscrire. Renommé depuis `sandbox.ghAuth` ; l’ancienne clé n’est pas migrée et est ignorée partout où elle apparaît encore. |\n| `sandbox.userPolicy.network.allowLocalNetwork` | `boolean` | `true` | Autoriser les commandes en bac à sable à atteindre les adresses de réseau local (par exemple, les serveurs de développement locaux). Définissez la valeur sur `false` pour vous désinscrire. |\n| `sandbox.userPolicy.network.proxy` | `object` | Non défini | Faire passer le trafic réseau isolé via un proxy HTTP. Champs : `url` (obligatoire), `username` (facultatif), `password` (facultatif). Configurez-le depuis l’onglet **Réseau** de la boîte de dialogue `/sandbox`, qui masque le champ du mot de passe. Le mot de passe lui-même est stocké dans le trousseau du système d’exploitation plutôt que dans `settings.json`, il n’est donc pas modifiable via `/settings`. Sur Linux et macOS, le proxy est coopératif (pas strictement appliqué) ; Windows l’applique. |\n| `sandbox.userPolicy.deniedPaths` | `string[]` | `[]` | Chemins auxquels les commandes en bac à sable n’ont pas accès. Sous Windows, le backend de la sandbox ProcessContainer ne peut pas appliquer de règles de refus par chemin d’accès ; les entrées n’ont donc aucun effet. Par conséquent, ne comptez pas sur `deniedPaths` pour protéger un répertoire sensible sous Windows. |\n| `sandbox.userPolicy.seatbelt.keychainAccess` | `boolean` | `false` | macOS uniquement. Accorder aux commandes en bac à sable l’accès au trousseau système. Peut également être activé ou désactivé dans la boîte de dialogue `/sandbox`. |\n| `screenReader` | `boolean` | `false` | Activez les optimisations du lecteur d’écran. |\n| `scrollbar` | `boolean` | `true` | Affichez la barre de défilement en affichages défilants. Définissez cette option sur `false` pour la masquer et utiliser toute la largeur du terminal. |\n| `shellShortcut` | `boolean` | `true` | Permettre qu’un `$` seul à l’invite, suivi de Entrée, ouvre un shell interactif ayant pour racine le répertoire de travail de la session (s’active uniquement pour une session locale, approuvée et inactive sur un véritable TTY). Uniquement à l’étendue utilisateur ou managée — non substituable par le dépôt. |\n| `showTimestamps` | `boolean` | `true` | Afficher les horodatages `HH:mm` atténués à côté des messages des utilisateurs dans la chronologie. |\n| `showTipsOnStartup` | `boolean` | `true` | Afficher une astuce de commande aléatoire au démarrage du CLI. |\n| `skillDirectories` | `string[]` | `[]` | Répertoires supplémentaires pour rechercher des définitions de compétences personnalisées (en plus de `~/.copilot/skills/`). |\n| `statusLine` | `object` | — | Affichage de la ligne d’état personnalisée. |\n| `type`: doit être `\"command\"`. | | | |\n| `command`: chemin d’accès à un script exécutable qui reçoit le json de session sur stdin et imprime le contenu d’état sur stdout. | | | |\n| `padding` : nombre facultatif d’espaces de remplissage à gauche. | | | |\n| `refreshInterval` : nombre entier facultatif de secondes (`1`–`2147483`) pour réexécuter la commande à intervalles réguliers plutôt qu’uniquement lors d’événements ; omettez-la pour n’actualiser que lorsque l’état de la session change. Si la commande ne démarre pas, se termine avec un code différent de zéro ou ne reçoit pas le JSON d’état sur stdin, l’interface CLI journalise un avertissement une seule fois par épisode d’échec continu et laisse la ligne d’état vide au lieu d’échouer silencieusement. Exécutez avec `--log-level all` pour afficher les détails d’erreur sous-jacents. | | | |\n| `stayInAutopilot` | `boolean` | `true` | Restez en mode Autopilot une fois chaque tâche terminée. Lorsque cette option est activée, l’invite suivante que vous entrez une fois qu’une tâche est terminée est également gérée en mode Autopilot. Pour plus d’informations, consultez « [Autoriser GitHub Copilot CLI à fonctionner de manière autonome](/fr/copilot/concepts/agents/copilot-cli/autopilot#staying-in-autopilot-mode-between-tasks) ». |\n| `storeTokenPlaintext` | `boolean` | `false` | Autorisez la conservation des jetons d’authentification en clair dans `config.json` lorsqu’aucun trousseau système n’est accessible. |\n| `stream` | `boolean` | `true` | Activez les réponses de diffusion en continu. |\n| `streamerMode` | `boolean` | `false` | Masquer les noms de modèles en préversion, les détails de quota, les horodatages des invites et l’avis de mise à jour disponible. Utile lors de la démonstration Copilot CLI ou du partage d’écran. |\n| `subagents.agents` | `object` | `{}` | Configuration du modèle par agent, indexée par nom d’agent. Chaque valeur est un objet avec des champs facultatifs `model` (chaîne), `effortLevel` (chaîne) et `contextTier` (`\"default\"`, `\"long_context\"`ou `\"inherit\"`) . Définissez n’importe quel champ sur `\"inherit\"` pour utiliser la valeur de la session parente au moment de l’envoi. Utilisez la `/subagents` commande barre oblique pour configurer ces paramètres de manière interactive. |\n| `subagents.disabledSubagents` | `string[]` | `[]` | Liste des noms d’agents à empêcher d’être exécutés. Seul l’agent `rubber-duck` ne peut pas être désactivé via ce paramètre. Tous les autres agents intégrés( y compris `explore`, , `task`, `code-review``general-purpose`, `research`et `security-review`) peuvent être désactivés. |\n| `subagents.maxConcurrency` | `number` | basé sur un plan | Nombre maximal de sous-agents simultanés pour cette session. Pris en compte uniquement pour les utilisateurs facturés à l’usage ; ignoré pour tous les autres forfaits. Plafonné à `32`. Consultez « [Référence de commande CLI pour GitHub Copilot](/fr/copilot/reference/copilot-cli-reference/cli-command-reference#subagent-limits) ». |\n| `subagents.maxDepth` | `number` | `6` | Profondeur maximale d’imbrication des sous-agents. Pris en compte uniquement pour les utilisateurs facturés à l’usage ; ignoré pour tous les autres forfaits. Plafonné à `256`. Consultez « [Référence de commande CLI pour GitHub Copilot](/fr/copilot/reference/copilot-cli-reference/cli-command-reference#subagent-limits) ». |\n| `tabs.enabled` | `boolean` | `true` | Affichez la barre d’onglets d’accueil. Définissez-le sur `false` pour le masquer entièrement. |\n| `tabs.hide` | `string[]` | `[]` | Identificateurs d’onglet à masquer. Valeurs acceptées : `\"copilot\"`, `\"agents\"`, `\"issues\"`, `\"pull-requests\"`, `\"gists\"` (insensible à la casse). |\n| `tabs.sort` | `string[]` | `[]` | Ordre dans lequel les onglets sont affichés. Les onglets non répertoriés conservent leur ordre relatif par défaut après les onglets répertoriés. Les identificateurs inconnus sont ignorés. |\n| `terminalProgress` | `boolean` | `true` | Émettre des indicateurs de progression de terminal OSC 9;4 pendant que l’agent travaille. Les terminaux pris en charge incluent Terminal Windows, iTerm2, Ghostty et ConEmu. |\n| `theme` | | | |\n| `\"default\"` | | | |\n| \\| | | | |\n| `\"github\"` | | | |\n| \\| | | | |\n| `\"dim\"` | | | |\n| \\| | | | |\n| `\"high-contrast\"` | | | |\n| \\| | | | |\n| `\"colorblind\"` | | | |\n| `\"github\"` | Palette de couleurs pour la sortie du terminal. Géré par les commandes `/settings` et `/theme` slash. | | |\n| `colorMode` est un alias déconseillé pour ce paramètre. | | | |\n| `toolSearch` | `boolean` | en fonction du modèle et des fonctionnalités | Contrôle la recherche d’outils (chargement différé des outils). Définissez `toolSearch: false` pour désactiver la recherche d’outils. |\n| `updateTerminalTitle` | `boolean` | `true` | Afficher l’intention actuelle dans l’onglet terminal ou le titre de la fenêtre. |\n| `worktreeBaseRef` | | | |\n| `\"head\"` | | | |\n| \\| | | | |\n| `\"defaultBranch\"` | | | |\n| `\"head\"` | Point de départ pour les nouvelles arborescences de travail créées par `/worktree`, `/worktree new`et `--worktree`. `\"defaultBranch\"` démarre à partir de la branche par défaut distante plutôt que de l’extraction actuelle. | | |\n\n> \\[!TIP]\n> Exécutez `copilot help sandbox` pour obtenir la référence complète du bac à sable, y compris les hôtes pris en charge et toutes les clés de paramètres `sandbox`.\n\nLa boîte de dialogue `/sandbox` regroupe `git`, `gh` et l’accès au trousseau sous un onglet **Auth** dédié, et affiche le chemin `settings.json` où est stockée la configuration actuelle du sandbox. Appuyez sur Ctrl+E dans la `/sandbox` boîte de dialogue pour enregistrer les modifications en attente et ouvrir `settings.json` dans votre éditeur (`COPILOT_EDITOR`, `VISUAL`ou `EDITOR`), correspondant au même raccourci dans `/settings`. La boîte de dialogue recharge son état à partir du disque après avoir modifié et enregistré le fichier.\n\nLa mise en bac à sable est assurée par [Microsoft eXecution Container (MXC)](https://github.com/microsoft/mxc), qui fournit des back-ends de confinement propres à chaque plateforme.\nCopilot CLIutilise la ceinture de sécurité sur macOS, Bubblewrap sur Linux et ProcessContainer sur Windows.\n\n### Paramètres du référentiel (`.github/copilot/settings.json`)\n\nLes paramètres du référentiel s’appliquent à tous ceux qui travaillent dans le référentiel. Ils sont commités dans le référentiel et partagés avec les collaborateurs.\n\n> \\[!NOTE]\n> Les clés liées au plug-in dans le fichier de configuration du référentiel (`enabledPlugins` et `extraKnownMarketplaces`) sont également lues par Copilot cloud agent, pas seulement Copilot CLI. Cela vous permet d’activer les mêmes plug-ins pour les deux clients à partir d’un seul fichier. Pour plus d’informations sur les plug-ins, consultez [À propos des GitHub Copilot plug-ins](/fr/copilot/concepts/agents/about-plugins).\n\nSeules les clés répertoriées dans le tableau suivant sont prises en charge au niveau du référentiel. Toutes les autres clés, y compris les clés valides dans le fichier de configuration utilisateur, sont ignorées en mode silencieux. Chaque clé prise en charge possède une stratégie de fusion directionnelle qui maintient la substitution dans un état fail-closed et sécurisé.\n\n| Clé | Type | Comportement de la fusion | Description |\n| ----------------------------------------- | -------------------------------------------------------------- | ------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |\n| `companyAnnouncements` | `string[]` | Remplacé : le référentiel est prioritaire | Messages affichés de manière aléatoire au démarrage. |\n| `contextTier` | | | |\n| `\"default\"` | | | |\n| \\| | | | |\n| `\"long_context\"` | | | |\n| Remplacé : le référentiel est prioritaire | Épingler le niveau de contexte par défaut. | | |\n| `deniedUrls` | `string[]` | Union : le référentiel peut ajouter des entrées, mais jamais en supprimer | URL ou domaines bloqués. |\n| `disableAllHooks` | `boolean` | Le référentiel est prioritaire | Désactivez tous les crochets. |\n| `disabledMcpServers` | `string[]` | Union : le référentiel peut ajouter des entrées, mais jamais en supprimer | Serveurs MCP configurés, mais pas démarrés. |\n| `disabledSkills` | `string[]` | Union : le référentiel peut ajouter des entrées, mais jamais en supprimer | Compétences découvertes mais non chargées. |\n| `effortLevel` | `string` | Remplacé : le référentiel est prioritaire | Fixez l’effort de raisonnement par défaut. |\n| `enabledPlugins` | `Record` | Fusionné : le référentiel supplante l’utilisateur pour la même clé | Installation automatique du plug-in déclaratif. |\n| `extraKnownMarketplaces` | `Record` | Fusionné : le référentiel supplante l’utilisateur pour la même clé | Les places de marché de plug-in disponibles dans ce référentiel. Le champ `source` est requis pour chaque entrée. Le paramètre `autoUpdate: true` d’une entrée est accepté au niveau du référentiel, mais il est actuellement ignoré : l’activation des mises à jour automatiques n’est prise en compte que lorsqu’elle est définie dans les paramètres de l’utilisateur lui-même ou dans les paramètres gérés (MDM/serveur). |\n| `hooks` | `object` | Fusionné : le référentiel supplante l’utilisateur pour la même clé | Définitions de hooks limitées à ce référentiel. Consultez « [Utilisation de crochets avec GitHub Copilot CLI](/fr/copilot/how-tos/copilot-cli/customize-copilot/use-hooks) ». |\n| `includeCoAuthoredBy` | `boolean` | Remplacé : le référentiel est prioritaire | Ajouter une bande-annonce `Co-authored-by` aux commits. |\n| `mergeStrategy` | | | |\n| `\"rebase\"` | | | |\n| \\| | | | |\n| `\"merge\"` | | | |\n| Remplacé : le référentiel est prioritaire | Stratégie de résolution des conflits pour `/pr fix conflicts`. | | |\n| `model` | `string` | Remplacé : le référentiel est prioritaire | Épingler le modèle par défaut pour ce dépôt. |\n| `respectGitignore` | `boolean` | Renforcement uniquement — le dépôt peut activer, jamais désactiver | Excluez les fichiers gitignored du `@` sélecteur de mentions de fichier. |\n\nLes substitutions `model`, `effortLevel` et `contextTier` s’appliquent uniquement lorsque le répertoire de travail est [approuvé](/fr/copilot/how-tos/copilot-cli/use-copilot-cli/allowing-tools).\n\nUn plug-in activé uniquement par le biais de ce `enabledPlugins` référentiel est limité à ce référentiel : il installe et s’active automatiquement dans le référentiel déclarant, mais reste désactivé globalement, de sorte qu’il n’est jamais activé dans des projets non liés. Lorsque vous quittez le dépôt, ou que le dépôt désactive le plugin, son serveur MCP s’arrête et ses agents ainsi que ses compétences sont désactivés pour la session.\n\n### Liste d’autorisation des modèles au niveau du dépôt (`.github/allowed_models.txt`)\n\nLimitez les modèles intégrés qu’un dépôt est autorisé à utiliser à l’aide d’une liste d’autorisation en texte brut dans `.github/allowed_models.txt`, située à la racine du dépôt correspondant au répertoire de travail actuel (ou dans le répertoire de travail lui-même en dehors d’un dépôt).\n\nChaque ligne est un modèle glob comparé aux ID de modèle, ou une directive `fallback:` nommant le modèle à utiliser lorsque le modèle configuré ou demandé n’est pas autorisé :\n\n```text\n# .github/allowed_models.txt\nfallback: gpt-5.2\ngpt-5.2\ngpt-5.4\nclaude-sonnet-*\n```\n\n| Rule | Description |\n| -------------------- | ------------------------------------------------------------------------------------------------------ |\n| `*` | Autoriser tous les modèles (par défaut lorsqu’aucun fichier n’est présent). |\n| `MODEL-ID` | Autoriser un ID de modèle précis. |\n| `GLOB-PATTERN` | Autoriser les identifiants de modèle qui correspondent au motif glob (par exemple, `claude-sonnet-*`). |\n| `fallback: MODEL-ID` | Requis exactement une fois. Le modèle Copilot utilise lorsque le modèle actif n’est pas autorisé. |\n| `#` | Ligne de commentaire. |\n\nLes modèles négatifs (`!pattern`) ne sont pas pris en charge, le modèle de secours doit être un ID exact (et non un glob) et il doit lui-même correspondre à l’un des globs configurés.\nCopilot CLI réévalue la stratégie sur `/cd` et rejette un fichier non valide avec une erreur avant l’exécution.\n\nLa liste d’autorisation ne concerne que les modèles intégrés de Copilot. Il ne peut pas filtrer les modèles personnalisés ajoutés à l’aide de la méthode BYOK (Bring Your Own API Keys). Les modèles BYOK restent répertoriés et sélectionnables, quels que soient les modèles que vous configurez, et la `fallback:` directive ne s’applique jamais à ces modèles. Pour plus d’informations, consultez « [Activation de modèles personnalisés pour GitHub Copilot dans votre entreprise](/fr/copilot/how-tos/administer-copilot/manage-for-enterprise/enable-custom-models) » et « [Activation de modèles personnalisés pour GitHub Copilot dans votre organisation](/fr/copilot/how-tos/administer-copilot/manage-for-organization/enable-custom-models) ».\n\n### Paramètres locaux (`.github/copilot/settings.local.json`)\n\nCréez `.github/copilot/settings.local.json` dans le dépôt, pour les remplacements personnels qui ne doivent pas être validés. Ajoutez ce fichier à `.gitignore`.\n\nLe fichier de configuration local utilise le même schéma que le fichier de configuration du référentiel (`.github/copilot/settings.json`) et est prioritaire sur celui-ci.\n\n## Paramètres gérés par MDM\n\nLes administrateurs informatiques peuvent déployer une stratégie de référence à l’aide des paramètres gérés par la gestion des appareils mobiles (MDM), au lieu d’exiger une configuration pour chaque utilisateur. Ces paramètres définissent les valeurs par défaut au niveau de l’appareil pour les clés prises en charge et sont chargés avant les paramètres utilisateur.\n\nCopilot CLI charge également les paramètres gérés par le serveur au démarrage, en plus de MDM. Les paramètres gérés par l’appareil (MDM) et par le serveur sont appliqués **par clé** : la valeur de MDM prévaut pour toute clé qu’il définit, et la valeur du serveur complète les clés que MDM laisse non définies. Cela permet à une organisation de définir une stratégie via mdm (par exemple) `permissions`tout en recevant d’autres valeurs par défaut managées (par exemple, `model`) à partir du serveur.\n\nLes sessions de longue durée récupèrent et réappliquent les paramètres managés toutes les heures, de sorte que les modifications de stratégie (par exemple, une organisation qui l’active `permissions.disableBypassPermissionsMode`) prennent effet sans redémarrer la session.\n\n### Sources des paramètres gérés par MDM\n\nCopilot CLI lit les paramètres gérés depuis des emplacements MDM propres à la plate-forme ou basés sur des fichiers.\n\n| Platform | Type de source | Location |\n| -------- | -------------- | ------------------------------------------------------------------ |\n| macOS | MDM plist | `com.github.copilot` |\n| macOS | Fichier | `/Library/Application Support/GitHubCopilot/managed-settings.json` |\n| Windows | Registre MDM | `HKLM\\SOFTWARE\\Policies\\GitHubCopilot` |\n| Windows | Fichier | `%ProgramFiles%\\GitHubCopilot\\managed-settings.json` |\n| Linux | Fichier | `/etc/github-copilot/managed-settings.json` |\n\n> \\[!NOTE]\n> Sur les systèmes POSIX, Copilot CLI rejette les paramètres gérés stockés dans des fichiers qui sont des liens symboliques, qui n’appartiennent pas à root ou qui sont accessibles en écriture à tous.\n\n### Format de fichier\n\nÉcrire des paramètres managés basés sur des fichiers en tant que JSON.\n\n```json\n{\n \"model\": \"auto\",\n \"permissions\": {\n \"disableBypassPermissionsMode\": \"disable\"\n }\n}\n```\n\n> \\[!NOTE]\n> `model` est une clé de niveau supérieur. Les configurations plus anciennes qui l’ont imbriquée comme `permissions.model` fonctionnent toujours , le runtime revient à cet emplacement lorsque la clé de niveau `model` supérieur est absente, mais écrivez de nouvelles configurations avec `model` au niveau supérieur.\n\n### Clés prises en charge\n\nSeules les clés suivantes sont prises en charge dans les paramètres managés MDM.\n\n| Clé | Description |\n| ----------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |\n| `allowedMcpServers` | Liste verte des serveurs MCP que les utilisateurs peuvent charger, comparés par `serverUrl`, `serverCommand` ou `serverName`. Les serveurs internes approuvés (par exemple, le serveur MCP intégré GitHub ) sont toujours exemptés. Le fait de laisser cette clé non définie autorise tous les serveurs non par défaut ; un tableau vide les refuse tous. Consultez la [liste d’autorisation/refus du serveur MCP managé](#managed-mcp-server-allowdeny-list). |\n| `deniedMcpServers` | Liste de refus des serveurs MCP qui ne doivent jamais être chargés, avec la même méthode de comparaison que `allowedMcpServers`. Un serveur non défini par défaut correspondant est bloqué quelle que soit la liste d’autorisation : le refus l’emporte toujours. Consultez la [liste d’autorisation/refus du serveur MCP managé](#managed-mcp-server-allowdeny-list). |\n| `enabledPlugins` | Activer ou désactiver des plug-ins spécifiques |\n| `extraKnownMarketplaces` | Ajouter des places de marché de plug-in approuvées |\n| `forceRemoteSettingsRefresh` | Exiger une nouvelle récupération des paramètres gérés par le serveur au démarrage, même lorsqu’une stratégie mise en cache récente existe. L’entrée mise en cache est toujours conservée en tant que secours si la récupération échoue. La valeur de l’appareil (MDM) prévaut sur une valeur du serveur mise en cache. |\n| `model` | Définir un modèle par défaut pour tous les utilisateurs (remplacé par l’indicateur `--model` ou un modèle de session repris) |\n| `permissions` | Définissez des autorisations gérées, y compris `disableBypassPermissionsMode` et `deny` / `ask` / `allow` tableaux de règles. Consultez [les règles d’autorisation managée](#managed-permission-rules). |\n| `policyHelper` | Inscrivez un exécutable qui fournit la couche de paramètres managés de priorité la plus basse. Champs : `path` (obligatoire), plus facultatif `args`, `timeoutMs`et `refreshIntervalMs`. Si une stratégie d’appareil (MDM) et une stratégie de serveur inscrivent toutes deux un `policyHelper`, l’inscription de l’appareil prévaut. |\n| `remoteControl` | Déterminez si les sessions sur cet appareil peuvent être contrôlées à partir d’autres appareils. |\n| `mode` est `\"enabled\"`, `\"disabled\"`ou `\"requireSSO\"` (nécessite `githubDotComOrganizations` quand défini). | |\n| `shellShortcut` | Forcer l’activation ou forcer la désactivation du `$` raccourci d’interpréteur de commandes interactif pour tous les utilisateurs. Une valeur managée remplace toujours le propre `shellShortcut` paramètre de l’utilisateur. |\n| `strictKnownMarketplaces` | Restreindre les plug-ins aux places de marché connues |\n| `telemetry` | Envoyer la configuration d’export OpenTelemetry de référence : `enabled`, `endpoint`, `protocol`, `headers`, `resourceAttributes`, `captureContent`, `lockCaptureContent` et `serviceName`. Consultez « [Référence de commande CLI pour GitHub Copilot](/fr/copilot/reference/copilot-cli-reference/cli-command-reference#opentelemetry-monitoring) ». |\n\n> \\[!NOTE]\n> `policyHelper.path` accepte un chemin absolu, un chemin relatif au répertoire personnel (`~/...`) ou un simple nom de programme résolu depuis `PATH`. D’autres formulaires relatifs sont rejetés. L’inscription est acceptée et validée, mais le runtime n’appelle pas encore l’assistant — son exécution sera livrée dans une version ultérieure.\n\n> \\[!NOTE]\n> Lorsque `remoteControl.mode` est `\"requireSSO\"`, listez les organisations autorisées dans `remoteControl.githubDotComOrganizations`. Le client doit être autorisé pour l’authentification unique (SSO) pour au moins une organisation répertoriée GitHub.com ; il n’a plus besoin de l’être pour toutes.\n\n> \\[!NOTE]\n> Définissez `\"disable\"` sur `permissions.disableBypassPermissionsMode` dans les paramètres gérés par MDM pour appliquer la restriction au niveau de l’appareil. Les changements de compte ne peuvent pas outrepasser cette stratégie. Définissez-le sur `\"allow-auto-only\"` pour bloquer l’escalade vers l’autorisation complète tout en permettant `/permissions assisted` (approbation des autorisations assistée par LLM). Si une valeur non reconnue est définie, la CLI consigne le problème et impose `\"disable\"` comme valeur par défaut de fermeture en cas d’échec, de sorte qu’une stratégie gérée mal formée restreint toujours les options « allow-all » au lieu de les autoriser silencieusement. Consultez « [Référence de commande CLI pour GitHub Copilot](/fr/copilot/reference/copilot-cli-reference/cli-command-reference#restricting-the---allow-all-options) ».\n\n> \\[!NOTE]\n> La plupart des clés gérées verrouillent la ligne entière : une modification locale est remplacée en mode silencieux par la valeur gérée lors de la charge suivante.\n> `enabledPlugins` et `extraKnownMarketplaces` sont l’exception : la couche managée fusionne ces mappages avec vos propres entrées champ par champ au lieu de les remplacer directement. Cela signifie que le verrou s’applique **par entrée**, et non à l’ensemble de la clé : un plug-in ou une place de marché épinglé par une stratégie gérée ne peut pas être réactivé, désactivé ou repointé localement, mais d’autres entrées dans la même carte restent entièrement contrôlées par l’utilisateur.\n\n### Règles d’autorisation managée\n\nDéfinissez les listes de règles `deny`, `ask` et `allow` sous la clé gérée `permissions` pour imposer une stratégie d’autorisation pour tous les utilisateurs, indépendamment de `permissions.disableBypassPermissionsMode`.\n\n```json\n{\n \"permissions\": {\n \"deny\": [\"Shell(rm -rf *)\", \"Domain(*.evil.example)\"],\n \"ask\": [\"Shell(git push *)\"],\n \"allow\": [\"Read(**)\"]\n }\n}\n```\n\n| Famille de règles | Correspondances |\n| ------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |\n| `Bash(...)`, `Shell(...)` | Commandes shell. Utilisez ` *` (par exemple) `git push *`pour faire correspondre un préfixe de commande ; sinon, la règle correspond au texte exact. |\n| `PowerShell(...)` | Commandes PowerShell, mises en correspondance de la même façon que `Shell(...)`. |\n| `Read(...)` | Chemins d’accès de lecture/affichage des fichiers. Prend en charge les modèles glob : `/` pour la racine de l’espace de travail, `~/` pour le répertoire de base et `./` pour le répertoire de travail actif. |\n| `Edit(...)`, `Write(...)` | Chemins d’accès d’écriture/de modification de fichier, mis en correspondance de la même façon que `Read(...)`. |\n| `Domain(...)` | Noms d’hôte d’URL, mis en correspondance de la même manière que [les règles d’URL](/fr/copilot/reference/copilot-cli-reference/cli-command-reference#tool-permission-patterns). |\n\nLes règles sont combinées entre les sources gérées selon un ordre de priorité fixe : le refus l’emporte toujours, puis vient la demande, puis l’autorisation — une correspondance avec une règle `deny` bloque la requête même si une règle `allow` correspond également.\n`deny` et `ask` sont syndiqués sur chaque source managée (serveur, GPM). `allow` exige que chaque source qui déclare une liste `allow` autorise l’opération — il s’agit d’une intersection, pas d’une union. Lorsque l’un de `deny`, `ask` ou `allow` est défini, une opération qui ne correspond à aucun d’eux est définie par défaut sur `ask` au lieu d’être ignorée sans rien signaler.\n\n## Liste d’autorisation/refus du serveur MCP managé\n\nLes administrateurs peuvent gérer directement les serveurs MCP via les paramètres gérés par MDM, indépendamment de la [liste d’autorisation MCP de l’entreprise](/fr/copilot/reference/copilot-cli-reference/cli-command-reference#enterprise-mcp-allowlist).\n\nDéfinissez `allowedMcpServers` et/ou `deniedMcpServers` dans une source de paramètres managés :\n\n```json\n{\n \"allowedMcpServers\": [\n { \"serverUrl\": \"https://mcp.example.com/*\" },\n { \"serverCommand\": [\"npx\", \"-y\", \"@example/mcp-server\"] }\n ],\n \"deniedMcpServers\": [\n { \"serverName\": \"untrusted-server\" }\n ]\n}\n```\n\nChaque entrée identifie un serveur à l’aide d’un seul des critères de correspondance suivants.\n\n| Matcher | Correspondances | Remarques |\n| --------------- | ----------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |\n| `serverUrl` | Un serveur distant (HTTP/SSE) par URL | Prend en charge les caractères génériques `*` ; le schéma et l’hôte sont comparés sans respect de la casse, le chemin avec respect de la casse. Les références `${VAR}` sont développées avant la comparaison. |\n| `serverCommand` | Serveur stdio identifié par sa commande exacte et ses arguments, dans l’ordre | Les références `${VAR}` sont développées avant la comparaison. |\n| `serverName` | Un serveur selon son libellé attribué | Les entrées de la liste d’autorisation sont limitées à `[A-Za-z0-9_-]+` (aucun joker); les entrées de la liste de refus acceptent toute chaîne non vide. |\n\nRèglement:\n\n* **Les serveurs internes** approuvés (par exemple, le serveur MCP intégré GitHub ) sont toujours exemptés des deux listes.\n* **Unset `allowedMcpServers`** autorise tous les serveurs non par défaut ; un **tableau vide** les bloque tous (deny-all).\n* **Non défini ou vide `deniedMcpServers`** ne bloque rien.\n* **Le refus l’emporte toujours**—un serveur correspondant à `deniedMcpServers` est bloqué même s’il correspond aussi à `allowedMcpServers`.\n* Pour les serveurs distants, une correspondance doit provenir d’une `serverUrl` entrée ; `serverName` compte uniquement lorsqu’aucune entrée n’existe `serverUrl` . Pour les serveurs stdio, une correspondance doit provenir d’une `serverCommand` entrée ; `serverName` compte uniquement lorsqu’aucune entrée n’existe `serverCommand` .\n\n## Lectures complémentaires\n\n* [GitHub Copilot CLI](/fr/copilot/how-tos/copilot-cli)\n* [Référence de commande CLI pour GitHub Copilot](/fr/copilot/reference/copilot-cli-reference/cli-command-reference)\n* [référence programmatique du CLI GitHub Copilot](/fr/copilot/reference/copilot-cli-reference/cli-programmatic-reference)\n* [Référence du plug-in CLI GitHub Copilot](/fr/copilot/reference/copilot-cli-reference/cli-plugin-reference)\n* [Références sur les hooks GitHub Copilot](/fr/copilot/reference/hooks-reference)"}