GitHub Copilot CLI-Befehlsreferenz

Kommandozeilenbefehle

Befehl	Purpose
`copilot`	Starten Sie die interaktive Benutzeroberfläche.
`copilot help [topic]`	Hilfeinformationen anzeigen. Zu den Hilfethemen gehören: `config`, , `commands`, `environment`, `logging`und `permissions`.
`copilot init`	Initialisieren Sie Copilot benutzerdefinierte Anweisungen für dieses Repository.
`copilot update`	Laden Sie die neueste Version herunter, und installieren Sie sie.
`copilot version`	Zeigen Sie Versionsinformationen an, und suchen Sie nach Updates.
`copilot login`	Authentifizieren Sie sich mit Copilot über den OAuth-Gerätefluss. Akzeptiert `--host HOST` zur Angabe der GitHub Host-URL (Standard: `https://github.com`).
`copilot logout`	Melden Sie sich von GitHub ab, und entfernen Sie gespeicherte Anmeldeinformationen.
`copilot plugin`	Verwalten Sie Plugins und Plug-In-Marketplaces.

Globale Tastenkombinationen in der interaktiven Benutzeroberfläche

Verknüpfung	Purpose
`@ FILENAME`	Fügen Sie Dateiinhalte in den Kontext ein.

          <kbd>Strg</kbd>+<kbd>X</kbd> dann `/`  | Nachdem Sie mit der Eingabe einer Eingabeaufforderung begonnen haben, können Sie einen Schrägstrichbefehl ausführen, z. B. wenn Sie das Modell ändern möchten, ohne die Eingabeaufforderung erneut eingeben zu müssen. |

Zeitleistenshortcuts in der interaktiven Benutzeroberfläche

Verknüpfung	Purpose
STRG+O	Während es in der Eingabeaufforderung nichts gibt, werden die jüngsten Elemente im Antwortverlauf von Copilot erweitert, um mehr Details anzuzeigen.
STRG+E	Wenn keine Inhalte in der Eingabeaufforderung vorhanden sind, werden alle Elemente in der Antwortzeitachse von Copilot erweitert.
STRG+T	Erweitern/Reduzieren der Anzeige der Begründung in Antworten.

Verknüpfung	Purpose

          <kbd>STRG</kbd>+<kbd>A</kbd>        | Wechseln zum Anfang der Zeile (beim Eingeben). |

Slash-Befehle in der interaktiven Benutzeroberfläche

Befehl	Purpose
`/add-dir PATH`	Fügen Sie der Liste der zulässigen Dateien ein Verzeichnis für den Dateizugriff hinzu.
`/agent`	Durchsuchen und wählen Sie aus den verfügbaren Agents (falls vorhanden) aus.

          `/allow-all`, `/yolo`                               | Alle Berechtigungen aktivieren (Tools, Pfade und URLs). |

Eine vollständige Liste der verfügbaren Schrägstrichbefehle finden Sie /help in der interaktiven Benutzeroberfläche der CLI.

Befehlszeilenoptionen

Auswahl	Purpose
`--acp`	Starten Sie den Agent-Clientprotokollserver.
`--add-dir=PATH`	Fügen Sie der Liste für den Dateizugriff ein Verzeichnis hinzu (kann mehrmals verwendet werden).
`--add-github-mcp-tool=TOOL`	Fügen Sie ein Tool hinzu, um GitHub MCP-Server anstelle der standardmäßigen CLI-Teilmenge zu aktivieren (kann mehrmals verwendet werden). Verwenden Sie `*` für alle Tools.
`--add-github-mcp-toolset=TOOLSET`	Fügen Sie ein Toolset hinzu, um den GitHub MCP-Server anstelle der standardmäßigen CLI-Teilmenge zu aktivieren. Dies kann mehrmals verwendet werden. Verwenden Sie `all` für alle Toolsets.
`--additional-mcp-config=JSON`	Fügen Sie nur einen MCP-Server für diese Sitzung hinzu. Die Serverkonfiguration kann als JSON-Zeichenfolge oder als Dateipfad (Präfix mit `@`) bereitgestellt werden. Erweitert die Konfiguration von `~/.copilot/mcp-config.json`. Überschreibt jede installierte MCP-Serverkonfiguration mit demselben Namen.
`--agent=AGENT`	Geben Sie eine Benutzerdefinierter Agent zur Verwendung an.
`--allow-all`	Alle Berechtigungen aktivieren (entspricht `--allow-all-tools --allow-all-paths --allow-all-urls`).
`--allow-all-paths`	Deaktivieren Sie die Überprüfung des Dateipfads, und erlauben Sie den Zugriff auf einen beliebigen Pfad.
`--allow-all-tools`	Zulassen, dass alle Tools automatisch ohne Bestätigung ausgeführt werden. Erforderlich bei programmgesteuerter Verwendung der CLI (env: `COPILOT_ALLOW_ALL`).
`--allow-all-urls`	Zugriff auf alle URLs ohne Bestätigung zulassen.
`--allow-tool=TOOL ...`	Tools, die von der CLI verwendet werden dürfen. Fordert keine Erlaubnis an. Verwenden Sie für mehrere Tools eine in Anführungszeichen gesetzte, durch Kommas getrennte Liste.
`--allow-url=URL ...`	Zugriff auf bestimmte URLs oder Domänen zulassen. Verwenden Sie für mehrere URLs eine in Anführungszeichen gesetzte, durch Kommas getrennte Liste.
`--alt-screen=VALUE`	Verwenden Sie den alternativen Terminalbildschirmpuffer (`on` oder `off`).
`--autopilot`	Aktivieren Sie die fortlaufende Autopilot-Ausführung im Promptmodus. Siehe Zulassen, dass GitHub Copilot CLI autonom arbeiten kann.
`--available-tools=TOOL ...`	Nur diese Tools sind für das Modell verfügbar. Verwenden Sie für mehrere Tools eine in Anführungszeichen gesetzte, durch Kommas getrennte Liste.
`--banner`	Das Startbanner anzeigen.
`--bash-env`	Aktivieren Sie `BASH_ENV` die Unterstützung für Bash-Shells.
`--config-dir=PATH`	Legen Sie das Konfigurationsverzeichnis fest (Standard: `~/.copilot`).
`--continue`	Fortsetzen der letzten Sitzung.
`--deny-tool=TOOL ...`	Tools, die von der CLI nicht verwendet werden dürfen. Fordert keine Erlaubnis an. Verwenden Sie für mehrere Tools eine in Anführungszeichen gesetzte, durch Kommas getrennte Liste.
`--deny-url=URL ...`	Der Zugriff auf bestimmte URLs oder Domänen wird verweigert; hat Vorrang vor `--allow-url`. Verwenden Sie für mehrere URLs eine in Anführungszeichen gesetzte, durch Kommas getrennte Liste.
`--disable-builtin-mcps`	Deaktivieren Sie alle integrierten MCP-Server (derzeit: `github-mcp-server`).
`--disable-mcp-server=SERVER-NAME`	Deaktivieren Sie einen bestimmten MCP-Server (kann mehrmals verwendet werden).
`--disable-parallel-tools-execution`	Deaktivieren Sie die parallele Ausführung von Tools (LLM kann weiterhin parallele Toolaufrufe ausführen, sie werden jedoch sequenziell ausgeführt).
`--disallow-temp-dir`	Verhindern des automatischen Zugriffs auf das temporäre Systemverzeichnis.
`--enable-all-github-mcp-tools`	Aktivieren Sie alle GitHub MCP-Servertools anstelle der standardmäßigen CLI-Teilmenge. Hebt die `--add-github-mcp-toolset`- und `--add-github-mcp-tool`-Optionen auf.
`--excluded-tools=TOOL ...`	Diese Tools sind für das Modell nicht verfügbar. Verwenden Sie für mehrere Tools eine in Anführungszeichen gesetzte, durch Kommas getrennte Liste.
`--experimental`	Aktivieren Sie experimentelle Features (verwenden Sie `--no-experimental`, um zu deaktivieren).

          `-h`, `--help`                     | Hilfe anzeigen. |

