Verwenden von GitHub Copilot CLI

Mit der Befehlszeilenschnittstelle (CLI) für GitHub Copilot können Sie Copilot direkt von Ihrem Terminal aus verwenden. Weitere Informationen finden Sie unter Über GitHub Copilot CLI.

Voraussetzung

Installiere Copilot CLI. Weitere Informationen findest du unter Installieren von GitHub Copilot CLI.

Verwenden von Copilot CLI

Navigiere in deinem Terminal zu einem Ordner, der Code enthält, mit dem du arbeiten möchtest.
Geben Sie copilot ein, um zu starten Copilot CLI.
```
       Copilot sie werden aufgefordert, zu bestätigen, dass Sie den Dateien in diesem Ordner vertrauen.
```
Wichtig

Während dieser GitHub Copilot-CLI Sitzung kann Copilot versuchen, Dateien in diesem Ordner und darunter liegenden zu lesen, zu ändern und auszuführen. Du solltest den Vorgang nur fortsetzen, wenn du den Dateien an diesem Speicherort vertraust. Weitere Informationen zu vertrauenswürdigen Verzeichnissen findest du unter Über GitHub Copilot CLI.
Wählen Sie eine der Optionen:
```
       **1. Ja, fortfahren**:


       Copilot kann nur an diesem Speicherort für diese Sitzung mit den Dateien arbeiten.


       **2. Ja, und denken Sie sich an diesen Ordner für zukünftige Sitzungen**:
```
Du vertraust den Dateien in diesem Ordner für diese und zukünftige Sitzungen. Sie werden nicht erneut gefragt, wenn Sie Copilot CLI von diesem Ordner aus starten. Wählen Sie diese Option nur aus, wenn Sie sicher sind, dass es immer sicher Copilot ist, mit Dateien an diesem Speicherort zu arbeiten.
```
       **3. Nein, Exit (Esc)**:
```
Beenden Sie Ihre Copilot CLI Sitzung.
Wenn Sie zurzeit nicht bei GitHub angemeldet sind, werden Sie aufgefordert, den /login-Slash-Befehl zu verwenden. Gib diesen Befehl ein, und befolge die Anweisungen auf dem Bildschirm, um dich zu authentifizieren.
Gib in der CLI einen Prompt ein.

Dies kann eine einfache Chatfrage oder eine Anforderung zum Copilot Ausführen einer bestimmten Aufgabe sein, z. B. das Beheben eines Fehlers, das Hinzufügen eines Features zu einer vorhandenen Anwendung oder das Erstellen einer neuen Anwendung.

Einige Beispiele für Prompts findest du unter Über GitHub Copilot CLI.
Wenn Copilot ein Tool verwendet werden soll, mit dem Dateien Beispiel: touch, chmod, node oder sed geändert oder ausgeführt werden können, werden Sie aufgefordert, die Verwendung des Tools zu genehmigen.

Wählen Sie eine der Optionen:
```
       **1. Ja**:
```
Erlauben Sie Copilot, dieses Tool zu verwenden. Wenn Sie dieses Tool das nächste Mal Copilot verwenden möchten, werden Sie aufgefordert, es erneut zu genehmigen.
```
       **2. Ja, und genehmigen Sie TOOL für den Rest der laufenden Sitzung**:
```
Erlauben Sie Copilot, dieses Tool mit allen Optionen ohne erneut zu fragen für den Rest der derzeit ausgeführten Sitzung zu verwenden. Alle ausstehenden parallelen Berechtigungsanforderungen desselben Typs werden automatisch genehmigt. Du musst den Befehl in zukünftigen Sitzungen erneut genehmigen.

