Skip to main content

Modification des paramètres avec la /settings commande

Affichez et modifiez vos paramètres personnels pour CLI GitHub Copilot à l’aide de la commande slash /settings.

Vous pouvez utiliser la /settings commande de barre oblique pour afficher et modifier vos paramètres à partir d’une session CLI interactive. Cette commande gère les paramètres propres à l’utilisateur, comme le fait de savoir si Copilot pour CLI se met à jour automatiquement, la palette de couleurs utilisée par l’interface, ce qui s’affiche dans le pied de page et de nombreuses autres options.

Utiliser /settings pour :

  • Parcourez et modifiez les paramètres de manière interactive : exécutez-le/settings de manière autonome pour ouvrir un éditeur pouvant faire l’objet d’une recherche qui répertorie chaque paramètre avec une description et sa valeur actuelle.
  • Modifier un paramètre avec une seule commande : exécutez /settings KEY VALUE pour modifier un paramètre particulier sans ouvrir l’éditeur.
  • Vérifiez la valeur d’un paramètre : Exécutez /settings show KEY pour afficher la valeur actuelle d’un paramètre.

Vous pouvez également utiliser /config, qui est un alias de /settings.

Les modifications que vous apportez /settings ou /config sont écrites dans votre fichier de paramètres personnels (par défaut ~/.copilot/settings.json) et persistent entre les sessions.

Ouverture de l’éditeur de paramètres

Pour parcourir et modifier les paramètres de manière interactive, entrez la commande de barre oblique sans argument :

Copilot prompt
/settings

L’éditeur répertorie chaque paramètre que vous pouvez modifier et la valeur actuelle du paramètre. Lorsque vous passez vers le haut ou le bas de la liste, une brève description du paramètre mis en surbrillance s’affiche en bas de l’éditeur. Cela vous permet de parcourir et de modifier les paramètres sans avoir à connaître leurs noms exacts.

Pour plus d’informations sur les paramètres disponibles, consultez GitHub Copilot le répertoire de configuration du CLI.

Pendant que l’éditeur est ouvert, vous pouvez utiliser les raccourcis clavier suivants :

KeyAction
/ Passer d’un paramètre à l’autre.
/Recherchez et filtrez la liste en fonction du nom ou de la description d’un paramètre.
SaisissezBasculez un paramètre booléen ou modifiez d’autres types de valeurs.
Ctrl+RRéinitialisez le paramètre mis en surbrillance à sa valeur par défaut.
Ctrl+EOuvrez settings.json dans votre éditeur de terminal configuré pour apporter des modifications avancées.
ÉchapEffacez la recherche actuelle ou fermez l’éditeur.

La plupart des modifications prennent effet immédiatement , par exemple, le changement de palette de couleurs met à jour l’interface dès que vous sélectionnez une nouvelle valeur.

Modifier un seul paramètre en ligne

Si vous connaissez déjà le paramètre que vous souhaitez modifier, vous pouvez le définir directement à partir de la zone d’invite de l’interface CLI, sans ouvrir l’éditeur :

/settings KEY VALUE

Par exemple:

Copilot prompt
/settings autoUpdate off

Copilot écrit la valeur et la confirme, par exemple : Set autoUpdate = false.

Remarque

* Les paramètres booléens acceptent on/off ou .true/false Par exemple : /settings renderMarkdown on. * Les paramètres avec un ensemble fixe de choix acceptent l’une de ces valeurs. Par exemple, /settings theme dim ou /settings banner never. * Les paramètres imbriqués utilisent un chemin en pointillés. Par exemple, /settings footer.showBranch off masque la branche Git dans le pied de page.

Vous pouvez configurer des paramètres qui prennent des valeurs définies sans avoir à mémoriser la clé ou la valeur exacte, simplement en utilisant les touches de navigation et d’entrée . Par exemple, pour empêcher l’agent de poser des questions de clarification :

  1. Tapez /settings, sans appuyer sur Entrée, pour afficher une liste d’options.

  2. Utilisez la touche pour descendre dans la liste jusqu’à ce que indique /settings askUser Allow the agent to ask clarifying questions, puis appuyez sur Entrée.

  3. Utilisez la touche pour descendre dans la liste des options pour ce paramètre jusqu’à ce que pointe vers /settings askUser off, puis appuyez sur Entrée.

  4. Appuyez de nouveau sur Entrée pour envoyer la /settings askUser off commande.

    L’interface CLI confirme la modification : Set askUser = false.

Affichage des valeurs valides pour un paramètre

Pour afficher les valeurs valides disponibles pour un paramètre, entrez /settings KEY sans valeur. Par exemple, pour afficher les valeurs valides pour theme:

Copilot prompt
/settings theme

Affichage de la valeur actuelle d’un paramètre

Pour afficher la valeur actuelle d’un paramètre, utilisez show. Par exemple:

Copilot prompt
/settings show theme

Cette opération génère une ligne telle que theme = high-contrast. Le show formulaire est utile pour vérifier rapidement une valeur ou enregistrer des paramètres dans les journaux.

Modification des paramètres nécessitant un redémarrage

La plupart des paramètres s’appliquent immédiatement, mais quelques-uns ne prennent pleinement effet qu’après Copilot pour CLI redémarrage, par exemple experimental et les paramètres du proxy. Lorsque vous modifiez l’un de ces éléments, Copilot vous indique qu’un redémarrage est nécessaire et peut redémarrer la session pour vous.

Paramètres que vous ne pouvez pas modifier à partir de la ligne de commande

Tous les paramètres ne peuvent pas être modifiés par le biais de la méthode inline /settings KEY VALUE :

  • Les paramètres sensibles à la sécurité, tels que ceux qui modifient la façon dont les informations d’identification sont stockées ou qui exécutent une commande shell, sont délibérément exclus, car le fait de les glisser dans une seule ligne sans confirmation n’est risqué.
  • Les paramètres de liste et structurés ne peuvent pas être définis en ligne. Entrez puis appuyez /settingssur Ctrl+E pour ouvrir settings.json dans l’éditeur de terminal configuré, puis modifiez le paramètre.
  • Les paramètres gérés par votre référentiel ou votre organisation sont affichés pour référence, mais leurs valeurs proviennent de ces sources et remplacent votre valeur personnelle. La modification des paramètres utilisateur n’a aucun effet.

Dans chacun de ces cas, Copilot explique pourquoi le changement n’a pas été appliqué et vous pointe vers le bon endroit pour le faire.

Commandes remplacées par /settings

Certaines anciennes commandes slash ont été intégrées à /settings. Ils fonctionnent toujours, mais affichent une notification vous informant de la commande équivalente /settings .

Paramètres que vous souhaiterez peut-être modifier

Voici quelques paramètres couramment utilisés :

  • autoUpdate : téléchargez automatiquement les versions de l’interface CLI mises à jour.
  • theme— Palette de couleurs (default, , github``dim, high-contrastou colorblind).
  • renderMarkdown — Render Markdown dans le terminal.
  • banner — Fréquence à laquelle afficher la bannière de démarrage (always, onceou never).
  • beep — Bip lorsque Copilot requiert votre attention.
  • includeCoAuthoredBy — Ajouter un Co-authored-by trailer aux commits.
  • footer.showBranch — Afficher la branche Git actuelle dans le pied de page.

Pour obtenir la liste complète des paramètres disponibles et la façon dont les paramètres utilisateur, référentiel et organisation se combinent, consultez GitHub Copilot le répertoire de configuration du CLI.

Lectures complémentaires