{"meta":{"title":"Einrichten und Verwenden GitHub Copilot CLI","intro":"Konfigurieren Sie einen Modellanbieter für Ihre GitHub Enterprise Server Instanz, und verbinden Sie Copilot CLI dann Clients mit der Instanz.","product":"Unternehmensadministratoren","breadcrumbs":[{"href":"/de/enterprise-server@3.22/admin","title":"Unternehmensadministratoren"},{"href":"/de/enterprise-server@3.22/admin/github-copilot","title":"GitHub Copilot"},{"href":"/de/enterprise-server@3.22/admin/github-copilot/copilot-cli","title":"Copilot CLI"},{"href":"/de/enterprise-server@3.22/admin/github-copilot/copilot-cli/set-up-and-use-copilot-cli","title":"Copilot CLI einrichten und verwenden"}],"documentType":"article"},"body":"# Einrichten und Verwenden GitHub Copilot CLI\n\nKonfigurieren Sie einen Modellanbieter für Ihre GitHub Enterprise Server Instanz, und verbinden Sie Copilot CLI dann Clients mit der Instanz.\n\n> \\[!NOTE]\n> Diese Funktion befindet sich in Technische Vorschau und kann Änderungen unterliegen.\n\nSie können Copilot CLI so konfigurieren, dass es mit GitHub Enterprise Server in isolierten oder air-gapped Umgebungen ohne Verbindung zur GitHub Cloud funktioniert. Ein Administrator konfiguriert einen Modellanbieter für die Instanz, und Benutzer stellen eine Verbindung mit ihren Copilot CLI Anmeldeinformationen herGitHub Enterprise Server.\n\nDas Einrichten dieses Features umfasst zwei Rollen:\n\n* **Administrator**: Konfiguriert den Modellanbieter auf der GitHub Enterprise Server-Instanz mit `ghe-config`. Dies ist ein einmaliges Setup, das administrativen SSH-Zugriff erfordert.\n* **Endbenutzer**: Legt Umgebungsvariablen auf einem lokalen Computer fest, um eine Verbindung mit der Instanz herzustellen Copilot CLI .\n\n## Voraussetzungen\n\n* Sie haben Administrator-SSH-Zugriff auf die GitHub Enterprise Server Instanz.\n* Sie verfügen über einen API-Schlüssel von einem unterstützten LLM-Anbieter.\n* Copilot CLI wird auf Clientcomputern installiert. Siehe [Installation von GitHub Copilot CLI](/de/enterprise-cloud@latest/copilot/how-tos/copilot-cli/set-up-copilot-cli/install-copilot-cli).\n* GitHub CLI (`gh`) wird auf Clientcomputern installiert. Siehe [GitHub CLI Handbuch](https://cli.github.com/manual/) in der GitHub CLI Dokumentation.\n\nInformationen zu unterstützten Anbietern und Modellanforderungen finden Sie unter [Verwenden Ihrer eigenen LLM-Modelle in GitHub Copilot CLI](/de/enterprise-cloud@latest/copilot/how-tos/copilot-cli/customize-copilot/use-byok-models).\n\n## Konfigurieren Ihrer GitHub Enterprise Server Instanz\n\nDieser Schritt richtet sich an den Operator oder Administrator der GitHub Enterprise Server Instanz.\n\nKonfigurieren Sie mit administrativem SSH-Zugriff auf die GitHub Enterprise Server Instanz den Modellanbieter mithilfe der folgenden `ghe-config` Werte. Führen Sie nach dem Konfigurieren die `ghe-config-apply` Schritte aus, um die Änderungen anzuwenden.\n\n| Variablenname | Erforderlich | Optionen | Description |\n| ----------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------- | --------------------- | ------------------------------------------------------------------------------------------------------------------------------------ |\n| `app.copilot-proxy.enabled` | Yes | | |\n| `true`, `false` | Aktiviert oder deaktiviert das Feature. | | |\n| `app.copilot-proxy.endpoint-url` | Yes | URI | Die vollständige Upstream-Basis-URL einschließlich eines beliebigen Versionspräfixes (z. B. `https://api.openai.com/v1`). |\n| `secrets.copilot-proxy.endpoint-key` | Yes | String | Der API-Schlüssel für den Upstreamanbieter. |\n| `app.copilot-proxy.provider-model-id` | Yes | String | Die Modell-ID des Anbieters, die Copilot CLI zur internen Identifizierung des Modells verwendet. |\n| `app.copilot-proxy.provider-type` | Yes | | |\n| `openai`, `azure``anthropic` | Der Anbietertyp. OpenAI umfasst OpenAI, Ollama, vLLM, Foundry Local und alle anderen openAI Chat Completions API-kompatiblen Endpunkte. | | |\n| `app.copilot-proxy.upstream-timeout` | No | Ganzzahl, in Sekunden | Lese-/Sendetimeout in Sekunden für upstream-Anforderungen. Wenn sie nicht festgelegt ist, wird der Standardtimeout wieder verwendet. |\n| `app.copilot-proxy.provider-wire-api` | No | | |\n| `completions`, `responses` | Das Draht-API-Format für den Anbieter. | | |\n| `app.copilot-proxy.provider-wire-model` | No | String | Überschreibt den Modellbezeichner, der an den Upstreamanbieter gesendet wird, wenn er sich von der internen Modell-ID unterscheidet. |\n| `app.copilot-proxy.enable-upstream-probe` | No | | |\n| `true`, `false` | Aktiviert oder deaktiviert die Upstream-Sonde beim Start. Standardmäßig aktiviert. Wenn sie deaktiviert ist, wird die Startsonde übersprungen. | | |\n\nBeispielsweise konfigurieren die folgenden Befehle einen OpenAI-Anbieter.\n\n```shell\nghe-config app.copilot-proxy.enabled true\nghe-config app.copilot-proxy.endpoint-url 'https://api.openai.com/v1'\nghe-config secrets.copilot-proxy.endpoint-key 'YOUR-API-KEY'\nghe-config app.copilot-proxy.provider-model-id 'gpt-5.5'\nghe-config app.copilot-proxy.provider-wire-model 'gpt-5.5'\nghe-config app.copilot-proxy.provider-type openai\nghe-config app.copilot-proxy.upstream-timeout 300\nghe-config app.copilot-proxy.enable-upstream-probe false\nghe-config-apply\n```\n\nErsetzen Sie `YOUR-API-KEY` durch den tatsächlichen API-Schlüssel, bevor Sie die Konfiguration anwenden.\n\n## Konfigurieren des Copilot CLI Clients (Endbenutzer)\n\nKonfigurieren Sie Copilot CLI so, dass eine Verbindung zu Ihrer GitHub Enterprise Server-Instanz hergestellt wird, indem Sie die folgenden Umgebungsvariablen festlegen, bevor Sie Copilot CLI starten.\n\n| Umgebungsvariable | Erforderlich | Description |\n| ----------------------------- | ------------ | ---------------------------------------------------------------------------------------------------------------------------- |\n| `COPILOT_PROVIDER_GHES_HOST` | Yes | Der Hostname Ihrer GitHub Enterprise Server Instanz. |\n| `COPILOT_PROVIDER_GHES_TOKEN` | Yes | A personal access token für die GitHub Enterprise Server Instanz. Dieses Token authentifiziert Anforderungen an die Instanz. |\n| `COPILOT_OFFLINE` | Yes | Aktiviert den Offlinemodus. Der Anbieter ist nur aktiv, wenn der GitHub Enterprise Server Offlinemodus aktiviert ist. |\n\n## Grundlegendes zu Clienttoken (Endbenutzertoken)\n\nCopilot CLI benötigt Zugriff auf LLM-Rückschlüsse, daher `COPILOT_PROVIDER_GHES_TOKEN` ist immer erforderlich. Sie werden Copilot CLI wahrscheinlich auch verwenden wollen, um GitHub-Vorgänge auszuführen, z. B. Issues zu erstellen, Pull Requests zu erstellen und Repositorien zu durchsuchen. Solche Vorgänge können über GitHub CLI durchgeführt werden.\n\nEs wird empfohlen, `gh auth login --hostname YOUR-GHES-HOSTNAME` vorzugsweise auszuführen. Nachdem dies erfolgreich war, besteht der nächste Schritt darin, `COPILOT_PROVIDER_GHES_TOKEN` auf das in `gh auth login --hostname YOUR-GHES-HOSTNAME` generierte Token zu setzen. Es ist sicherer, das Token dynamisch abzurufen, anstatt es zu kopieren.`~/.config/gh/hosts.yml` Dies können Sie mit `COPILOT_PROVIDER_GHES_TOKEN=\"$(gh auth token --hostname YOUR-GHES-HOSTNAME)\"` tun.\n\nAlternativ können Sie auf Ihrer personal access token-Instanz ein GitHub Enterprise Server-Token generieren, dieses Token als `COPILOT_PROVIDER_GHES_TOKEN` festlegen und beim Ausführen von `gh auth login --hostname YOUR-GHES-HOSTNAME` dasselbe Token verwenden.\n\nDer obige Ansatz funktioniert, wenn Sie Copilot CLI interaktiv verwenden. Für die Automatisierung müssen Sie einige Dinge anders erledigen:\n\n* Legen Sie `GH_ENTERPRISE_TOKEN` (oder `GITHUB_ENTERPRISE_TOKEN`) auf personal access token fest.\n* Legen Sie `GH_HOST` den Hostnamen Ihres Servers fest.\n* Wenn für denselben Host sowohl `GH_ENTERPRISE_TOKEN`- als auch `gh auth login`-Anmeldeinformationen vorhanden sind, hat die Umgebungsvariable Vorrang.\n\n## Empfohlene Einrichtung des Endbenutzers\n\n1. Authentifizieren GitHub CLI.\n\n ```shell\n gh auth login --hostname YOUR-GHES-HOSTNAME\n ```\n\n2. Legen Sie die umgebungsvariablen fest, die erforderlich sind.Copilot CLI\n\n ```shell\n export COPILOT_PROVIDER_GHES_HOST=YOUR-GHES-HOSTNAME\n export COPILOT_PROVIDER_GHES_TOKEN=\"$(gh auth token --hostname YOUR-GHES-HOSTNAME)\"\n export COPILOT_OFFLINE=true\n ```\n\n Wenn Sie bei mehreren Konten mit `gh auth login` authentifiziert sind, können Sie `GH_HOST` auf den Hostnamen Ihres Servers setzen und `GITHUB_ENTERPRISE_TOKEN` (oder `\"$(gh auth token --hostname YOUR-GHES-HOSTNAME)\"`) auf `GH_ENTERPRISE_TOKEN` setzen. Dadurch wird sichergestellt, dass GitHub CLI auf Ihre GitHub Enterprise Server-Instanz verweist.\n\n ```shell\n export GH_HOST=YOUR-GHES-HOSTNAME\n export GH_ENTERPRISE_TOKEN=\"$(gh auth token --hostname YOUR-GHES-HOSTNAME)\"\n ```\n\n3. Starten Sie Copilot CLI.\n\n```bash\ncopilot\n```\n\nSie können dieses gesamte Setup als Skript ausführen.\n\n## Beispiele\n\nWenn sowohl ihre GitHub Enterprise Server Konfigurationen als auch Ihre Copilot CLI Konfigurationen korrekt sind, sollten Antworten wie die folgende in Ihrer Copilot CLI Sitzung angezeigt werden.\n\n```shell\n • fabric-core-mcp — disabled\n • powerbi-mcp — disabled\n • slack — connected\n\n ● Current model: gpt-5.5\n\n ❯ Hello 13:31\n\n ● Hello!\n\n ❯ what is going on in github/codeql-action repo? 13:33\n\n ● I’ll check recent repository activity on the GHES host: repo metadata, open \n PRs/issues, and latest commits.\n\n $ Shell Fetch repo metadata 2 lines… 5s\n gh api --hostname \"$GH_HOST\" repos/github/codeql-action --jq '{name_with_own…\n```\n\n## Unterstützte Funktionen auf GitHub Enterprise Server\n\nDie aktuellsten Informationen zu den Funktionen von Copilot CLI finden Sie in [GitHub Copilot CLI](/de/enterprise-cloud@latest/copilot/how-tos/copilot-cli) als maßgeblicher Quelle. Im Allgemeinen ist jede Funktion, die auf konnektivitätsbasierten GitHub Clouddiensten basiert, in der GitHub Enterprise Server Offlinekonfiguration nicht verfügbar.\n\nDie folgende Tabelle bietet einen orientierenden Überblick darüber, was im GitHub Enterprise Server Angebot verfügbar ist.\n\n| Fähigkeit | GitHub / GitHub Enterprise Cloud | GitHub Enterprise Server |\n| :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: |\n| KI-gestützte Codierung (Eingabeaufforderungen, Codegenerierung, Debuggen) | | |\n| Shellbefehle und Dateivorgänge | | |\n| GitHub Vorgänge (Probleme, PRs, Repos) über `gh` CLI | | |\n| (erfordert bei der Instanz angemeldete `gh` CLI) | | |\n| GitHub MCP-Server-Tools | | |\n| Websuche und Web-Abruf | | |\n| Copilot Modellauswahl (GitHubgehostete Modelle) | | |\n| Telemetrie- und Nutzungsberichterstattung | | |\n| Automatische Aktualisierung | | |"}