Die Auswahl dieser Option ist nützlich für viele Tools, wie chmod, da sie verhindert, dass Sie ähnliche Befehle in derselben Sitzung wiederholt genehmigen müssen. Beachten Sie jedoch die Sicherheitsauswirkungen dieser Option. Wenn Sie z. B. diese Option für den Befehl rm auswählen, kann Copilot jede Datei im aktuellen Verzeichnis oder den Unterverzeichnissen gelöscht werden, ohne ihre Genehmigung zu verlangen.
```
       **3. Nein, und sagen Sie Copilot, was anders gemacht werden soll (Esc)**:


       Copilot führt den Befehl nicht aus. Stattdessen wird der aktuelle Vorgang beendet, und der nächste Prompt wird erwartet. Sie können Copilot anweisen, die Aufgabe fortzusetzen, aber mit einem anderen Ansatz.
```
Wenn Sie z. B. Copilot bitten, ein Bash-Skript zu erstellen, aber das von Copilot vorgeschlagene Skript nicht verwenden möchten, können Sie den aktuellen Vorgang beenden und eine neue Eingabe wie: Continue the previous task but include usage instructions in the script eingeben.

Wenn Sie eine Toolberechtigungsanforderung ablehnen, können Sie auch inline Feedback zur Ablehnung geben Copilot , damit sie ihren Ansatz anpassen kann, ohne vollständig zu stoppen.

Tipps

Optimieren Sie Ihre Erfahrung mit Copilot CLI mit den folgenden Tipps.

Beenden eines aktuell ausgeführten Vorgangs

Wenn Sie eine Eingabeaufforderung eingeben und dann beschließen, dass Sie Copilot daran hindern möchten, während es noch "Denken" anzeigt, drücken Sie Esc.

Planmodus verwenden

Im Planungsmodus können Sie an einem Implementierungsplan mit Copilot arbeiten, bevor Code geschrieben wird. Drücken Sie Shift+Tabulator, um zwischen Planmodus und anderem Modus zu wechseln.

Einschließen einer bestimmten Datei im Prompt

Um deinem Prompt eine bestimmte Datei hinzuzufügen, verwende @ gefolgt vom relativen Pfad zur Datei. Beispiel: Explain @config/ci/ci-required-checks.yml oder Fix the bug in @src/app.js. Dadurch wird der Inhalt der Datei als Kontext zu Ihrem Eingabeaufforderungstext hinzugefügt Copilot.

Wenn du mit der Eingabe eines Dateipfads beginnst, werden die übereinstimmenden Pfade unterhalb des Promptfelds angezeigt. Verwende die Pfeiltasten, um einen Pfad auszuwählen, und drücke TAB, um den Pfad im Prompt zu vervollständigen.

Arbeiten mit Dateien an einem anderen Speicherort

Um eine Aufgabe abzuschließen, müssen Sie möglicherweise mit Dateien arbeiten, Copilot die sich außerhalb des aktuellen Arbeitsverzeichnisses befinden. Wenn eine Aufforderung, die Sie in eine interaktive Sitzung eingegeben haben, eine Datei außerhalb des aktuellen Speicherorts ändern muss Copilot , werden Sie aufgefordert, den Zugriff auf das Verzeichnis der Datei zu genehmigen.

Du kannst ein vertrauenswürdiges Verzeichnis außerdem jederzeit manuell hinzufügen, indem du den Schrägstrichbefehl verwenden:

/add-dir /path/to/directory

Wenn sich alle Dateien, mit denen Sie arbeiten möchten, an einem anderen Speicherort befinden, können Sie das aktuelle Arbeitsverzeichnis wechseln, ohne eine neue Copilot CLI Sitzung zu starten, indem Sie entweder die /cwd Befehle oder /cd Schrägstriche verwenden:

/cwd /path/to/directory

Ausführen von Shellbefehlen

Sie können ! vor Ihre Eingaben setzen, um Shell-Befehle direkt auszuführen, ohne einen Aufruf an das Modell zu machen.

!git clone https://github.com/github/copilot-cli

Fortsetzen einer interaktiven Sitzung

Sie können die Befehlszeilenoption --resume oder den /resume Schrägstrich-Befehl verwenden, um eine interaktive CLI-Sitzung auszuwählen und fortzusetzen, sodass Sie mit dem gespeicherten Kontext direkt an der Stelle, an der Sie aufgehört haben, aufnehmen können. Sie können eine Copilot Codierungsassistent-Sitzung auf GitHub starten und dann GitHub Copilot-CLI verwenden, um diese Sitzung in Ihre lokale Umgebung zu übertragen.

