# Problembehandlung bei der Authentifizierung von GitHub Copilot CLI

Diagnose von Authentifizierungsfehlern bei der Anmeldung in Copilot CLI.

## Authentifizierungsfehler

Wenn Authentifizierungsfehler auftreten, verwenden Sie die nachstehende Tabelle, um die Ursache und Lösung zu identifizieren.

| Thema                                                                                  | Ursache                                                                     | Reparatur                                                           | Mehr Informationen |
| -------------------------------------------------------------------------------------- | --------------------------------------------------------------------------- | ------------------------------------------------------------------- | ------------------ |
| Keine Authentifizierungsinformationen gefunden                                         | Keine Anmeldeinformationen gespeichert                                      | Führen Sie `copilot login` aus.                                     |                    |
| [Keine Authentifizierungsinformationen gefunden](#no-authentication-information-found) |                                                                             |                                                                     |                    |
| 401 Nicht autorisiert                                                                  | Das Token wurde widerrufen oder es liegen unzureichende Berechtigungen vor. | Token mit Berechtigungen generieren                                 |                    |
| [Token abgelaufen oder widerrufen](#token-expired-or-revoked)                          |                                                                             |                                                                     |                    |
| Token (classic) Abgelehnt                                                              |                                                                             |                                                                     |                    |
| Token (classic) (`ghp_`)                                                               | Verwenden Sie feinkörnig personal access token                              |                                                                     |                    |
| \[                                                                                     |                                                                             |                                                                     |                    |
| Token (classic) Abgelehnt]\(#token-classic-rejected)                                   |                                                                             |                                                                     |                    |
| „403 Verboten“ oder „Ablehnung durch Richtlinie“                                       |                                                                             |                                                                     |                    |
| Copilot Lizenz- oder Unternehmens-/Organisationsrichtlinie                             | Überprüfen von Abonnement- und Organisationseinstellungen                   |                                                                     |                    |
| [Access verweigert](#access-denied)                                                    |                                                                             |                                                                     |                    |
| Schlüsselbund nicht verfügbar                                                          | Fehlender Systemschlüsselbund                                               | Installiere `libsecret` oder akzeptiere Nur-Text                    |                    |
| [Fehler beim Zugriff auf die Schlüsselbund](#keychain-access-failure)                  |                                                                             |                                                                     |                    |
| Falsches Konto                                                                         | Mehrere Konten oder Umgebungsvariablenüberschreibung                        | Überprüfen Sie die Umgebungsvariablen, verwenden Sie `/user switch` |                    |
| [Falsches Konto](#wrong-account)                                                       |                                                                             |                                                                     |                    |

## Keine Authentifizierungsinformationen gefunden

Copilot CLI zeigt den folgenden Fehler an:

<!-- markdownlint-disable GHD005 -->

```text
Error: No authentication information found
Copilot can be authenticated with GitHub using an OAuth Token or a Fine-Grained Personal Access Token
```

<!-- markdownlint-enable GHD005 -->

### Ursache

In den überprüften Speicherorten sind keine Anmeldeinformationen vorhanden.

### Reparatur

Führen Sie die folgenden Schritte aus, um zu ermitteln, wo die Authentifizierung fehlt, und stellen Sie access wieder her.

#### Überprüfen Des Authentifizierungsstatus

```bash copy
gh auth status
```

Wenn eine Meldung angezeigt wird, die angibt, dass Sie nicht angemeldet sind, melden Sie sich mit `gh auth login` an oder verwenden Sie den OAuth-Fluss mit `copilot login`.

#### Überprüfen, ob eine Authentifizierungsumgebungsvariable festgelegt ist

Wenn Sie eine Umgebungsvariable verwenden, überprüfen Sie, ob die `COPILOT_GITHUB_TOKEN`Variable oder `GH_TOKEN``GITHUB_TOKEN` Umgebungsvariable festgelegt ist:

```bash copy
echo $COPILOT_GITHUB_TOKEN
```

Wenn der Befehl nichts druckt, wird die Variable nicht festgelegt. Legen Sie die Variable auf ein gültiges Token fest. Informationen zum Generieren eines Tokens finden Sie unter [Authentifizierung von GitHub Copilot CLI](/de/copilot/how-tos/copilot-cli/set-up-copilot-cli/authenticate-copilot-cli#authenticating-with-environment-variables).

```bash copy
 export $COPILOT_GITHUB_TOKEN=PERSONAL_ACCESS_TOKEN
```

#### macOS-Schlüsselbund

```bash copy
security find-generic-password -s copilot-cli
```

Wenn kein Element gefunden wird, authentifizieren Sie sich erneut mit `/login` oder `copilot login`, um ein Element zu erstellen.
Wenn ein Element gefunden wird, die Authentifizierung jedoch weiterhin fehlschlägt, entfernen Sie die gespeicherten Anmeldeinformationen, und authentifizieren Sie sich erneut mit `/login` oder `copilot login`:

```bash copy
  security delete-generic-password -s copilot-cli
```

## Token abgelaufen oder widerrufen

Copilot CLI zeigt den folgenden Fehler an:

<!-- markdownlint-disable GHD005 -->

```text
Error: Authentication failed

Your GitHub token may be invalid, expired, or lacking the required permissions.

To resolve this, try the following:
  • Start 'copilot' and run the '${LOGIN_COMMAND}' command to re-authenticate
  • If using a Fine-Grained PAT, ensure it has the 'Copilot Requests' permission enabled
  • If using COPILOT_GITHUB_TOKEN, GH_TOKEN or GITHUB_TOKEN environment variable, verify the token is valid and not expired
  • Run 'gh auth status' to check your current authentication status
```

<!-- markdownlint-enable GHD005 -->

### Ursache

Das Token wurde widerrufen, abgelaufen oder wurde ohne die erforderlichen Berechtigungen erstellt.

### Reparatur

Überprüfen Sie den Status und die Berechtigungen des Tokens für GitHub. Das Token muss im fine-grained personal access token Besitz Ihres **persönlichen Kontos** (keine Organisation) mit der **Copilot Berechtigung "Anforderungen** " sein. Generieren Sie bei Bedarf ein neues Token mit den erforderlichen Berechtigungen.

## Token (classic) Abgelehnt

Ein Token, das beginnt, `ghp_` wird im Hintergrund ignoriert, und die CLI verhält sich so, als ob kein Token festgelegt ist.

### Ursache

Klassische personal access tokens werden von Copilot CLI nicht unterstützt.

### Reparatur

Generieren Sie einen fein abgestimmten personal access token mit den erforderlichen Bereichen.

## Access verweigert

Copilot CLI zeigt einen der folgenden Fehler an:

```text
Error: Access denied by policy settings

Your Copilot CLI policy setting may be preventing access. This can happen when:
  • Your organization has restricted Copilot access
  • Your Copilot subscription does not include this feature
  • Required policies have not been enabled by your administrator

To resolve this, visit your Copilot settings: 
```

### Ursache

Eine Organisationsrichtlinie blockiert GitHub Copilot CLIoder das Benutzerkonto verfügt nicht über eine GitHub Copilot Lizenz.

### Reparatur

* Überprüfen Sie, ob Ihr Konto über eine aktive GitHub Copilot Lizenz verfügt.
* Bitten Sie Ihren Organisationsadministrator, GitHub Copilot CLI in der Organisationsrichtlinie zu ermöglichen.

## Fehler beim Schlüsselbundzugriff

Während der Anmeldung informiert die CLI Sie darüber, dass der Systemschlüsselbund nicht verfügbar ist, und fragt, ob die Anmeldeinformationen im Klartext gespeichert werden sollen.

```text
System keychain unavailable. Store token in plaintext config file? (y/N)
```

### Ursache

Auf den Systemschlüsselbund kann nicht zugegriffen werden. Dies kann auf Linux-Systemen ohne `libsecret`, auf kopflosen Servern oder auf Systemen mit einem Berechtigungsproblem auftreten.

### Reparatur

Führen Sie die Schritte für Ihr Betriebssystem aus, um den sicheren Anmeldeinformationsspeicher wiederherzustellen.

#### macOS oder Windows

Bestätigen Sie unter macOS, dass die Schlüsselbund Zugriff-App verfügbar ist, und dass Sie Ihren Anmeldeschlüsselbund entsperren können.
Im Fall von Windows überprüfen Sie, ob der Credential Manager verfügbar ist, und Sie können auf den Windows-Tresor zugreifen.
Wenn Sie nicht auf den Systemanmeldeinformations-Manager zugreifen können, verwenden Sie die Nurtext-Speicherung (wenn Sie dazu aufgefordert werden), oder authentifizieren Sie sich mit einem Umgebungsvariablentoken, und führen Sie dann `/login` oder `copilot login` erneut aus.

#### Linux

Verwenden Sie unter Linux den Systemschlüsselbund oder speichern Sie Anmeldedaten im Klartext.

1. Überprüfen Sie, ob `secret-tool` installiert ist:

   ```bash copy
   command -v secret-tool
   ```

2. Wenn `secret-tool` nicht gefunden wird oder der Suchbefehl keine Ergebnisse zurückgibt, installieren Sie `libsecret` und seine Abhängigkeiten. Beispielsweise könnten Sie unter Debian und Ubuntu den folgenden Befehl verwenden."

   ```bash copy
   sudo apt install libsecret-1-0 gnome-keyring seahorse
   ```

3. Sobald `secret-tool` installiert ist, durchsuchen Sie den Schlüsselring nach gespeicherten Anmeldeinformationen:

   ```bash copy
   secret-tool search copilot-cli
   ```

   Wenn der Befehl mindestens ein Ergebnis zurückgibt, sind anmeldeinformationen im Schlüsselring vorhanden. Führen Sie `copilot login` im Terminal oder `/login` in Copilot CLI erneut aus.

## Falsches Konto

Der falsche Benutzer ist authentifiziert, oder das Token gehört zur falschen Organisation.

### Ursache

Mehrere Konten werden gespeichert, oder eine Umgebungsvariable überschreibt das gespeicherte Token.

### Reparatur

Um Konten zu wechseln, verwenden Sie `/user switch` an der CLI-Eingabeaufforderung, oder melden Sie sich ab mit `/logout` und führen Sie `/login` mit dem richtigen Konto aus.