Ändern von Einstellungen mit dem /settings Befehl

Zeigen und ändern Sie Ihre persönlichen Einstellungen für GitHub Copilot-CLI mit dem /settings Slash-Befehl.

In diesem Artikel

Sie können den /settings Schrägstrichbefehl verwenden, um Ihre Einstellungen in einer interaktiven CLI-Sitzung anzuzeigen und zu ändern. Dieser Befehl steuert Einstellungen auf Benutzerebene, z. B. ob Copilot CLI sich automatisch aktualisiert, welche Farbpalette die Schnittstelle verwendet, was in der Fußzeile angezeigt wird, und viele andere Optionen.

Verwenden Sie /settings, um:

  • Interaktives Durchsuchen und Bearbeiten von Einstellungen – Führen Sie /settings eigenständig aus, um einen durchsuchbaren Editor zu öffnen, der jede Einstellung mit einer Beschreibung und ihrem aktuellen Wert auflistet.
  • Ändern Sie eine Einstellung mit einem einzelnen Befehl – Ausführen /settings KEY VALUE , um eine bestimmte Einstellung zu ändern, ohne den Editor zu öffnen.
  • Überprüfen Sie den Wert einer Einstellung – Ausführen /settings show KEY , um den aktuellen Wert einer Einstellung anzuzeigen.

Sie können auch /config verwenden, das ein Alias für /settings ist.

Änderungen, die Sie mit /settings oder /config vornehmen, werden in Ihre persönliche Einstellungsdatei geschrieben (standardmäßig ~/.copilot/settings.json) und bleiben sitzungsübergreifend erhalten.

Öffnen des Einstellungs-Editors

Um Einstellungen interaktiv zu durchsuchen und zu bearbeiten, geben Sie den Schrägstrichbefehl ohne Argumente ein:

Copilot prompt
/settings

Der Editor listet jede Einstellung auf, die Sie ändern können, und den aktuellen Wert der Einstellung. Wenn Sie in der Liste nach oben oder unten navigieren, wird unten im Editor eine kurze Beschreibung der hervorgehobenen Einstellung angezeigt. Auf diese Weise können Sie Einstellungen durchsuchen und bearbeiten, ohne ihre genauen Namen kennen zu müssen.

Weitere Informationen zu den verfügbaren Einstellungen finden Sie unter GitHub Copilot CLI-Konfigurationsverzeichnis.

Während der Editor geöffnet ist, können Sie die folgenden Tastenkombinationen verwenden:

KeyAction
↑ / ↓Wechseln zwischen Einstellungen.
/Suchen und filtern Sie die Liste nach dem Namen oder der Beschreibung einer Einstellung.
eingebenSchalten Sie eine boolesche Einstellung um, oder bearbeiten Sie andere Wertetypen.
STRG+RSetzen Sie die hervorgehobene Einstellung auf die Standardeinstellung zurück.
Strg+EÖffnen Sie settings.json in Ihrem konfigurierten Terminal-Editor, um erweiterte Änderungen vorzunehmen.
ESCLöschen Sie die aktuelle Suche, oder schließen Sie den Editor.

Die meisten Änderungen werden sofort wirksam, z. B. wenn Sie die Farbpalette wechseln, wird die Schnittstelle aktualisiert, sobald Sie einen neuen Wert auswählen.

Ändern einer einzelnen Einstellung inline

Wenn Sie bereits wissen, welche Einstellung Sie ändern möchten, können Sie sie direkt über das Eingabeaufforderungsfeld der CLI festlegen, ohne den Editor zu öffnen:

/settings KEY VALUE

Beispiel:

Copilot prompt
/settings autoUpdate off

Copilot schreibt den Wert und bestätigt ihn, z. B.: Set autoUpdate = false.

Hinweis

* Boolesche Einstellungen akzeptieren on/off oder true/false. Beispiel: /settings renderMarkdown on * Einstellungen mit einem festen Satz von Auswahlmöglichkeiten akzeptieren einen dieser Werte. Zum Beispiel: /settings theme dim oder /settings banner never. * Geschachtelte Einstellungen verwenden einen gepunkteten Pfad. Blendet /settings footer.showBranch off beispielsweise den Git-Zweig in der Fußzeile aus.