Tipp

Um die zuletzt geschlossene lokale Sitzung schnell fortzusetzen, geben Sie dies in Ihr Terminal ein:

copilot --continue

Verwenden benutzerdefinierter Anweisungen

Sie können die Leistung von Copilot verbessern, indem Sie dem Repository, in dem Sie arbeiten, benutzerdefinierte Anweisungen hinzufügen. Benutzerdefinierte Anweisungen sind Beschreibungen in natürlicher Sprache, die in Markdowndateien im Repository gespeichert sind. Sie werden automatisch in Prompts eingeschlossen, die du während der Arbeit in diesem Repository eingibst. Dies hilft Copilot Ihnen, den Kontext Ihres Projekts besser zu verstehen und angemessen auf Ihre Eingabeaufforderungen zu reagieren.

          Copilot CLI unterstützt:

Repositoryweite Anweisungen in der Datei .github/copilot-instructions.md
Pfadspezifische Anweisungsdateien: .github/instructions/**/*.instructions.md
Agent-Dateien wie AGENTS.md

Weitere Informationen finden Sie unter Hinzufügen von benutzerdefinierten Befehlen für GitHub Copilot-CLI.

          Benutzerdefinierte Agenten verwenden

A Benutzerdefinierter Agent ist eine spezielle Version von Copilot. Benutzerdefinierte Agents Helfen Sie bei der Copilot Behandlung eindeutiger Workflows, bestimmter Codierungskonventionen und fachspezifischer Anwendungsfälle.

          Copilot CLI enthält eine Standardgruppe von Benutzerdefinierte Agenten für allgemeine Aufgaben.

Agent	Beschreibung
Erkunden	Führt eine schnelle Analyse des Code-Repositories durch, sodass Sie Fragen zu Ihrem Code stellen können, ohne zum Hauptkontext beizutragen.
Aufgabe	Führt Befehle wie zum Beispiel Tests und Builds aus und liefert bei Erfolg kurze Zusammenfassungen und bei Fehlern die vollständige Ausgabe.
Allgemeiner Zweck	Behandelt komplexe, mehrstufige Aufgaben, die das vollständige Toolset und eine qualitativ hochwertige Argumentation erfordern, die in einem separaten Kontext ausgeführt wird, damit Ihre Hauptkommunikation klar fokussiert bleibt.
Codeüberprüfung	Überprüft Änderungen mit dem Fokus auf das Hervorheben nur echter Probleme, um Rauschen zu minimieren.

Das KI-Modell, das von der CLI verwendet wird, kann entscheiden, eine Aufgabe an einen Subagentprozess mit spezifischem Fachwissen zu delegieren, wenn es der Meinung ist, dass dadurch die Arbeit effektiver abgeschlossen wird. Das Modell kann sich ebenso dafür entscheiden, die Arbeit direkt im Hauptagent zu verarbeiten.

Sie können Ihr eigenes Benutzerdefinierte Agenten mithilfe von Markdown-Dateien definieren, die Agentenprofile genannt werden. Diese geben an, welche Expertise der Agent haben soll, welche Werkzeuge er verwenden kann und enthalten alle spezifischen Anweisungen für seine Reaktionen.

Sie können auf Benutzer-, Repository- oder Organisations-/Unternehmensebene definieren Benutzerdefinierte Agenten :

Typ	Ort	Geltungsbereich
Benutzerebene Benutzerdefinierter Agent	lokales `~/.copilot/agents` Verzeichnis	Alle Projekte
Repository-Ebene Benutzerdefinierter Agent

          `.github/agents` Verzeichnis in Ihren lokalen und Remote-Repositories | Aktuelles Projekt |

| Organisation und Unternehmensebene Benutzerdefinierter Agent | /agents Verzeichnis im .github-private Repository in einer Organisation oder einem Unternehmen | Alle Projekte unter Ihrem Organisations- und Unternehmenskonto |

