# Schnellstart GitHub CLI

Verwenden Sie GitHub CLI, um mit GitHub in der Befehlszeile zu arbeiten.

## Informationen zum GitHub CLI

GitHub CLI ist ein Open-Source-Tool zur Verwendung von GitHub über die Befehlszeile deines Computers. Wenn du über die Befehlszeile arbeitest, kannst du die GitHub CLI verwenden, um Zeit zu sparen und Kontextwechsel zu vermeiden.

## Voraussetzungen

1. Installiere GitHub CLI unter macOS, Windows oder Linux. Weitere Informationen finden Sie unter [Installation](https://github.com/cli/cli?ref_product=cli\&ref_type=engagement\&ref_style=text#installation) im Repository GitHub CLI.

2. Führe den folgenden Befehl im Terminal aus, um dich bei GitHub zu authentifizieren.

   ```shell
   gh auth login
   ```

3. Wähle aus, wo du dich authentifizieren möchtest:

   * Wenn du über GitHub.com auf GitHub zugreifst, wähle **GitHub.com** aus.
   * Wenn du über eine andere Domäne auf GitHub zugreifst, wähle **Other** aus, und gib dann den Hostnamen ein, z. B. `octocorp.ghe.com`.

4. Befolge die restlichen Anweisungen auf dem Bildschirm.

   GitHub CLI speichert automatisch Ihre Git-Anmeldeinformationen für Sie, wenn Sie HTTPS als bevorzugtes Protokoll für Git-Operationen auswählen und die Frage, ob Sie sich bei Git mit Ihren GitHub-Anmeldeinformationen authentifizieren möchten, mit „Ja“ beantworten. Dies kann nützlich sein, da Sie damit Git-Befehle wie `git push` und `git pull` verwenden können, ohne eine separate Anmeldeinformationsverwaltung einrichten oder SSH verwenden zu müssen.

Weitere Möglichkeiten zum Authentifizieren, einschließlich Umgebungsvariablen, GitHub Actionsund ablaufenden Token, finden Sie unter [Authentifizierung mit GitHub CLI](/de/enterprise-server@3.20/github-cli/github-cli/authenticating-with-github-cli).

## Einige hilfreiche Befehle

> [!NOTE]
> Wenn du einige Befehle zum ersten Mal verwendest – beispielsweise `gh codespace SUBCOMMAND` – wirst du aufgefordert, deinem Authentifizierungstoken zusätzliche Bereiche hinzuzufügen. Folgen Sie den Anweisungen auf dem Bildschirm.

### Ihren Status anzeigen

Geben Sie `gh status` ein, um Details zu Ihrer aktuellen Arbeit an GitHub in allen Repositories anzuzeigen, die Sie abonniert haben.

### Ein Repository anzeigen

Geben Sie `gh repo view OWNER/REPO` ein, um die Repositorybeschreibung anzuzeigen und `README.md` für das Repository. Geben Sie `gh repo view OWNER/REPO --web` ein, um das Repository in Ihrem Standardbrowser anzuzeigen.

Wenn Sie den `repo` Unterbefehl aus dem Verzeichnis eines lokalen Git-Repositorys ausführen, das über eine Remoteverbindung verfügt GitHub , können Sie weglassen `OWNER/REPO`.

### Klonen eines Repositorys

Geben Sie `gh repo clone OWNER/REPO` ein. Beispielsweise klont `gh repo clone octo-org/octo-repo` das `octo-org/octo-repo`-Repository in das Verzeichnis, von dem aus Sie diesen Befehl auf Ihrem lokalen Computer ausgeführt haben.

### Repository erstellen

Geben Sie `gh repo create` ein und befolgen Sie dann die angezeigten Anweisungen. Sie können auf GitHub ein neues, leeres Repository erstellen und es anschließend optional lokal klonen. Alternativ können Sie ein vorhandenes lokales Repository in GitHub übertragen und es optional als Remote für Ihr lokales Repository einrichten. Informationen zum Festlegen eines lokalen Verzeichnisses als Git-Repository finden Sie unter [Hinzufügen von lokal gehostetem Code zu GitHub](/de/enterprise-server@3.20/migrations/importing-source-code/using-the-command-line-to-import-source-code/adding-locally-hosted-code-to-github#initializing-a-git-repository).

### Arbeiten mit Problemen

Geben Sie `gh issue list --repo OWNER/REPO` ein, um die zuletzt erstellten Probleme aufzulisten, die derzeit für das angegebene Repository geöffnet sind. Wenn Sie den `issue` Unterbefehl aus dem Verzeichnis eines lokalen Git-Repositorys ausführen, das über eine Remoteverbindung verfügt GitHub , können Sie weglassen `--repo OWNER/REPO`. Geben Sie zum Beispiel `gh issue list --assignee "@me"` ein, um die Ihnen in diesem Repository zugewiesenen Sachverhalte aufzulisten oder `gh issue list --author monalisa`, um Probleme auflzulisten, die vom Benutzer „monalisa“ erstellt wurden.

Sie können auch ein neues Problem erstellen, [Ein Problem erstellen](/de/enterprise-server@3.20/issues/tracking-your-work-with-issues/using-issues/creating-an-issue#creating-an-issue-with-github-cli) anzeigen oder nach einem Problem suchen, siehe [Filtern und Suchen von Problemen und Pull-Anforderungen](/de/enterprise-server@3.20/issues/tracking-your-work-with-issues/using-issues/filtering-and-searching-issues-and-pull-requests?tool=cli#searching-for-issues-and-pull-requests).

### Umgang mit Pull Requests

Geben Sie `gh pr list --repo OWNER/REPO` ein, um die zuletzt erstellten Pull Requests aufzulisten, die derzeit für das angegebene Repository geöffnet sind. Wenn Sie den `pr` Unterbefehl aus dem Verzeichnis eines lokalen Git-Repositorys ausführen, das über eine Remoteverbindung verfügt GitHub , können Sie weglassen `--repo OWNER/REPO`. Geben Sie beispielsweise `gh pr list --author "@me"` ein, um offene Pull Requests aufzulisten, die Sie in diesem Repository erstellt haben.

Geben Sie `gh pr list --label LABEL-NAME` ein, um offene Pull Requests mit einer bestimmten Bezeichnung aufzulisten. Geben Sie `gh search prs --review-requested=@me --state=open` für Pull-Requests ein, zu deren Überprüfung Sie aufgefordert wurden.

Um eine Pull Request zu erstellen, geben Sie `gh pr create` ein und folgen Sie den Anweisungen auf dem Bildschirm. Weitere Informationen finden Sie unter [Erstellen eines Pull Requests](/de/enterprise-server@3.20/pull-requests/how-tos/create-pull-requests/creating-a-pull-request?tool=cli#creating-the-pull-request).

### Arbeiten mit Codespaces

Um einen neuen Codespace zu erstellen, geben Sie `gh codespace create` ein und folgen Sie den Anweisungen auf dem Bildschirm.

Um Ihre vorhandenen Codespaces anzuzeigen, geben Sie `gh codespace list` ein. Um einen Codebereich in der Webversion von VS Code zu öffnen, geben Sie `gh codespace code -w` ein und wählen Sie einen Codebereich aus.

In all diesen Befehlen können Sie `cs` durch `codespace` ersetzen.

## Hilfe erhalten

Geben Sie `gh` ein, um eine Übersicht der Befehle der obersten Ebene GitHub CLI anzuzeigen, die Sie verwenden können. Beispiele: `issue`, `pr`, `repo` und so weiter

Für jeden Befehl und jeden untergeordneten Unterbefehl können Sie die Kennzeichnung `--help` anhängen, um herauszufinden, wie er verwendet wird. Zum Beispiel: `gh issue --help` oder `gh issue create --help`.

## Anpassen GitHub CLI

Sie können Konfigurationseinstellungen ändern und Aliasse oder Erweiterungen hinzufügen, damit GitHub CLI genau so funktioniert, wie es für Sie am besten passt.

* Geben Sie `gh config set SUBCOMMANDS` ein, um die Einstellungen von GitHub CLI zu konfigurieren, und ersetzen Sie `SUBCOMMANDS` durch die Einstellung, die Sie anpassen möchten.

  Sie können beispielsweise den Texteditor angeben, der verwendet wird, wenn Sie mit einem GitHub CLI-Befehl Text bearbeiten müssen – z. B. wenn Sie den Fließtext für ein neues Issue hinzufügen, das Sie neu erstellen. Um Ihren bevorzugten Texteditor auf Visual Studio Code festzulegen, geben Sie `gh config set editor "code -w"` ein. Das `-w`-Flag (oder `--wait`) in diesem Beispiel bewirkt, dass der Befehl wartet, bis die Datei in Visual Studio Code geschlossen wird, bevor in Ihrem Terminal mit dem nächsten Schritt fortgefahren wird.

  Weitere Informationen finden Sie unter [`gh config set`](https://cli.github.com/manual/gh_config_set).

* Definiere Aliase für Befehle, die du häufig ausführst. Wenn du z. B. `gh alias set prd "pr create --draft"` ausführst, kannst du `gh prd` ausführen, um schnell einen Entwurfs-Pull Request zu öffnen. Weitere Informationen finden Sie unter [`gh alias`](https://cli.github.com/manual/gh_alias).

* Erstellen oder Hinzufügen von benutzerdefinierten Befehlen mit GitHub CLI Erweiterungen. Weitere Informationen finden Sie unter [Verwenden von GitHub CLI-Erweiterungen](/de/enterprise-server@3.20/github-cli/github-cli/using-github-cli-extensions) und [Erstellen GitHub CLI-Erweiterungen](/de/enterprise-server@3.20/github-cli/github-cli/creating-github-cli-extensions).

## Verwenden von GitHub CLI mit mehreren Konten

Wenn Sie über mehrere Konten auf derselben GitHub Plattform verfügen, z Ihre GitHub Enterprise Server-Instance. B. , können Sie sich bei jedem authentifizieren und mithilfe des `gh auth switch` Befehls zwischen diesen wechseln. Siehe [gh auth switch](https://cli.github.com/manual/gh_auth_switch) im GitHub CLI Handbuch.

Wenn Sie das GitHub CLI plattformübergreifend auf mehreren GitHub Plattformen verwenden müssen, z. B. ein persönliches Konto auf GitHub.com und ein verwaltetes Benutzerkonto auf GHE.com, siehe [Verwenden der GitHub CLI auf GitHub Plattformen](/de/enterprise-server@3.20/github-cli/github-cli/using-multiple-accounts).

## Weitere Informationen

* [Authentifizierung mit GitHub CLI](/de/enterprise-server@3.20/github-cli/github-cli/authenticating-with-github-cli)
* [GitHub CLI-Referenz](/de/enterprise-server@3.20/github-cli/github-cli/github-cli-reference)
* [
  GitHub CLI Onlinehandbuch](https://cli.github.com/manual/gh)