Sie können Einstellungen konfigurieren, die festgelegte Werte annehmen, ohne sich den genauen Schlüssel oder Wert merken zu müssen, indem Sie nur die Navigations- und EINGABEtasten verwenden. Um beispielsweise zu verhindern, dass der Agent Klarstellungsfragen stellt:

  1. Geben Sie /settings ein, ohne die EINGABETASTE zu drücken, um eine Liste von Optionen anzuzeigen.

  2. Verwenden Sie die Taste ↓, um sich in der Liste nach unten zu bewegen, bis ❯ auf /settings askUser Allow the agent to ask clarifying questions zeigt. Drücken Sie dann Enter.

  3. Verwenden Sie die Taste ↓, um in der Liste der Optionen für diese Einstellung nach unten zu gehen, bis ❯ auf /settings askUser off zeigt, und drücken Sie dann Eingabetaste.

  4. Drücken Sie erneut die EINGABETASTE , um den /settings askUser off Befehl zu übermitteln.

    Die CLI bestätigt die Änderung: Set askUser = false.

Anzeigen gültiger Werte für eine Einstellung

Geben Sie /settings KEY ohne Wert ein, um die gültigen Werte anzuzeigen, die für eine Einstellung verfügbar sind. So können Sie beispielsweise die gültigen Werte für theme anzeigen:

Copilot prompt
/settings theme

Anzeigen des aktuellen Werts einer Einstellung

Um den aktuellen Wert einer Einstellung anzuzeigen, verwenden Sie show. Beispiel:

Copilot prompt
/settings show theme

Dadurch wird eine Zeile wie theme = high-contrast ausgegeben. Das show Formular eignet sich zum schnellen Überprüfen eines Werts oder zum Erfassen von Einstellungen in Protokollen.

Ändern von Einstellungen, für die ein Neustart erforderlich ist

Die meisten Einstellungen werden sofort wirksam, aber einige werden erst nach Copilot CLI einem Neustart vollständig wirksam – zum Beispiel experimental und die Proxyeinstellungen. Wenn Sie eines davon ändern, teilt Ihnen Copilot mit, dass ein Neustart erforderlich ist, und kann die Sitzung für Sie neu starten.

Einstellungen, die Sie nicht über die Befehlszeile ändern können

Nicht jede Einstellung kann über die Inlinemethode /settings KEY VALUE bearbeitet werden:

  • Sicherheitsrelevante Einstellungen , z. B. solche, die ändern, wie Anmeldeinformationen gespeichert werden oder einen Shellbefehl ausführen, werden absichtlich ausgeschlossen, da das Kippen in einer einzelnen Zeile ohne Bestätigung riskant ist.
  • Listen- und strukturierte Einstellungen können nicht inline festgelegt werden. Drücken Sie /settings dann STRG+E , um in Ihrem konfigurierten Terminal-Editor zu öffnen settings.json , und bearbeiten Sie die Einstellung dort.
  • Einstellungen, die von Ihrem Repository oder Ihrer Organisation verwaltet werden, werden als Referenz angezeigt, aber ihre Werte stammen aus diesen Quellen und überschreiben Ihren persönlichen Wert. Das Ändern in den Benutzereinstellungen hat keine Auswirkung.

In jedem dieser Fälle wird erläutert, Copilot warum die Änderung nicht angewendet wurde, und weist Sie auf den richtigen Ort, um sie zu erstellen.

Befehle ersetzt durch /settings

Einige ältere Slash-Befehle wurden in /settings integriert. Sie funktionieren weiterhin, zeigen jedoch einen Hinweis an, der Sie über den entsprechenden /settings-Befehl informiert.

Einstellungen, die Sie möglicherweise ändern möchten

Einige häufig verwendete Einstellungen umfassen:

  • autoUpdate – Automatisches Herunterladen aktualisierter CLI-Versionen.
  • theme — Farbpalette (default, github, dim, high-contrastoder colorblind).
  • renderMarkdown — Rendern von Markdown im Terminal.
  • banner — Wie oft das Startbanner angezeigt wird (always, onceoder never).
  • beep — Signalton, wenn Copilot Ihre Aufmerksamkeit benötigt wird.
  • includeCoAuthoredBy — Fügen Sie Commits einen Co-authored-by Trailer hinzu.
  • footer.showBranch – Zeigt die aktuelle Git-Verzweigung in der Fußzeile an.

Die vollständige Liste der verfügbaren Einstellungen und die Kombination von Benutzer-, Repository- und Organisationseinstellungen finden Sie unter GitHub Copilot CLI-Konfigurationsverzeichnis.

Weiterführende Lektüre