Bei Namenskonflikten überschreibt ein Agent auf Systemebene einen Agenten auf Repository-Ebene, und der Agent auf Repository-Ebene würde einen Agenten auf Organisationsebene überschreiben.

          Benutzerdefinierte Agents kann auf drei Arten verwendet werden:

Verwenden des Schrägstrichbefehls in der interaktiven Benutzeroberfläche der CLI, um aus der Liste der verfügbaren Benutzerdefinierte AgentenOptionen auszuwählen:
```
/agent
```

Direkter Aufruf von Benutzerdefinierter Agent in einer Eingabeaufforderung:

Use the refactoring agent to refactor this code block

        Copilot leitet automatisch den Agent ab, den Sie verwenden möchten.

Geben Sie das Benutzerdefinierter Agent an, das Sie mit der Befehlszeilenoption verwenden möchten. Beispiel:
```
copilot --agent=refactor-agent --prompt "Refactor this code block"
```

Weitere Informationen finden Sie unter Erstellen benutzerdefinierter Agents für Copilot Codierungsassistent.

Verwenden von Fähigkeiten

Sie können Fähigkeiten erstellen, um die Fähigkeit Copilot zu verbessern, spezielle Aufgaben mit Anweisungen, Skripts und Ressourcen auszuführen.

Weitere Informationen finden Sie unter Erstellen von Agentenfertigkeiten für GitHub Copilot-CLI.

Hinzufügen eines MCP-Servers

          Copilot CLI ist bereits mit dem GitHub MCP-Server konfiguriert. Dieser MCP-Server ermöglicht Ihnen, mit Ressourcen auf GitHub.com zu interagieren, sodass Sie Pull-Requests aus der CLI zusammenführen können.

Um die in Copilot CLI verfügbaren Funktionen zu erweitern, können Sie weitere MCP-Server hinzufügen.

Verwende den folgenden Schrägstrichbefehl:
```
/mcp add
```
Gib die Details für den MCP-Server ein, den du hinzufügen möchtest, und verwende die TABULATORTASTE, um zwischen Feldern zu wechseln.
Drücke Strg+S, um die Details zu speichern.

Die Details deiner konfigurierten MCP-Server werden in der Datei mcp-config.json gespeichert, die sich standardmäßig im Verzeichnis ~/.copilot befindet. Dieser Speicherort kann durch Festlegen der Umgebungsvariablen COPILOT_HOME geändert werden. Informationen zur JSON-Struktur einer Serverdefinition findest du unter Erweiterung des GitHub Copilot Codierungsagenten mit dem Model Context Protocol (MCP).

Context-Management

          Copilot CLI stellt mehrere Schrägstrichbefehle bereit, mit denen Sie Ihr Kontextfenster überwachen und verwalten können:

* /usage: Hiermit können Sie Ihre Sitzungsstatistiken anzeigen, einschließlich:

Die Anzahl der in der aktuellen Sitzung verwendeten Premium-Anfragen
Die Sitzungsdauer
Alle zeilen des bearbeiteten Codes
Eine Aufschlüsselung der Tokenverwendung pro Modell

        `/context`: Bietet eine visuelle Übersicht über die aktuelle Tokenverwendung.

        `/compact`: Manuell komprimiert Ihren Gesprächsverlauf, um Kontextplatz freizugeben.

        GitHub Copilot-CLI komprimiert ihren Verlauf automatisch im Hintergrund, wenn ihre Unterhaltung 95% des Tokenlimits angreift, ohne den Workflow zu unterbrechen.

Alle Berechtigungen aktivieren

In Situationen, in denen Sie darauf vertrauen, dass Copilot frei ausgeführt wird, können Sie die Berechtigungen alle auf einmal mit den Kennzeichnungen --allow-all oder --yolo aktivieren.

Sichtbarkeit der Begründung ein-/ausblenden

