Verwenden von GitHub Copilot CLI

Über die Befehlszeilenschnittstelle (CLI) für GitHub Copilot kannst du Copilot direkt von deinem 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

1. Navigiere in deinem Terminal zu einem Ordner, der Code enthält, mit dem du arbeiten möchtest.

2. Gib copilot ein, um Copilot CLI zu starten.

   Du wirst durch Copilot aufgefordert, zu bestätigen, dass du den Dateien in diesem Ordner vertraust.

   Wichtig

   Während dieser GitHub Copilot-CLI-Sitzung versucht Copilot möglicherweise, Dateien in und unter diesem Ordner 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.

3. Wählen Sie eine der Optionen:

          **1. Ja, fortfahren**:
   

   Copilot kann nur für diese Sitzung mit den Dateien an diesem Speicherort 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. Du wirst nicht erneut gefragt, wenn du Copilot CLI aus diesem Ordner startest. Wähle diese Option nur aus, wenn du sicher bist, dass es immer sicher ist, dass Copilot mit Dateien an diesem Speicherort arbeiten.

          **3. Nein, Exit (Esc)**:
   

   Beende deine Copilot CLI-Sitzung.

4. Wenn du derzeit nicht bei GitHub angemeldet bist, wirst du aufgefordert, den Schrägstrichbefehl /login zu verwenden. Gib diesen Befehl ein, und befolge die Anweisungen auf dem Bildschirm, um dich zu authentifizieren.

5. Gib in der CLI einen Prompt ein.

   Dabei kann es ich um eine einfache Chatfrage oder eine Anforderung von Copilot handeln, um eine bestimmte Aufgabe wie das Beheben eines Fehlers, das Hinzufügen eines Features zu einer vorhandenen Anwendung oder das Erstellen einer neuen Anwendung auszuführen.

   Einige Beispiele für Prompts findest du unter Über GitHub Copilot CLI.

6. Wenn Copilot ein Tool verwenden möchte, das Dateien ändern oder ausführen kann (Beispiel: touch, chmod, node oder sed), wirst du aufgefordert, die Verwendung des Tools zu genehmigen.

   Wählen Sie eine der Optionen:

          **1. Ja**:
   

   Lasse zu, dass Copilot dieses Tool verwendet. Wenn Copilot dieses Tool das nächste Mal verwenden möchte, wirst du aufgefordert, es erneut zu genehmigen.

          **2. Ja, und genehmigen Sie TOOL für den Rest der laufenden Sitzung**:
   

   Lasse zu, dass Copilot dieses Tool mit allen Optionen verwenden kann, ohne den Rest der aktuell ausgeführten Sitzung erneut zu fragen. 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, können Copilot alle Dateien im aktuellen Verzeichnis oder deren Unterverzeichnisse löschen, 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. Du kannst Copilot anweisen, die Aufgabe fortzusetzen, jedoch einen anderen Ansatz zu verwenden.

   Beispiel: Wenn du Copilot anweist, ein Bash-Skript zu erstellen, das Skript jedoch nicht verwenden möchtest, das Copilot vorschlägt, kannst du den aktuellen Vorgang beenden und einen neuen Prompt Continue the previous task but include usage instructions in the script eingeben.

   Wenn Sie eine Berechtigungsanfrage für ein Tool ablehnen, können Sie auch Copilot Inline-Feedback zur Ablehnung geben, damit das Tool seinen Ansatz anpassen kann, ohne vollständig anzuhalten.

Tipps

Optimiere deine Verwendung von Copilot CLI mit den folgenden Tipps.

Beenden eines aktuell ausgeführten Vorgangs

Wenn du einen Prompt eingibst und dann entscheidest, Copilot noch während des „Denkprozesses“ daran zu hindern, die Aufgabe abzuschließen, drücke ESC.

Planmodus verwenden

Im Planmodus können Sie mit Copilot an einem Implementierungsplan zusammenarbeiten, 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 deinem Prompt als Kontext für Copilot hinzugefügt.

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, muss Copilot möglicherweise mit Dateien arbeiten, die sich außerhalb des aktuellen Arbeitsverzeichnisses befinden. Wenn Copilot durch einen Prompt, den du in einer interaktiven Sitzung eingegeben hast, eine Datei außerhalb des aktuellen Speicherorts ändern muss, wirst du aufgefordert, den Zugriff auf das Verzeichnis der Datei zu gewähren.

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 oder /cd Befehle 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 bringen.

