# GitHub Copilot CLI-Konfigurationsverzeichnis Hier finden Sie Informationen zum ~/.copilot Verzeichnis, in dem Copilot CLI Konfigurations-, Sitzungsdaten und Anpassungen gespeichert werden. ``` 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 | > \[!NOTE] > 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"` | | `mouse` | boolean | Aktivieren der Mausunterstützung im alternativen Bildschirmmodus (Standard: `true`) | | `banner` | Schnur | Animierte Bannerhäufigkeit: `"always"`, , oder `"once"` (Standard: `"never"``"once"`) | | `renderMarkdown` | boolean | Rendern von Markdown in Antworten (Standard: `true`) | | `screenReader` | boolean | Optimierungen für Bildschirmlesegeräte aktivieren (Standard: `false`) | | `autoUpdate` | 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 | | `logLevel` | 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. > \[!TIP] > Einige Einstellungen können auch mithilfe von Befehlszeilenkennzeichnungen festgelegt werden. Beispielsweise schreibt der `/model`-Befehl Ihre Modellauswahl in diese Datei, sodass sie über unterschiedliche Sitzungen hinweg beibehalten wird. ### `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. Projektbezogene MCP-Konfigurationen (in `.mcp.json`, `.github/mcp.json` oder `.vscode/mcp.json`) haben Vorrang vor Benutzereinstellungen, wenn Servernamen in Konflikt stehen. Weitere Informationen findest du unter [Hinzufügen von MCP-Servern für GitHub Copilot-CLI](/de/copilot/how-tos/copilot-cli/customize-copilot/add-mcp-servers). ### `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-Agents (in `.github/agents/`) haben Vorrang vor persönlichen Agents, wenn sie denselben Namen haben. Weitere Informationen findest du unter [Erstellen und Verwenden von benutzerdefinierten Agenten für GitHub Copilot-CLI](/de/copilot/how-tos/copilot-cli/customize-copilot/create-custom-agents-for-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.md`z. B. . Persönliche Skills sind in allen Ihren Sitzungen verfügbar. Projektfähigkeiten haben Vorrang vor persönlichen Fähigkeiten, wenn beide denselben Namen tragen. Weitere Informationen findest du unter [Hinzufügen von Agent-Fähigkeiten für GitHub Copilot-CLI](/de/copilot/how-tos/copilot-cli/customize-copilot/create-skills). ### `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](/de/copilot/how-tos/copilot-cli/customize-copilot/use-hooks). ## 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 über Tool- und Verzeichnisberechtigungen, organisiert nach Projektstandort. 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. > \[!NOTE] > 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. > \[!TIP] > 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](/de/copilot/reference/copilot-cli-reference/cli-plugin-reference). ### `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 copy export COPILOT_HOME=/path/to/my/copilot-config ``` * ``` **Befehlszeilenoption**: Beim Starten der CLI verwenden `--config-dir` . ``` ```bash copy copilot --config-dir /path/to/my/copilot-config ``` Die `--config-dir`-Option hat Vorrang vor `COPILOT_HOME`, das wiederum Vorrang vor dem Standardspeicherort `~/.copilot` hat. ### Zu beachtende Dinge * ``` `COPILOT_HOME` ersetzt den gesamten `~/.copilot` Pfad. Der von Ihnen festgelegte Wert sollte der vollständige Pfad zu dem Verzeichnis sein, das Sie für die Konfigurationsdateien und Unterverzeichnisse verwenden möchten. ``` * Das Ändern des Verzeichnisses bedeutet, dass Ihre vorhandene Konfiguration, der Sitzungsverlauf, die installierten Plug-Ins und gespeicherten Berechtigungen am neuen Speicherort nicht gefunden werden. Kopieren oder verschieben Sie die Inhalte von `~/.copilot` an den neuen Speicherort, wenn Sie sie beibehalten möchten. * ## Das **Cacheverzeichnis** (verwendet für Marketplace-Caches, Automatisch-Update-Pakete und andere kurzlebige Daten) folgt Plattformkonventionen und ist nicht betroffen von `COPILOT_HOME`. Es befindet sich unter: ``` **macOS**: `~/Library/Caches/copilot` ``` \- **Linux**: `$XDG_CACHE_HOME/copilot` oder `~/.cache/copilot` ------------------------------------------------------------ ``` **Windows**: `%LOCALAPPDATA%/copilot` ``` Um das Cacheverzeichnis separat außer Kraft zu setzen, legen Sie `COPILOT_CACHE_HOME` fest. ## Was Sie sicher löschen können | Element | Sicher zu löschen? | Auswirkung | | ---------------------------- | ------------------ | ---------------------------------------------------------------------------------------------------------------------------------- | | `logs/` | Ja | Protokolldateien werden jede Sitzung neu erstellt. Das Löschen hat keine funktionalen Auswirkungen. | | `session-state/` | Mit Vorsicht | Durch das Löschen wird die Sitzungshistorie entfernt. Sie können vergangene Sitzungen nicht mehr fortsetzen. | | `session-store.db` | Mit Vorsicht | Beim Löschen werden sitzungsübergreifende Daten entfernt. Die Datei wird automatisch neu erstellt. | | `config.json` | Mit Vorsicht | Setzt alle Konfigurationen auf Standardwerte zurück. Sie müssen Ihre Einstellungen neu konfigurieren. | | `permissions-config.json` | Mit Vorsicht | Setzt alle gespeicherten Berechtigungen zurück. Die CLI fordert Sie erneut zur Eingabe von Tool- und Verzeichnisgenehmigungen auf. | | `installed-plugins/` | Nicht empfohlen | Verwenden Sie `copilot plugin uninstall` stattdessen, um sicherzustellen, dass Plug-In-Metadaten `config.json` konsistent bleiben. | | `mcp-config.json` | Nicht empfohlen | Ihre MCP-Serverdefinitionen auf Benutzerebene gehen verloren. Sichern Sie zuerst. | | `agents/`, `skills/``hooks/` | Nicht empfohlen | Sie verlieren Ihre persönlichen Anpassungen. Sichern Sie zuerst. | ## Weiterführende Lektüre * [GitHub Copilot-CLI](/de/copilot/how-tos/copilot-cli) * [GitHub Copilot CLI-Befehlsreferenz](/de/copilot/reference/copilot-cli-reference/cli-command-reference) * [Programmgesteuerte Referenz für die GitHub Copilot-CLI](/de/copilot/reference/copilot-cli-reference/cli-programmatic-reference) * [GitHub Copilot CLI-Plug-In-Referenz](/de/copilot/reference/copilot-cli-reference/cli-plugin-reference)