Drücken Sie STRG+T , um den Grundprozess des Modells ein- oder auszublenden, während er eine Antwort generiert. Diese Einstellung wird über Sitzungen hinweg beibehalten, sodass Sie beobachten können, wie Copilot komplexe Probleme löst.

Weitere Informationen

Führen Sie eine der folgenden Aktionen aus, um eine vollständige Liste der Befehlszeilenoptionen und Slash-Befehle anzuzeigen, die Sie mit Copilot CLI verwenden können.

Gib ? in das Promptfeld einer interaktiven Sitzung ein.
Gib copilot help in deinem Terminal ein.

Verwende in deinem Terminal einen der folgenden Befehle, um weitere Informationen zu erhalten:

```
        **Konfigurationseinstellungen**:
```
copilot help config

Du kannst die Konfigurationseinstellungen anpassen, indem du die Datei config.json bearbeitest, die sich standardmäßig im Verzeichnis ~/.copilot befindet. Dieser Speicherort kann durch Festlegen der Umgebungsvariablen COPILOT_HOME geändert werden.

        **Umgebungsvariablen** , die sich auf Folgendes auswirken Copilot CLI:

copilot help environment

        **Verfügbare Protokollierungsstufen**:

copilot help logging

        **Berechtigungen** zur Erlaubnis oder Verweigerung der Nutzung des Tools:

copilot help permissions

Feedback

Sende dein Feedback zur GitHub Copilot-CLI an uns, indem du in einer interaktiven Sitzung den Schrägstrichbefehl /feedback verwendest und eine der Optionen auswählst. Du kannst an einer privaten Feedbackumfrage teilnehmen, einen Fehlerbericht übermitteln oder ein neues Feature vorschlagen.

Nächste Schritte

          Copilot CLI kann als Unterhaltungsassistent arbeiten, Fragen beantworten und Ihnen helfen, Code interaktiv zu schreiben. Über den Chat hinaus unterstützt Copilot CLI eine Reihe von Modi mit agentiver Funktionalität, mit denen Sie Aufgaben mit größerer Autonomie delegieren können.

Sie können mit Agents in Copilot CLI zusammenarbeiten, um den gesamten Lebenszyklus einer Aufgabe zu unterstützen, von der Delegierung der Arbeit bis zur Überprüfung der Ergebnisse.

        **Delegieren Sie Aufgaben autonom**: Führen Sie Copilot CLI im Autopilot-Modus aus, um mehrstufige Aufgaben auszuführen, ohne dass bei jedem Schritt eine Genehmigung erforderlich ist. Weitere Informationen findest du unter [AUTOTITLE](/copilot/how-tos/copilot-cli/use-copilot-cli-agents/delegate-tasks-to-cca).

        **Aufrufen von benutzerdefinierten Agents: Rufen Sie** spezielle Agents auf, die auf bestimmte Aufgaben zugeschnitten sind, z. B. Codeüberprüfung, Dokumentation oder Sicherheitsüberwachungen. Weitere Informationen findest du unter [AUTOTITLE](/copilot/how-tos/copilot-cli/use-copilot-cli-agents/invoke-custom-agents).

        **Agenten steuern**: Führen und verfeinern Sie das Verhalten der Agenten während der Aufgabenausführung, um die Arbeit auf Kurs zu halten. Siehe [AUTOTITLE](/copilot/how-tos/copilot-cli/use-copilot-cli-agents/steer-agents).

        **Fordern Sie eine Code-Review an**: Verwenden Sie dazu Copilot CLI, um eine KI-gestützte Überprüfung Ihrer Codeänderungen zu erhalten. Weitere Informationen findest du unter [AUTOTITLE](/copilot/how-tos/copilot-cli/use-copilot-cli-agents/agentic-code-review).

Weiterführende Lektüre

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

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

        [AUTOTITLE](/copilot/reference/copilot-cli-reference/cli-config-dir-reference)

        [AUTOTITLE](/copilot/reference/copilot-cli-reference/acp-server)

Wer kann dieses Feature verwenden?

In diesem Artikel