copilot --continue

Verwenden benutzerdefinierter Anweisungen

Du kannst die Leistung von Copilot verbessern, indem du dem Repository, in dem du arbeitest, benutzerdefinierte Anweisungen hinzufügst. 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. Dadurch kann Copilot den Kontext deines Projekts besser verstehen und auf deine Prompts reagieren.

Copilot CLI unterstützt Folgendes:

• 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.

Verwenden Sie Benutzerdefinierte Agenten

Benutzerdefinierter Agent ist eine spezielle Version von Copilot. Benutzerdefinierte Agents helfen Copilot bei der Verarbeitung eindeutiger Workflows, bestimmter Codierungskonventionen und fachspezifischer Anwendungsfälle.

Copilot CLI enthält eine Standardgruppe von Benutzerdefinierte Agenten für häufige Aufgaben:

Das von der CLI verwendete KI-Modell kann sich entscheiden, eine Aufgabe an einen untergeordneten Subagentprozess zu delegieren, der mit einem Benutzerdefinierter Agent mit spezifischem Fachwissen arbeitet, wenn dies zu einer effektiveren Fertigstellung der Arbeit führen würde. Das Modell kann sich ebenso dafür entscheiden, die Arbeit direkt im Hauptagent zu verarbeiten.

Sie können Ihre eigenen Benutzerdefinierte Agenten mithilfe von Markdown-Dateien erstellen, die als Agentenprofile bezeichnet werden. Diese geben an, welches Fachwissen der Agent haben soll, welche Tools verwendet werden können, sowie spezifische Anweisungen, wie er reagieren soll.

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

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

| Organisations- 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:

• Verwendung des Slash-Befehls in der interaktiven Benutzeroberfläche der CLI zur Auswahl aus der Liste der verfügbaren Benutzerdefinierte Agenten:

  /agent
  

• Direktes Aufrufen von Benutzerdefinierter Agent in einem Prompt:

  Use the refactoring agent to refactor this code block
  

  Copilot ermittelt automatisch den Agent, den Sie verwenden möchten.

• Angeben der Benutzerdefinierter Agent, die du mit der Kommandozeile verwenden möchtest. 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 Fertigkeiten erstellen, um die Fähigkeit von Copilot zu verbessern, spezielle Aufgaben mit Anweisungen, Skripten und Ressourcen auszuführen.

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

Hinzufügen eines MCP-Servers

Für Copilot CLI ist der MCP-Server von GitHub bereits konfiguriert. Mit diesem MCP-Server kannst du beispielsweise mit Ressourcen auf GitHub.com so interagieren, dass du Pull Requests von der CLI mergen kannst.

Du kannst weitere MCP-Server hinzufügen, um die für dich in Copilot CLI verfügbare Funktionalität zu erweitern:

1. Verwende den folgenden Schrägstrichbefehl:

   /mcp add
   

2. Gib die Details für den MCP-Server ein, den du hinzufügen möchtest, und verwende die TABULATORTASTE, um zwischen Feldern zu wechseln.

3. 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 bietet mehrere Schrägstrichbefehle, 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 Token-Limits erreicht, ohne Ihren Arbeitsablauf zu unterbrechen.

Alle Berechtigungen aktivieren

In Situationen, in denen Sie Copilot uneingeschränkt laufen lassen möchten, können Sie entweder --allow-all oder --yolo aktivieren, um alle Berechtigungen gleichzeitig zu ermöglichen.

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 an komplexen Problemen arbeitet.

Weitere Informationen

Führe eine der folgenden Aktionen aus, um eine vollständige Liste der Befehlszeilenoptionen und Schrägstrichbefehle zu erhalten, die du mit Copilot CLI verwenden kannst:

• 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 Copilot CLI auswirken:
  

  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 Gesprächsassistent arbeiten, Fragen beantworten und Ihnen helfen, Code interaktiv zu schreiben. Über den Chat hinaus unterstützt Copilot CLI eine Reihe von agentischen Modi, mit denen Sie Aufgaben mit größerer Autonomie delegieren können.

Sie können mit Agenten in Copilot CLI arbeiten, um einen vollständigen Lebenszyklus von Aufgaben zu unterstützen, von der Delegierung der Arbeit bis hin zur Begutachtung 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überprüfung an**: Verwenden Sie 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/acp-server)