| -i PROMPT, --interactive=PROMPT | Starten Sie eine interaktive Sitzung, und führen Sie diese Eingabeaufforderung automatisch aus. | | --log-dir=DIRECTORY | Legen Sie das Protokolldateiverzeichnis fest (Standard: ~/.copilot/logs/). | | --log-level=LEVEL | Legen Sie die Protokollebene fest (Auswahlmöglichkeiten: none, error, warning, , info, debug, , all). default | | --max-autopilot-continues=COUNT | Maximale Anzahl von Fortsetzungsmeldungen im Autopilot-Modus (Standard: unbegrenzt). Siehe Zulassen, dass GitHub Copilot CLI autonom arbeiten kann. | | --model=MODEL | Legen Sie das KI-Modell fest, das Sie verwenden möchten. | | --no-alt-screen | Deaktivieren Sie den alternativen Terminalbildschirmpuffer. | | --no-ask-user | Deaktivieren Sie das ask_user Tool (der Agent funktioniert autonom, ohne Fragen zu stellen). | | --no-auto-update | Automatisches Herunterladen von CLI-Updates deaktivieren. | | --no-bash-env | Deaktivieren Sie BASH_ENV die Unterstützung für Bash-Shells. | | --no-color | Alle Farbausgabe deaktivieren. | | --no-custom-instructions | Deaktivieren Sie das Laden von benutzerdefinierten Anweisungen aus AGENTS.md sowie verwandten Dateien. | | --no-experimental | Deaktivieren Sie experimentelle Features. | | --output-format=FORMAT | FORMAT kann text (Standard) oder json (Ausgabe JSONL: ein JSON-Objekt pro Zeile) sein. | | -p PROMPT, --prompt=PROMPT | Führen Sie ein Prompt programmgesteuert aus (endet nach Abschluss). | | --plain-diff | Deaktivieren Sie das erweiterte Diff-Rendering (Syntaxhervorhebung über das in Ihrer Git-Konfiguration angegebene Diff-Tool). | | --resume=SESSION-ID | Fortsetzen einer vorherigen interaktiven Sitzung durch Auswählen aus einer Liste (optional angeben einer Sitzungs-ID). | | -s, --silent | Gibt nur die Agent-Antwort aus (ohne Nutzungsstatistiken). Dies ist nützlich für die Skripterstellung mit -p. | | --screen-reader | Aktivieren Sie Bildschirmleser-Optimierungen. | | --secret-env-vars=VAR ... | Eine Umgebungsvariable, deren Wert in der Ausgabe geschwärzt werden soll. Verwenden Sie für mehrere Variablen eine angeführte, kommagetrennte Liste. Die Werte in den GITHUB_TOKEN Variablen und COPILOT_GITHUB_TOKEN Umgebungsvariablen sind standardmäßig redigiert. | | --share=PATH | Teilen einer Sitzung als Markdown-Datei nach Abschluss einer programmgesteuerten Sitzung (Standardpfad: ./copilot-session-<ID>.md). | | --share-gist | Teilen Sie eine Sitzung mit einem geheimen GitHub gist nach Abschluss einer programmgesteuerten Sitzung. | | --stream=MODE | Aktivieren oder Deaktivieren des Streamingmodus (Modusoptionen: on oder off). | | -v, --version | Versionsinformationen anzeigen. | | --yolo | Alle Berechtigungen aktivieren (entspricht --allow-all). |

