Informationen zur Authentifizierung
GitHubDie Authentifizierung ist nicht erforderlich, wenn Sie Ihre eigenen LLM-Anbieter-API-Schlüssel (BYOK) verwenden oder sich mit einem Microsoft Entra Konto anmelden.
Für jede andere GitHub Copilot CLI Verwendung ist eine Authentifizierung erforderlich.
Wenn eine Authentifizierung erforderlich ist, unterstützt Copilot CLI mehrere Methoden. Die verwendete Methode hängt davon ab, ob Sie interaktiv oder in einer automatisierten Umgebung arbeiten.
- OAuth: Die standard- und empfohlene Methode für die interaktive Verwendung. Es gibt zwei OAuth-Flüsse. Der Browserablauf (Web) öffnet Ihren Browser, um die Anmeldung zu autorisieren, und schließt sie über einen lokalen Loopback-Rückruf ab. Der Gerätecodefluss zeigt einen einmaligen Code an, den Sie in Ihren Browser eingeben. Der Browser-Ablauf ist auf einem lokalen Desktop der Standard, und in bekannten Remote- oder Headless-Umgebungen (einschließlich SSH, GitHub Codespaces, Dev-Containern und CI) wird standardmäßig der Device-Code-Flow verwendet. Siehe Authentifizierung mit OAuth.
- Umgebungsvariablen: Empfohlen für CI/CD-Pipelines, Container und nicht interaktive Umgebungen. Sie legen ein unterstütztes Token als Umgebungsvariable (
COPILOT_GITHUB_TOKEN,GH_TOKENoderGITHUB_TOKEN) fest, und die CLI verwendet es automatisch ohne Aufforderung. Siehe Authentifizierung mit Umgebungsvariablen. - GitHub CLI Fallback: Wenn () (GitHub CLIHinweis: die
ghCLI, nichtgh) installiert und authentifiziert istcopilot, Copilot CLI kann das Token automatisch verwendet werden. Dies ist die niedrigste Prioritätsmethode und wird nur aktiviert, wenn keine anderen Anmeldeinformationen gefunden werden. Siehe Authentifizierung mit GitHub CLI.
Nach der Authentifizierung Copilot CLI merkt sie sich Ihre Anmeldung und verwendet automatisch das Token für alle Copilot API-Anforderungen. Sie können sich mit mehreren Konten anmelden, und die CLI merkt sich das zuletzt verwendete Konto. Die Lebensdauer und der Ablauf des Tokens hängen davon ab, wie das Token gemäß den Einstellungen Ihres Kontos oder Ihrer Organisation erstellt wurde.
Verwendung von GitHub ohne Copilot CLIAuthentifizierungCopilot CLI
GitHub Authentifizierung ist nicht erforderlich, wenn Sie für Anfragen an KI-Modelle eine der folgenden Optionen verwenden:
- Ihre eigenen LLM-Anbieter-API-Schlüssel (BYOK): Copilot CLI stellt eine direkte Verbindung mit Ihrem konfigurierten Anbieter ohne GitHub-Konto oder Token her.
- Ein Microsoft Entra Konto: Wenn Ihr Microsoft Entra Mandant OpenID Connect (OIDC) zum Herstellen einer Verbindung GitHub Enterprise Managed Usersverwendet, können Sie Ihr Microsoft Entra Konto verwenden, um sich bei Windows oder macOS anzumelden. Wenn für diesen Microsoft Entra Benutzer eine Microsoft 365 Copilot Lizenz vorhanden ist, können Modellanforderungen an Microsoft 365 Copilot gesendet werden. Siehe Authentifizierung mit Microsoft Entra.
Ohne GitHub Authentifizierung sind die folgenden Features jedoch nicht verfügbar:
/delegate: Erfordert Copilot cloud agent, die auf GitHub's Servern ausgeführt wird- GitHub MCP-Server: Erfordert Authentifizierung für den Zugriff auf GitHub APIs
- GitHub Codesuche: Erfordert Authentifizierung zum Abfragen GitHubdes Suchindexes
Sie können BYOK oder Microsoft Entra Authentifizierung mit GitHub-Authentifizierung kombinieren, um das Beste aus beiden zu erzielen: Ihr bevorzugtes Modell für KI-Antworten sowie Zugriff auf GitHub-gehostete Features wie /delegate und Codesuche.
Offline-Modus
Wenn Sie die Umgebungsvariable COPILOT_OFFLINE auf true setzen, läuft Copilot CLI ohne Kontaktaufnahme mit den Servern von GitHub. Im Offlinemodus:
- Es wird keine GitHub Authentifizierung versucht.
- Die CLI sendet nur Netzwerkanforderungen an Ihren konfigurierten BYOK-Anbieter.
- Telemetrie ist vollständig deaktiviert.
Der Offlinemodus ist nur vollständig mit Air Gap, wenn Ihr BYOK-Anbieter entweder lokal oder anderweitig innerhalb derselben abgeschlossenen Umgebung existiert (z. B. ein Modell, das vor Ort ohne externen Netzwerkzugriff läuft). Wenn COPILOT_PROVIDER_BASE_URL auf einen entfernten oder Internet-zugänglichen Endpunkt verweist, werden Prompts und Code-Kontext weiterhin über das Netzwerk an diesen Anbieter gesendet. Ohne Offlinemodus, auch wenn BYOK ohne GitHub Authentifizierung verwendet wird, wird Telemetrie weiterhin normal gesendet.
Unterstützte Tokentypen
| Tokentyp | Präfix | Unterstützt | Hinweise |
|---|---|---|---|
| OAuth-Token (Browser- oder Gerätefluss) | gho_ | Ja | Standardmethode über copilot login |
| Feinkörniger PAT | github_pat_ | Ja | Muss im Besitz Ihres persönlichen Kontos (keine Organisation) mit der Copilot Berechtigung "Konto anfragen" sein |
| GitHub App Benutzer-zu-Server-Kommunikation | ghu_ | Ja | Über eine Umgebungsvariable |
| Klassisch PAT | ghp_ | Nein | Nicht unterstützt von Copilot CLI |
Wie Copilot CLI Anmeldeinformationen speichert
Standardmäßig speichert die CLI Ihr OAuth-Token im Schlüsselbund Ihres Betriebssystems unter dem Dienstnamen copilot-cli:
| Plattform | Schlüsselbund |
|---|---|
| macOS | Schlüsselbundzugriff |
| Windows | Anmeldeinformationsverwaltung |
| Linux | libsecret (GNOME-Schlüsselbund, KWallet) |
Wenn die Systemkeychain nicht verfügbar ist – z. B. auf einem Headless Linux-Server ohne installiertes libsecret – fordert die CLI Sie auf, das Token in einer Klartext-Konfigurationsdatei unter ~/.copilot/config.json zu speichern.
Wenn Sie einen Befehl ausführen, überprüft Copilot CLI die Anmeldeinformationen in der folgenden Reihenfolge:
- Umgebungsvariable
COPILOT_GITHUB_TOKEN - Umgebungsvariable
GH_TOKEN - Umgebungsvariable
GITHUB_TOKEN - OAuth-Token aus der Systemschlüsselkette
- GitHub CLI (
gh auth token) Fallback
Hinweis
- Eine Umgebungsvariable überschreibt unbemerkt ein gespeichertes OAuth-Token. Wenn Sie für ein anderes Tool festlegen
GH_TOKEN, verwendet die CLI dieses Token anstelle des OAuth-Tokens voncopilot login. Um unerwartetes Verhalten zu vermeiden, verwenden Sie nicht festgelegte Umgebungsvariablen, die von der CLI nicht verwendet werden sollen. Es gibt eine Ausnahme: in GitHub Codespaces hat das automatisch eingefügteGITHUB_TOKENkeinen Vorrang vor einem Konto, mit dem Sie sich mit/loginangemeldet haben. EinGITHUB_TOKEN,COPILOT_GITHUB_TOKENoderGH_TOKEN, den bzw. das Sie explizit exportieren, wird weiterhin ausgeführt. - Wenn Sie BYOK-Anbieterumgebungsvariablen konfigurieren (z. B.,
COPILOT_PROVIDER_BASE_URL,COPILOT_PROVIDER_API_KEY), werden diese von Copilot CLI unabhängig von Ihrem GitHub-Authentifizierungsstatus für KI-Modellanforderungen verwendet. GitHub Token werden nur für GitHub-gehostete Features benötigt.
Authentifizieren mit OAuth
OAuth ist die Standardauthentifizierungsmethode für die interaktive Verwendung. Sie können sich authentifizieren, indem Sie /login von Copilot CLI oder copilot login von Ihrem Terminal aus ausführen. Beide bieten einen Browserfluss (Web) und einen Gerätecodefluss.
Authentifizieren mit /login
-
Von Copilot CLI, ausführen
/login.Bash /login
/login -
Wählen Sie das Konto aus, mit dem Sie sich authentifizieren möchten. Für GitHub Enterprise Cloud mit Datenresidenz geben Sie den Hostnamen Ihrer Instanz ein. Wenn Sie Ihre Organisation (Microsoft Entra) auswählen, Copilot CLI werden Sie automatisch mit Ihrem vorhandenen Microsoft Entra-Konto angemeldet.
What account do you want to log into? 1. GitHub.com 2. GitHub Enterprise Cloud with data residency (*.ghe.com) 3. Your organization (Microsoft Entra) -
Wählen Sie aus, wie Sie sich anmelden möchten. Die empfohlene Option wird zuerst aufgeführt und hängt von Ihrer Umgebung ab: der Browserfluss auf einem lokalen Terminal oder der Gerätecodefluss in einer Remote- oder Headless-Umgebung. Das folgende Beispiel zeigt die Eingabeaufforderung in einem lokalen Terminal:
How do you want to sign in? 1. Sign in with your browser (recommended) 2. Sign in with a device code -
Schließen Sie den ausgewählten Fluss ab.
-
Browser: Copilot CLI öffnet Ihren Browser, damit Sie die Anmeldung autorisieren können. Wenn Ihr Browser nicht automatisch geöffnet wird, zeigt das Terminal eine URL an, die Sie stattdessen besuchen können.
-
Gerätecode: Die CLI zeigt einen einmaligen Benutzercode an und kann ihn in Ihre Zwischenablage kopieren und Ihren Browser für Sie öffnen.
Waiting for authorization... Enter one-time code: 1234-5678 at https://github.com/login/device Press any key to copy to clipboard and open browser...Navigieren Sie zur Verifizierungs-URL unter
https://github.com/login/device, wenn Ihr Browser nicht automatisch geöffnet wurde, und fügen Sie dann den Einmalcode in das Feld auf der Seite ein.
-
-
Wenn Ihre Organisation SAML-SSO verwendet, klicken Sie auf Authorize neben jeder Organisation, der Sie access erteilen möchten.
-
Überprüfen Sie die angeforderten Berechtigungen, und klicken Sie auf Authorize GitHub Copilot CLI.
-
Kehren Sie zu Ihrem Terminal zurück. Die CLI zeigt eine Erfolgsmeldung an, wenn die Authentifizierung abgeschlossen ist.
Signed in successfully as Octocat. You can now use Copilot.
Authentifizieren mit copilot login
-
Führen Sie vom Terminal aus
copilot login. Wenn Sie GitHub Enterprise Cloud mit Data Residency verwenden, übergeben Sie den Hostnamen Ihrer Instanz.Bash copilot login
copilot loginFür GitHub Enterprise Cloud:
Bash copilot login --host HOSTNAME
copilot login --host HOSTNAME -
Autorisieren Sie die Anmeldung.
Auf einem lokalen Desktop verwendet
copilot loginstandardmäßig den Browser-Flow. Er öffnet Ihren Browser, um die Anmeldung zu autorisieren und erfasst das Ergebnis in einem lokalen Loopbackrückruf.Opening your browser to authenticate... If it doesn't open automatically, visit: URL Waiting for authorization...Bekannte Remote- oder Headless-Umgebungen (einschließlich SSH, GitHub Codespaces, Dev-Containern und CI) verwenden stattdessen den Device Code Flow. Die CLI zeigt einen Einmalcode an und kann ihn, sofern die Umgebung dies unterstützt, in die Zwischenablage kopieren und den Browser öffnen.
To authenticate, visit https://github.com/login/device and enter code 1234-5678 Waiting for authorization...Um einen bestimmten Ablauf zu erzwingen, fügen Sie die Option
--web-flowoder--device-codehinzu. -
Navigieren Sie zu der URL, die in Ihrem Terminal angezeigt wird, wenn Ihr Browser nicht automatisch geöffnet wurde. Fügen Sie für den Gerätecodefluss den einmaligen Code in das Feld auf der Seite ein.
-
Wenn Ihre Organisation SAML-SSO verwendet, klicken Sie auf Authorize neben jeder Organisation, der Sie access erteilen möchten.
-
Überprüfen Sie die angeforderten Berechtigungen, und klicken Sie auf Authorize GitHub Copilot CLI.
-
Kehren Sie zu Ihrem Terminal zurück. Die CLI zeigt eine Erfolgsmeldung an, wenn die Authentifizierung abgeschlossen ist.
Signed in successfully as Octocat.
Authentifizieren mit Microsoft Entra
Hinweis
Die Verwendung von Microsoft Entra mit Copilot CLI befindet sich in Öffentliche Vorschau und kann sich ändern.
Die Authentifizierung mit einem Microsoft Entra Konto wird unter Windows und macOS in Copilot CLI Version 1.0.113 und höher unterstützt.
Voraussetzungen für die Verwendung GitHub Enterprise Managed Users
Ihr Microsoft Entra Mandant muss OIDC verwenden, um eine Verbindung mit GitHub Enterprise Managed Users herzustellen. Weitere Informationen findest du unter Informationen zu Enterprise-Managed Authorization für Apps.
Voraussetzungen für die Verwendung von Microsoft 365 Copilot Modellen
Microsoft 365 Copilot-Lizenzen werden für Frontier-Kunden nur von Copilot CLI unterstützt. Um dieses Feature verwenden zu können, müssen Sie folgendes haben:
- Ein Microsoft Entra Konto mit Zugriff auf Microsoft 365 Copilot über Ihre Organisation.
- Ein Administrator muss die folgenden Einstellungen in der Microsoft 365 Admin Center aktivieren:
- Die Microsoft Copilot-Ausgabenrichtlinie für Code für nutzungsbasierte Abrechnung. Der Abrechnungsadministrator Ihrer Organisation oder der globale Administrator kann diese Richtlinie aktivieren.
- Die Copilot Frontier-Einstellung. Der KI-Administrator oder der globale Administrator Ihrer Organisation kann diese Einstellung aktualisieren.
- Die Einstellung für den GitHub Copilot-Zugriff (Frontier), die standardmäßig deaktiviert ist. Der globale Administrator Ihrer Organisation kann diese Einstellung aktualisieren.
Anmelden mit Ihrer Organisation
- Ausführen
/loginin Copilot CLI. - Wählen Sie Ihre Organisation (Microsoft Entra) aus. Copilot CLImeldet Sie automatisch mit Ihrem vorhandenen Microsoft Entra Konto an.
Nachdem Sie sich angemeldet haben, werden in der /model Auswahl zulässige Modelle angezeigt. Weitere Informationen zur Funktionsweise mit Microsoft 365 Copilot finden Sie unter GitHub Copilot-CLI.
Authentifizieren mit Umgebungsvariablen
Bei nicht interaktiven Umgebungen können Sie sich authentifizieren, indem Sie eine Umgebungsvariable mit einem unterstützten Token festlegen. Dies ist ideal für CI/CD-pipelines, Container oder Headless-Server.
- Besuchen Sie Fine-grained personal access tokens.
- Wählen Sie unter "Ressourcenbesitzer" Ihr persönliches Konto aus. Wählen Sie keine Organisation aus. Die Copilot Berechtigung "Requests" ist nur auf benutzereigenen fine-grained personal access tokens verfügbar.
- Wählen Sie unter Repositoryzugriff die für Ihren Anwendungsfall geeignete Zugriffsebene aus:
- Öffentliche Repositorys , wenn Sie nur mit öffentlichen Repositorys arbeiten müssen.
- Alle Repositorys , wenn Sie Zugriff auf alle Ihre aktuellen und zukünftigen Repositorys benötigen.
- Wählen Sie nur Repositorys aus , wenn Sie den Zugriff auf bestimmte Repositorys einschränken möchten.
- Wählen Sie unter "Berechtigungen" die Registerkarte " Konto " aus.
- Klicken Sie auf "Berechtigungen hinzufügen", und wählen Sie "Anforderungen" ausCopilot.
- Klicke dann auf Token generieren.
- Exportieren Sie das Token in Ihrer Terminal- oder Umgebungskonfiguration. Verwenden Sie die Umgebungsvariable
COPILOT_GITHUB_TOKEN,GH_TOKENoderGITHUB_TOKEN(in der Reihenfolge der Rangfolge).
Authentifizieren mit GitHub CLI
Wenn Sie GitHub CLI installiert und authentifiziert haben, kann Copilot CLI sein Token als Fallback verwenden. Diese Methode hat die niedrigste Priorität und aktiviert nur, wenn keine Umgebungsvariablen festgelegt werden und kein gespeichertes Token gefunden wird.
-
Überprüfen Sie, ob GitHub CLI authentifiziert ist.
Bash gh auth status
gh auth statusWenn Sie GitHub Enterprise Cloud mit Datenresidenz verwenden, überprüfen Sie, ob der richtige Hostname authentifiziert ist.
Bash gh auth status --hostname HOSTNAME
gh auth status --hostname HOSTNAME -
Führen Sie
copilotaus. Die Copilot CLI verwendet automatisch das token GitHub CLI. -
Führen Sie
/userin der CLI aus, um Ihr authentifiziertes Konto zu überprüfen.
Wechseln zwischen Konten
Copilot CLI unterstützt mehrere Konten. Sie können verfügbare Konten auflisten und zwischen ihnen innerhalb der CLI wechseln.
Um die verfügbaren Konten aufzulisten, führen Sie /user list an der Copilot CLI Eingabeaufforderung aus.
Um zu einem anderen Konto zu wechseln, geben Sie /user switch an der Eingabeaufforderung ein.
Um ein weiteres Konto hinzuzufügen, führen Sie copilot login aus einer neuen Terminalsitzung aus oder führen Sie den Anmeldebefehl in der CLI aus und melden Sie sich mit dem anderen Konto an.
Abmelden und Entfernen von Anmeldeinformationen
Um sich abzumelden, geben Sie /logout an der Eingabeaufforderung Copilot CLI ein. Dadurch wird das lokal gespeicherte Token entfernt, jedoch nicht auf GitHub widerrufen.
Führen Sie die folgenden Schritte aus, um die OAuth-App-Autorisierung GitHub zu widerrufen und zu verhindern, dass sie an anderer Stelle verwendet wird.
- Navigieren Sie zu "Einstellungen > "-Anwendungen > , die für OAuth-Apps autorisiert sind.
- Navigieren Sie zu Ihrer Einstellungsseite:
- Klicken Sie in der oberen rechten Ecke einer beliebigen Seite auf Ihr Profilbild GitHub.
- Klicken Sie auf Einstellungen.
- Klicken Sie in der linken Randleiste auf "Anwendungen".
- Klicken Sie unter Autorisierte OAuth-Apps auf neben GitHub Copilot CLI, um das Menü zu erweitern, und wählen Sie Widerrufen aus.
Nächste Schritte
Wenn Authentifizierungsprobleme auftreten, lesen Sie Problembehandlung bei der Authentifizierung von GitHub Copilot CLI.