GitHub Copilot CLI-Konfigurationsverzeichnis

          Copilot CLI speichert die Konfiguration, den Sitzungsverlauf, Protokolle und Anpassungen in einem einzigen Verzeichnis auf Ihrem Computer. Dieses Verzeichnis ist standardmäßig `~/.copilot` (d. h. `$HOME/.copilot`).

In diesem Artikel werden die Inhalte dieses Verzeichnisses und deren Verwendung beschrieben.

Verzeichnisübersicht

Das ~/.copilot Verzeichnis enthält die folgenden Elemente der obersten Ebene.

Pfad	Typ	Beschreibung
`config.json`	Datei	Ihre persönlichen Konfigurationseinstellungen
`mcp-config.json`	Datei	MCP-Serverdefinitionen auf Benutzerebene
`permissions-config.json`	Datei	Gespeicherte Tool- und Verzeichnisberechtigungen pro Projekt
`agents/`	Verzeichnis	Persönliche benutzerdefinierte Agentdefinitionen
`skills/`	Verzeichnis	Persönliche benutzerdefinierte Qualifikationsdefinitionen
`hooks/`	Verzeichnis	Hook-Skripts auf Benutzerebene
`logs/`	Verzeichnis	Sitzungsprotokolldateien
`session-state/`	Verzeichnis	Sitzungsverlauf und Arbeitsbereichsdaten
`session-store.db`	Datei	SQLite-Datenbank für sitzungsübergreifende Daten
`installed-plugins/`	Verzeichnis	Installierte Plug-In-Dateien
`ide/`	Verzeichnis	IDE-Integrationsstatus

Hinweis

Nicht alle diese Elemente werden sofort angezeigt. Einige werden auf Abruf erstellt, wenn Sie ein bestimmtes Feature zum ersten Mal verwenden, z.B. wird installed-plugins/ erst nach der Installation Ihres ersten Plugins angezeigt.

Bearbeitbare Dateien

Die folgenden Dateien sind so konzipiert, dass sie von Ihnen direkt bearbeitet oder über CLI-Befehle verwaltet werden.

`config.json`

Dies ist die primäre Konfigurationsdatei für Copilot CLI. Sie können ihn direkt in einem Text-Editor bearbeiten oder z. B. interaktive Befehle wie /model und /theme verwenden, um bestimmte Werte innerhalb einer Sitzung zu ändern. Die Datei unterstützt JSON mit Kommentaren (JSONC).

Zu den allgemeinen Einstellungen gehören:

Schlüssel	Typ	Beschreibung
`model`	Schnur	ZU verwendende KI-Modell (z. B. `"gpt-5.2"`, `"claude-sonnet-4.6"`)
`effortLevel`	Schnur	Begründungsaufwand für Modelle, die dies unterstützen
`theme`	Schnur	Farbdesign: `"auto"`, , `"dark"`oder `"light"`
`alt_screen`	boolean	Verwenden des alternativen Bildschirmpuffers (Standard: `true`)
`mouse`	boolean	Aktivieren der Mausunterstützung im alternativen Bildschirmmodus (Standard: `true`)
`banner`	Schnur	Animierte Bannerhäufigkeit: `"always"`, , oder `"once"` (Standard: "never"``"once")
`render_markdown`	boolean	Render Markdown in Antworten (Standard: `true`)
`screen_reader`	boolean	Optimierungen für Bildschirmlesegeräte aktivieren (Standard: `false`)
`auto_update`	boolean	Cli-Updates automatisch herunterladen (Standard: `true`)
`stream`	boolean	Antworten tokenweise streamen (Standard: `true`)
`includeCoAuthoredBy`	boolean	"Co-authored-by" zu von einem Agenten erstellten Commits hinzufügen (Standard: `true`)
`respectGitignore`	boolean	Ausschließen von gitignored-Dateien aus der `@` Dateiauswahl (Standard: `true`)
`trusted_folders`	string[]	Ordner, in denen Lese-/Ausführungsberechtigung erteilt wurde
`allowed_urls`	string[]	URLs oder Domänen, die ohne Aufforderung zulässig sind
`denied_urls`	string[]	URLs oder Domänen, die immer verweigert werden
`log_level`	Schnur	Ausführlichkeit des Protokolls: `"none"`, `"error"`, `"warning"`, `"info"`, `"debug"`, `"all"` oder `"default"` (Standard: `"default"`)
`disableAllHooks`	boolean	Alle Hooks deaktivieren (Standard: `false`)
`hooks`	Objekt	Inline-Hookdefinitionen auf Nutzerebene

Geben Sie copilot help config ein, um eine vollständige Liste der Konfigurationseinstellungen in Ihrem Terminal anzuzeigen.

Tipp

Einige Einstellungen können auch mithilfe von Befehlszeilenkennzeichnungen festgelegt werden. Legen Sie z. B. --alt-screen und --no-alt-screen den alt_screen Wert fest und speichern Sie ihn auf config.json. Mit dem Slash-Befehl /model wird Ihre Modellauswahl in diese Datei geschrieben, wodurch sie über mehrere Sitzungen hinweg erhalten bleibt.

`mcp-config.json`

Definiert MCP-Server (Model Context Protocol), die auf Benutzerebene verfügbar sind. Diese Server sind in allen Ihren Sitzungen verfügbar, unabhängig davon, in welchem Projektverzeichnis Sie sich befinden. MCP-Konfigurationen auf Projektebene (in .mcp.json, .github/mcp.json, oder .vscode/mcp.json) haben Vorrang vor den Definitionen auf Benutzerebene, bei Servernamen-Konflikten.