Um eine vollständige Liste der Befehle und Optionen zu erhalten, führen Sie copilot help aus.

Toolberechtigungsmuster

Die --allow-tool Und --deny-tool Optionen akzeptieren Berechtigungsmuster im Format Kind(argument). Das Argument ist optional – wird es weggelassen, werden alle Tools dieser Art erfasst.

Kind	Beschreibung	Beispielmuster
`shell`	Shellbefehlsausführung

          `shell(git push)`, `shell(git:*)``shell` |

| write | Dateierstellung oder -änderung | write, write(src/*.ts) | | read | Datei- oder Verzeichnislesevorgänge | read, read(.env) | | SERVER-NAME | MCP-Server-Toolaufruf | MyMCP(create_issue), MyMCP | | url | URL-Zugriff über Web-Fetch oder Shell | url(github.com), url(https://*.api.com) | | memory | Speichern von Fakten im Agentspeicher | memory |

Bei shell Regeln entspricht das :* Suffix dem Befehlsstamm gefolgt von einem Leerzeichen und verhindert partielle Übereinstimmungen. Zum Beispiel shell(git:*) entspricht git push und git pull, entspricht aber nicht gitea.

Ablehnungsregeln haben immer Vorrang vor Erlaubnisregeln, auch wenn --allow-all festgelegt ist.

# Allow all git commands except git push
copilot --allow-tool='shell(git:*)' --deny-tool='shell(git push)'

# Allow a specific MCP server tool
copilot --allow-tool='MyMCP(create_issue)'

# Allow all tools from a server
copilot --allow-tool='MyMCP'

Umgebungsvariablen

Variable	Beschreibung
`COPILOT_MODEL`	Legen Sie das KI-Modell fest.
`COPILOT_ALLOW_ALL`	Festlegen auf `true`, um alle Berechtigungen automatisch zu erlauben (entspricht `--allow-all`).
`COPILOT_AUTO_UPDATE`	Stellen Sie `false` ein, um automatische Updates zu deaktivieren.
`COPILOT_CUSTOM_INSTRUCTIONS_DIRS`	Durch Trennzeichen getrennte Liste zusätzlicher Verzeichnisse für benutzerdefinierte Anweisungen.
`COPILOT_SKILLS_DIRS`	Durch Trennzeichen getrennte Liste zusätzlicher Verzeichnisse für Fähigkeiten.
`COPILOT_EDITOR`	Editor-Befehl für die interaktive Bearbeitung (überprüft nach `$VISUAL` und `$EDITOR`). Wenn keine festgelegt sind, wird `vi` standardmäßig verwendet.
`COPILOT_GITHUB_TOKEN`	Authentifizierungs-Token. Hat Vorrang vor `GH_TOKEN` und `GITHUB_TOKEN`.
`COPILOT_HOME`	Überschreiben Sie das Konfigurations- und Statusverzeichnis. Standardwert: `$HOME/.copilot`.
`GH_TOKEN`	Authentifizierungs-Token. Hat Vorrang vor `GITHUB_TOKEN`.
`GITHUB_TOKEN`	Authentifizierungs-Token.
`USE_BUILTIN_RIPGREP`	Setzen Sie `false` ein, um das System-ripgrep anstelle der gebündelten Version zu verwenden.
`PLAIN_DIFF`	Setzen Sie `true`, um das Rendern von Rich-Diff-Elementen zu deaktivieren.
`COLORFGBG`	Fallback zur Erkennung von dunklen/hellen Terminal-Hintergründen.
`COPILOT_CLI_ENABLED_FEATURE_FLAGS`	Durch Trennzeichen getrennte Liste der zu aktivierenden Featurekennzeichnungen (z. B `"SOME_FEATURE,SOME_OTHER_FEATURE"`. ).

Konfigurationsdateieinstellungen

Einstellungen werden vom Benutzer auf das Repository und dann lokal übertragen, wobei spezifischere Bereiche allgemeinere ersetzen. Befehlszeilenkennzeichnungen und Umgebungsvariablen haben immer die höchste Priorität.

Geltungsbereich	Ort	Purpose
Benutzer	`~/.copilot/config.json`	Globale Standardwerte für alle Repositories. Verwenden Sie die `COPILOT_HOME` Umgebungsvariable, um einen alternativen Pfad anzugeben.
Repository	`.github/copilot/settings.json`	Konfiguration des freigegebenen Repositorys (im Repository festgeschrieben).
Lokal	`.github/copilot/settings.local.json`	Persönliche Außerkraftsetzungen (fügen Sie diese hinzu).`.gitignore`

Benutzereinstellungen (`~/.copilot/config.json`)

Schlüssel	Typ	Vorgabe	Beschreibung
`allowed_urls`	`string[]`	`[]`	URLs oder Domänen, die ohne Aufforderung zulässig sind.
`alt_screen`	`boolean`	`false`	Verwenden Sie den alternativen Terminalbildschirmpuffer.
`auto_update`	`boolean`	`true`	Cli-Updates automatisch herunterladen.
`banner`

          `"always"`
          \|
          `"once"`
          \|
          `"never"`
         | `"once"` | Animierte Banneranzeigehäufigkeit. |

Repository-Einstellungen (`.github/copilot/settings.json`)

Repositoryeinstellungen gelten für alle Personen, die im Repository arbeiten. Nur eine Teilmenge der Einstellungen wird auf Repositoryebene unterstützt. Nicht unterstützte Schlüssel werden ignoriert.

Schlüssel	Typ	Zusammenführungsverhalten	Beschreibung
`companyAnnouncements`	`string[]`	Ersetzt – Repository hat Vorrang	Nachrichten, die beim Start zufällig angezeigt werden.
`enabledPlugins`	`Record<string, boolean>`	Zusammengeführt – Repository setzt benutzer für denselben Schlüssel außer Kraft	Automatische Installation des deklarativen Plug-Ins.
`extraKnownMarketplaces`	`Record<string, {...}>`	Zusammengeführt – Repository setzt benutzer für denselben Schlüssel außer Kraft	Plug-In-Marketplaces, die in diesem Repository verfügbar sind.
`marketplaces`	`Record<string, {...}>`	Zusammengeführt – Repository setzt benutzer für denselben Schlüssel außer Kraft	Plug-In-Marketplaces (veraltet – Verwendung `extraKnownMarketplaces`).

Lokale Einstellungen (`.github/copilot/settings.local.json`)

Erstellen Sie .github/copilot/settings.local.json im Repository für persönliche Überschreibungen, die nicht festgeschrieben werden sollten. Fügen Sie diese Datei zu .gitignore.

Die lokale Konfigurationsdatei verwendet dasselbe Schema wie die Repositorykonfigurationsdatei (.github/copilot/settings.json) und hat Vorrang.

Hooks-Referenz

Hooks sind externe Befehle, die während einer Sitzung an bestimmten Lebenszykluspunkten ausgeführt werden und benutzerdefinierte Automatisierung, Sicherheitssteuerelemente und Integrationen ermöglichen. Hook-Konfigurationsdateien werden automatisch von .github/hooks/*.json in Ihrem Repository geladen.

Hook-Konfigurationsformat

Hook-Konfigurationsdateien verwenden JSON-Format mit Version 1.

Befehlshaken

Befehlshaken führen Shellskripts aus und werden für alle Hooktypen unterstützt.

{
  "version": 1,
  "hooks": {
    "preToolUse": [
      {
        "type": "command",
        "bash": "your-bash-command",
        "powershell": "your-powershell-command",
        "cwd": "optional/working/directory",
        "env": { "VAR": "value" },
        "timeoutSec": 30
      }
    ]
  }
}

Feld	Typ	Erforderlich	Beschreibung
`type`	`"command"`	Ja	Muss `"command"` sein.
`bash`	Schnur	Einer von `bash`/`powershell`	Shell-Befehl für Unix.
`powershell`	Schnur	Einer von `bash`/`powershell`	Shellbefehl für Windows.
`cwd`	Schnur	No	Arbeitsverzeichnis für den Befehl (relativ zum Repositorystamm oder absolut).
`env`	Objekt	No	Festzulegende Umgebungsvariablen (unterstützt variable Erweiterung).
`timeoutSec`	number	No	Timeout in Sekunden. Standardwert: `30`.

Eingabeaufforderungshaken

Prompt-Hooks senden automatisch Text, als hätte der Benutzer ihn selbst eingegeben. Sie werden nur auf sessionStart unterstützt und laufen, bevor ein anfänglicher Befehl über --prompt übergeben wird. Der Text kann eine Aufforderung in natürlicher Sprache oder ein Slash-Befehl sein.

{
  "version": 1,
  "hooks": {
    "sessionStart": [
      {
        "type": "prompt",
        "prompt": "Your prompt text or /slash-command"
      }
    ]
  }
}

Feld	Typ	Erforderlich	Beschreibung
`type`	`"prompt"`	Ja	Muss `"prompt"` sein.
`prompt`	Schnur	Ja	Text zum Einreichen – kann eine Nachricht in natürlicher Sprache oder ein Slash-Befehl sein.

Hook-Ereignisse

Ereignis	Wird ausgelöst, wenn	Verarbeitete Ausgabe
`sessionStart`	Eine neue oder fortgesetzte Sitzung beginnt.	No
`sessionEnd`	Die Sitzung wird beendet.	No
`userPromptSubmitted`	Der Benutzer sendet eine Eingabeaufforderung.	No
`preToolUse`	Bevor jedes Tool ausgeführt wird.	Ja – kann zulassen, ablehnen oder ändern.
`postToolUse`	Nachdem jedes Tool abgeschlossen ist.	No
`agentStop`	Der Hauptagent beendet eine Runde.	Ja – kann die Fortsetzung blockieren und erzwingen.
`subagentStop`	Ein Subagent schließt ab.	Ja – kann die Fortsetzung blockieren und erzwingen.
`errorOccurred`	Während der Ausführung tritt ein Fehler auf.	No

          `preToolUse` Entscheidungssteuerung

Der preToolUse Hook kann die Toolausführung steuern, indem ein JSON-Objekt in stdout geschrieben wird.

Feld	Werte	Beschreibung
`permissionDecision`

          `"allow"`, `"deny"``"ask"` | Gibt an, ob das Tool ausgeführt wird. Leere Ausgabe verwendet Standardverhalten. |

          `agentStop`
           / 
          `subagentStop` Entscheidungssteuerung

Feld	Werte	Beschreibung
`decision`

          `"block"`, `"allow"` | 
          `"block"` erzwingt, dass ein anderer Agent die Verwendung `reason` als Eingabeaufforderung einfordert. |

| reason | Schnur | Aufforderung für den nächsten Schritt, wenn decision``"block" ist. |

Toolnamen für den Hook-Abgleich

Name des Tools	Beschreibung
`bash`	Ausführen von Shellbefehlen (Unix).
`powershell`	Ausführen von Shellbefehlen (Windows).
`view`	Dateiinhalte lesen.
`edit`	Dateiinhalte ändern.
`create`	Erstellen Sie neue Dateien.
`glob`	Suchen Sie Dateien nach Mustern.
`grep`	Dateiinhalte durchsuchen.
`web_fetch`	Webseiten abrufen.
`task`	Führen Sie Subagent-Aufgaben aus.

Wenn mehrere Hooks desselben Typs konfiguriert sind, werden sie in der reihenfolge ausgeführt. Wenn preToolUseirgendein Hook "deny"zurückgibt, wird das Tool blockiert. Hook-Fehler (Nicht-Null-Beendigungscodes oder Timeouts) werden protokolliert und übersprungen – sie blockieren niemals die Ausführung des Agents.

MCP-Serverkonfiguration

MCP-Server stellen zusätzliche Tools für den CLI-Agent bereit. Konfigurieren von beständigen Servern in ~/.copilot/mcp-config.json. Verwenden Sie --additional-mcp-config, um Server für eine einzelne Sitzung hinzuzufügen.

Transporttypen

Typ	Beschreibung	Pflichtfelder
`local` / `stdio`	Lokaler Prozess kommuniziert über stdin/stdout.

          `command`, `args` |

| http | Remoteserver mit streambarem HTTP-Transport. | url | | sse | Remoteserver mit Server-Sent-Ereignisse-Übertragung. | url |

Lokale Serverkonfigurationsfelder

Feld	Erforderlich	Beschreibung
`command`	Ja	Befehl zum Starten des Servers.
`args`	Ja	Befehlsargumente (Array)
`tools`	Ja	Zu aktivierende Tools: `["*"]` für alle oder eine Liste bestimmter Toolnamen.
`env`	No	Umgebungsvariablen. Unterstützt `$VAR`, `${VAR}` und `${VAR:-default}` Erweiterungen.
`cwd`	No	Arbeitsverzeichnis für den Server.
`timeout`	No	Timeout beim Aufruf des Tools in Millisekunden.
`type`	No

          `"local"` oder `"stdio"`. Standardwert: `"local"`. |

Remote-Server-Konfigurationsfelder

Feld	Erforderlich	Beschreibung
`type`	Ja

          `"http"` oder `"sse"`. |

Filterzuordnung

Steuern Sie, wie die MCP-Toolausgabe mithilfe des Felds in der filterMapping Konfiguration eines Servers verarbeitet wird.

Modus	Beschreibung
`none`	Keine Filterung.
`markdown`	Formatieren Sie die Ausgabe als Markdown.
`hidden_characters`	Entfernen Sie ausgeblendete Zeichen oder Steuerelementzeichen. Standard.

Integrierte MCP-Server

Die CLI enthält integrierte MCP-Server, die ohne zusätzliche Einrichtung verfügbar sind.

Server	Beschreibung
`github-mcp-server`	GitHub API-Integration: Probleme, Pull Requests, Commits, Codesuche und GitHub Actions.
`playwright`	Browserautomatisierung: Navigieren, Klicken, Eingeben, Screenshot und Formularverarbeitung.
`fetch`	HTTP-Anforderungen über das `fetch` Tool.
`time`	Zeithilfsprogramme: `get_current_time` und `convert_time`.

Verwenden Sie --disable-builtin-mcps, um alle integrierten Server zu deaktivieren, oder --disable-mcp-server SERVER-NAME, um einen bestimmten zu deaktivieren.

MCP-Serververtrauensstufen

MCP-Server werden aus mehreren Quellen geladen, jeweils mit einer anderen Vertrauensstufe.

Quelle	Vertrauensebene	Überprüfung erforderlich
Integriert	Hoch	No
Repository (`.github/mcp.json`)	Mittelstufe	Empfohlen
Arbeitsbereich (`.mcp.json`, `.vscode/mcp.json`)	Mittelstufe	Empfohlen
Dev-Container (`.devcontainer/devcontainer.json`)	Mittelstufe	Empfohlen
Benutzerkonfiguration (`~/.copilot/mcp-config.json`)	User-defined	Benutzerverantwortung
Remoteserver	Niedrig	Immer

Alle MCP-Toolaufrufe erfordern explizite Berechtigungen. Dies gilt auch für schreibgeschützte Vorgänge für externe Dienste.

Referenz zu Skills

Fähigkeiten sind Markdown-Dateien, die erweitern, was die CLI tun kann. Jede Fähigkeit lebt in einem eigenen Verzeichnis, das eine SKILL.md Datei enthält. Beim Aufrufen (über /SKILL-NAME oder automatisch durch den Agenten) wird der Inhalt der Fähigkeit in die Unterhaltung eingefügt.

Kompetenz-Frontmatterfelder

Feld	Typ	Erforderlich	Beschreibung
`name`	Schnur	Ja	Eindeutiger Bezeichner für die Fähigkeit. Nur Buchstaben, Zahlen und Bindestriche. Max. 64 Zeichen.
`description`	Schnur	Ja	Was die Fähigkeit tut und wann sie zu verwenden. Max. 1024 Zeichen.
`allowed-tools`	Zeichenfolge oder Zeichenfolge[]	No	Eine durch Kommas getrennte Liste oder ein YAML-Array von Tools, die automatisch erlaubt sind, wenn die Funktion aktiv ist. Verwenden Sie `"*"` für alle Tools.
`user-invocable`	boolean	No	Ob Benutzer den Skill `/SKILL-NAME`aufrufen können. Standardwert: `true`.
`disable-model-invocation`	boolean	No	Verhindern Sie, dass der Agent diese Fähigkeit automatisch aufruft. Standardwert: `false`.

Qualifikationsstandorte

Fähigkeiten werden aus diesen Speicherorten in der Reihenfolge ihrer Priorität geladen (bei doppelten Namen wird die zuerst gefundene verwendet).

Ort	Geltungsbereich	Beschreibung
`.github/skills/`	Projekt	Projektspezifische Fähigkeiten.
`.agents/skills/`	Projekt	Alternative Projektstandort.
`.claude/skills/`	Projekt	Claude-kompatibler Standort.
Elternteil `.github/skills/`	Geerbt	Unterstützung für das übergeordnete Verzeichnis von Monorepo.
`~/.copilot/skills/`	Personal	Persönliche Fähigkeiten für alle Projekte.
`~/.claude/skills/`	Personal	Claude-kompatibler persönlicher Standort.
Plug-In-Verzeichnisse	Plug-In	Fähigkeiten von installierten Plug-Ins.
`COPILOT_SKILLS_DIRS`	Kundenspezifisch	Zusätzliche Verzeichnisse (durch Trennzeichen getrennt).

Befehle (alternatives Qualifikationsformat)

Befehle sind eine Alternative zu "Skills", die in einzelnen .md Dateien in .claude/commands/ gespeichert werden. Der Befehlsname wird vom Dateinamen abgeleitet. Befehlsdateien verwenden ein vereinfachtes Format (kein name Feld erforderlich) und unterstützen description, allowed-toolsund disable-model-invocation. Befehle haben eine niedrigere Priorität als Fähigkeiten mit demselben Namen.

Referenz zu benutzerdefinierten Agents

Kundenspezifische Agenten sind spezialisierte KI-Agenten, die in Markdown-Dateien definiert sind. Der Dateiname (ohne Erweiterung) wird zur Agent-ID. Verwenden .agent.md Oder .md als Dateierweiterung.

Integrierte Agenten

Agent	Standardmodell	Beschreibung
`code-review`	claude-sonnet-4.5	Überprüfung des Hohen Signal-zu-Rausch-Codes. Analysiert Diffs für Fehler, Sicherheitsprobleme und Logikfehler.
`explore`	claude-haiku-4.5	Schnelle Code-Basissuche. Durchsucht Dateien, liest Code und beantwortet Fragen. Gibt fokussierte Antworten unter 300 Wörtern zurück. Kann sicher parallel ausgeführt werden.
`general-purpose`	claude-sonnet-4.5	Vollfunktions-Agent für komplexe Aufgaben mit mehreren Schritten. Wird in einem separaten Kontextfenster ausgeführt.
`research`	claude-sonnet-4.6	Forschungsagent für tiefe Analysen. Generiert einen Bericht basierend auf Informationen in Ihrer Codebasis, in relevanten Repositorys und im Web.
`task`	claude-haiku-4.5	Befehlsausführung (Tests, Builds, Lints). Gibt eine kurze Zusammenfassung bei Erfolg, eine vollständige Ausgabe bei Fehlern zurück.

Benutzerdefinierte Agent-Vordergrundinformationsfelder

Feld	Typ	Erforderlich	Beschreibung
`description`	Schnur	Ja	Beschreibung, die in der Agentenliste und im `task` Tool angezeigt wird.
`infer`	boolean	No	Automatische Delegierung durch den Hauptagenten zulassen. Standardwert: `true`.
`mcp-servers`	Objekt	No	MCP-Server zum Verbinden. Verwendet dasselbe Schema wie `~/.copilot/mcp-config.json`.
`model`	Schnur	No	KI-Modell für diesen Agent. Wenn dies nicht festgelegt ist, erbt es das Modell des äußeren Agenten.
`name`	Schnur	No	Anzeigename. Standardmäßig wird der Dateiname verwendet.
`tools`	string[]	No	Tools, die für den Agent verfügbar sind. Standard: `["*"]` (alle Tools).

Benutzerdefinierte Agent-Standorte

Geltungsbereich	Ort
Projekt

          `.github/agents/` oder `.claude/agents/` |

Agents auf Projektebene haben Vorrang vor Agents auf Benutzerebene. Plug-In-Agents haben die niedrigste Priorität.

Antworten zu Genehmigungen

Wenn die CLI zur Berechtigung zum Ausführen eines Vorgangs auffordert, können Sie mit den folgenden Schlüsseln antworten.

Schlüssel	Auswirkung
`y`	Diese bestimmte Anforderung einmal zulassen.
`n`	Verweigern Sie diese spezifische Anforderung einmal.
`!`	Alle ähnlichen Anfragen für die restliche Sitzung zulassen.
`#`	Verweigern Sie alle ähnlichen Anforderungen für den Rest der Sitzung.
`?`	Detaillierte Informationen zur Anforderung anzeigen.

Sitzungsgenehmigungen werden zurückgesetzt, wenn Sie /clear ausführen oder eine neue Sitzung starten.

Flag	Tarif	Beschreibung
`AUTOPILOT_MODE`	`experimental`	Autonomer Betriebsmodus.
`BACKGROUND_AGENTS`	`staff`	Führen Sie Agenten im Hintergrund aus.
`QUEUED_COMMANDS`	`staff`	Befehle in die Warteschlange stellen, während der Agent läuft.
`LSP_TOOLS`	`on`	Sprachserver-Protokoll-Tools.
`PLAN_COMMAND`	`on`	Interaktiver Planungsmodus.
`AGENTIC_MEMORY`	`on`	Beständiger Arbeitsspeicher über Sitzungen hinweg.
`CUSTOM_AGENTS`	`on`	Benutzerdefinierte Agentdefinitionen.

OpenTelemetry-Überwachung

Copilot CLI kann Ablaufverfolgungen und Metriken über OpenTelemetry (OTel) exportieren, sodass Sie Einblicke in Agentinteraktionen, LLM-Aufrufe, Toolausführungen und Tokenverwendung erhalten. Alle Signalnamen und Attribute folgen den OTel GenAI-Semantikkonventionen.

OTel ist standardmäßig deaktiviert und hat keinen Mehraufwand. Sie wird aktiviert, wenn eine der folgenden Bedingungen erfüllt ist:

COPILOT_OTEL_ENABLED=true

        `OTEL_EXPORTER_OTLP_ENDPOINT` ist festgelegt.

        `COPILOT_OTEL_FILE_EXPORTER_PATH` ist festgelegt.

OTel-Umgebungsvariablen

Variable	Vorgabe	Beschreibung
`COPILOT_OTEL_ENABLED`	`false`	OTel explizit aktivieren. Ist nicht erforderlich, wenn `OTEL_EXPORTER_OTLP_ENDPOINT` festgelegt ist.
`OTEL_EXPORTER_OTLP_ENDPOINT`	—	OTLP-Endpunkt-URL. Wenn Sie diese Einstellung automatisch festlegen, wird OTel aktiviert.
`COPILOT_OTEL_EXPORTER_TYPE`	`otlp-http`	Exportertyp: `otlp-http` oder `file`. Wählt `file` automatisch aus, wenn `COPILOT_OTEL_FILE_EXPORTER_PATH` festgelegt ist.
`OTEL_SERVICE_NAME`	`github-copilot`	Dienstname in Ressourcenattributen.
`OTEL_RESOURCE_ATTRIBUTES`	—	Zusätzliche Ressourcenattribute als durch Trennzeichen getrennte `key=value` Paare. Verwenden Sie die Prozentcodierung für Sonderzeichen.
`OTEL_INSTRUMENTATION_GENAI_CAPTURE_MESSAGE_CONTENT`	`false`	Erfassen Sie vollständige Prompt- und Antwortinhalte. Siehe Inhaltserfassung.
`OTEL_LOG_LEVEL`	—	OTel-Diagnoseprotokollstufe: `NONE`, , ERROR``WARN, `INFO`, `DEBUG`, . VERBOSE``ALL
`COPILOT_OTEL_FILE_EXPORTER_PATH`	—	Schreiben Sie alle Signale in diese Datei als JSON-Zeilen. Wenn Sie diese Einstellung automatisch festlegen, wird OTel aktiviert.
`COPILOT_OTEL_SOURCE_NAME`	`github.copilot`	Name des Instrumentierungsbereichs für Tracer und Meter.
`OTEL_EXPORTER_OTLP_HEADERS`	—	Authentifizierungsheader für den OTLP-Exporter (z. B. `Authorization=Bearer token`).

Ablaufverfolgungen

Die Laufzeit gibt für jede Agenteninteraktion einen hierarchischen Spannenbaum aus. Jeder Baum enthält eine invoke_agent Wurzelspanne mit chat und execute_tool Kinderspannen.

          `invoke_agent` Spanattribute

Umschließt den gesamten Agentaufruf: Alle LLM-Aufrufe und Toolausführungen für eine Benutzernachricht. Spanentyp: CLIENT.

Merkmal	Beschreibung
`gen_ai.operation.name`	`invoke_agent`
`gen_ai.provider.name`	Anbieter (z. B `github`. , `anthropic`)
`gen_ai.agent.id`	Sitzungs-ID
`gen_ai.agent.name`	Agentname (nur Subagenten)
`gen_ai.agent.description`	Agent-Beschreibung (nur Subagenten)
`gen_ai.agent.version`	Laufzeitversion
`gen_ai.conversation.id`	Sitzungs-ID
`gen_ai.request.model`	Angefordertes Modell
`gen_ai.response.model`	Aufgelöstes Modell
`gen_ai.response.id`	Letzte Antwort-ID
`gen_ai.response.finish_reasons`

          `["stop"]` oder `["error"]` |

          `chat` Spanattribute

Eine Spanne pro LLM-Anforderung. Spanentyp: CLIENT.

Merkmal	Beschreibung
`gen_ai.operation.name`	`chat`
`gen_ai.provider.name`	Anbietername
`gen_ai.request.model`	Angefordertes Modell
`gen_ai.conversation.id`	Sitzungs-ID
`gen_ai.response.id`	Antwort-ID
`gen_ai.response.model`	Aufgelöstes Modell
`gen_ai.response.finish_reasons`	Stoppgründe
`gen_ai.usage.input_tokens`	Eingabetokens in dieser Runde
`gen_ai.usage.output_tokens`	Ausgabetoken in dieser Runde
`gen_ai.usage.cache_read.input_tokens`	Zwischengespeicherte Token lesen
`gen_ai.usage.cache_creation.input_tokens`	Zwischengespeicherte Token erstellt
`github.copilot.cost`	Abbiegekosten
`github.copilot.aiu`	KI-Einheiten verbrauchten diese Runde
`github.copilot.server_duration`	Serverseitige Dauer
`github.copilot.initiator`	Anforderungsinitiator
`github.copilot.turn_id`	Bezeichner drehen
`github.copilot.interaction_id`	Interaktionskennung
`server.address`	Serverhostname
`server.port`	Serverport
`error.type`	Fehlerklassenname (bei Fehler)
`gen_ai.input.messages`	Vollständige Eingabeaufforderungsnachrichten als JSON (nur Inhaltserfassung)
`gen_ai.output.messages`	Vollständige Antwortnachrichten als JSON (nur Inhaltserfassung)
`gen_ai.system_instructions`	Systemaufforderungsinhalte als JSON (nur Inhaltserfassung)

          `execute_tool` Spanattribute

Eine Spanne pro Toolaufruf. Spanentyp: INTERNAL.

Merkmal	Beschreibung
`gen_ai.operation.name`	`execute_tool`
`gen_ai.provider.name`	Anbietername (sofern verfügbar)
`gen_ai.tool.name`	Werkzeugname (z. B. `readFile`)
`gen_ai.tool.type`	`function`
`gen_ai.tool.call.id`	Toolaufrufbezeichner
`gen_ai.tool.description`	Toolbeschreibung
`error.type`	Fehlerklassenname (bei Fehler)
`gen_ai.tool.call.arguments`	Tooleingabeargumente als JSON (nur Inhaltserfassung)
`gen_ai.tool.call.result`	Toolausgabe als JSON (nur Inhaltserfassung)

Metriken

GenAI-Konventionsmetriken

Metric	Typ	Einheit	Beschreibung
`gen_ai.client.operation.duration`	Histogramm	s	Dauer des LLM-API-Aufrufs und des Agentenaufrufs
`gen_ai.client.token.usage`	Histogramm	tokens	Tokenanzahl nach Typ (`input`/`output`)
`gen_ai.client.operation.time_to_first_chunk`	Histogramm	s	Zeitpunkt für den Empfang des ersten Streamingblocks
`gen_ai.client.operation.time_per_output_chunk`	Histogramm	s	Latenz zwischen den Chunks nach dem ersten Chunk

Anbieterspezifische Metriken

Metric	Typ	Einheit	Beschreibung
`github.copilot.tool.call.count`	Zähler	Anrufe	Toolaufrufe nach `gen_ai.tool.name` und `success`
`github.copilot.tool.call.duration`	Histogramm	s	Latenz der Toolausführung nach `gen_ai.tool.name`
`github.copilot.agent.turn.count`	Histogramm	dreht	LLM-Roundtrips pro Agent-Aufruf

Span-Ereignisse

Lebenszyklusereignisse, die auf der aktiven chat oder invoke_agent Zeitspanne aufgezeichnet werden.

Ereignis	Beschreibung	Schlüsselattribute
`github.copilot.session.truncation`	Der Verlauf der Unterhaltung wurde gekürzt.

          `github.copilot.token_limit`, , `github.copilot.pre_tokens``github.copilot.post_tokens`, , `github.copilot.tokens_removed``github.copilot.messages_removed` |

| github.copilot.session.compaction_start | Die Verdichtung der Geschichte begann | Nichts | | github.copilot.session.compaction_complete | Verlaufskomprimierung abgeschlossen | github.copilot.success, , github.copilot.pre_tokens``github.copilot.post_tokens, , github.copilot.tokens_removed``github.copilot.messages_removed | | github.copilot.skill.invoked | Eine Fähigkeit wurde aufgerufen | github.copilot.skill.name github.copilot.skill.path github.copilot.skill.plugin_name github.copilot.skill.plugin_version | | github.copilot.session.shutdown | Die Sitzung wird beendet. | github.copilot.shutdown_type, , github.copilot.total_premium_requests``github.copilot.lines_added, , github.copilot.lines_removed``github.copilot.files_modified_count | | github.copilot.session.abort | Der Benutzer hat den aktuellen Vorgang abgebrochen. | github.copilot.abort_reason | | exception | Sitzungsfehler | github.copilot.error_type, github.copilot.error_status_code``github.copilot.error_provider_call_id |

Ressourcenattribute

Alle Signale tragen diese Ressourcenattribute.

Merkmal	Wert
`service.name`

          `github-copilot` (konfigurierbar über `OTEL_SERVICE_NAME`) |

| service.version | Laufzeitversion |

Inhaltserfassung

Standardmäßig werden keine Eingabeaufforderungsinhalte, Antworten oder Toolargumente erfasst – nur Metadaten wie Modellnamen, Tokenanzahlen und Dauer. Um den vollständigen Inhalt zu erfassen, aktivieren Sie OTEL_INSTRUMENTATION_GENAI_CAPTURE_MESSAGE_CONTENT=true.

Warnung

Die Inhaltserfassung kann vertrauliche Informationen wie Code, Dateiinhalte und Benutzeraufforderungen enthalten. Aktivieren Sie dies nur in vertrauenswürdigen Umgebungen.

Wenn die Inhaltserfassung aktiviert ist, werden die folgenden Attribute aufgefüllt.

Merkmal	Content
`gen_ai.input.messages`	Vollständige Eingabeaufforderungsmeldungen (JSON)
`gen_ai.output.messages`	Vollständige Antwortnachrichten (JSON)
`gen_ai.system_instructions`	Systemaufforderungsinhalt (JSON)
`gen_ai.tool.definitions`	Werkzeugschemata (JSON)
`gen_ai.tool.call.arguments`	Eingabeargumente des Tools
`gen_ai.tool.call.result`	Werkzeugausgabe

Weiterführende Lektüre

        [AUTOTITLE](/copilot/how-tos/copilot-cli)

        [AUTOTITLE](/copilot/reference/copilot-cli-reference/cli-plugin-reference)

        [AUTOTITLE](/copilot/reference/copilot-cli-reference/cli-programmatic-reference)

In diesem Artikel