Weitere Informationen findest du unter Hinzufügen von MCP-Servern für GitHub Copilot-CLI.

`agents/`

Speichern Sie hier persönliche benutzerdefinierte Agentdefinitionen als .agent.md Dateien. Agents, die in diesem Verzeichnis platziert sind, sind in allen Ihren Sitzungen verfügbar. Project-Level-Agents (in .github/agents/) haben Vorrang vor persönlichen Agents, wenn sie denselben Namen teilen.

Weitere Informationen findest du unter Erstellen und verwenden von kundenspezifischen Agenten für GitHub Copilot-CLI.

`skills/`

Speichern Sie hier persönliche benutzerdefinierte Qualifikationsdefinitionen. Jede Fähigkeit befindet sich in einem Unterverzeichnis, das eine SKILL.md Datei enthält, ~/.copilot/skills/my-skill/SKILL.mdz. B. . Persönliche Fähigkeiten stehen in allen Ihren Sitzungen zur Verfügung. Fähigkeiten auf Projektebene haben Vorrang vor persönlichen Fähigkeiten, wenn sie denselben Namen haben.

Weitere Informationen findest du unter Erstellen von Agentenfertigkeiten für GitHub Copilot-CLI.

`hooks/`

Speichern Sie hier Benutzerebene-Hook-Skripte. Diese Hooks gelten für alle Ihre Sitzungen. Sie können Hooks auch inline in config.json definieren, indem Sie den hooks Schlüssel verwenden. Hooks auf Repositoryebene (in .github/hooks/) werden zusammen mit Hooks auf Benutzerebene geladen.

Weitere Informationen findest du unter Verwenden von Hooks mit GitHub Copilot-CLI.

Automatisch verwaltete Dateien

Die folgenden Elemente werden von der CLI verwaltet. Im Allgemeinen sollten Sie sie nicht manuell bearbeiten.

`permissions-config.json`

Speichert Ihre gespeicherten Entscheidungen zu Werkzeugen und Verzeichnisberechtigungen, organisiert nach Projektspeicherort. Wenn Sie ein Tool genehmigen oder Zugriff auf ein Verzeichnis gewähren, zeichnet die CLI die Entscheidung hier auf, sodass Sie im selben Projekt nicht erneut aufgefordert werden.

Hinweis

Wenn Sie Berechtigungen für ein Projekt zurücksetzen möchten, können Sie den entsprechenden Eintrag aus dieser Datei löschen. Das Bearbeiten der Datei während der Ausführung einer Sitzung kann jedoch zu unerwartetem Verhalten führen.

`session-state/`

Enthält Sitzungsverlaufsdaten, organisiert nach Sitzungs-ID in Unterverzeichnissen. Jedes Sitzungsverzeichnis speichert ein Ereignisprotokoll (events.jsonl) und Arbeitsbereichsartefakte (Pläne, Prüfpunkte, nachverfolgte Dateien). Diese Daten ermöglichen den Fortsetzen der Sitzung (--resume oder --continue).

`session-store.db`

Eine SQLite-Datenbank, die von der CLI für sitzungsübergreifende Daten verwendet wird, z. B. Prüfpunktindizierung und Suche. Diese Datei wird automatisch verwaltet und sollte nicht bearbeitet werden.

`logs/`

Enthält Protokolldateien für CLI-Sitzungen. Jede Sitzung erstellt eine Protokolldatei mit dem Namen process-{timestamp}-{pid}.log. Diese Dateien sind hilfreich beim Debuggen von Problemen.

Tipp

Um die Protokolldatei für Ihre aktuelle Sitzung zu finden, geben Sie /session in einer interaktiven Sitzung ein. Die Ausgabe enthält den vollständigen Pfad zur Protokolldatei sowie andere Sitzungsdetails wie sitzungs-ID, Dauer und Arbeitsverzeichnis.

`installed-plugins/`

Enthält die Dateien für Plug-Ins, die Sie installiert haben. Plugins, die auf einem Marketplace installiert sind, werden unter installed-plugins/{marketplace-name}/{plugin-name}/gespeichert. Direkt installierte Plugins werden unter installed-plugins/_direct/gespeichert. Verwalten Sie Plug-Ins mithilfe der copilot plugin Befehle, anstatt dieses Verzeichnis direkt zu bearbeiten.

Weitere Informationen findest du unter GitHub Copilot CLI-Plug-In-Referenz.

`ide/`

Enthält Sperrdateien und Zustand für IDE-Integrationen (zum Beispiel, wenn Copilot CLI mit Visual Studio Code verbunden ist). Dieses Verzeichnis wird automatisch verwaltet.

Ändern des Speicherorts des Konfigurationsverzeichnisses

Sie können den Standardspeicherort ~/.copilot auf zwei verschiedene Weisen außer Kraft setzen:

        **Umgebungsvariable**: Legen Sie `COPILOT_HOME` den Pfad des Verzeichnisses fest, das Sie verwenden möchten.

Bash

export COPILOT_HOME=/path/to/my/copilot-config

export COPILOT_HOME=/path/to/my/copilot-config

        **Befehlszeilenoption**: Beim Starten der CLI verwenden `--config-dir` .