Устранение неполадок аутентификации GitHub Copilot CLI

Ошибки проверки подлинности

Если вы столкнётесь с ошибками аутентификации, используйте таблицу ниже, чтобы определить причину и разрешение.

Информации об аутентификации не найдено

Copilot CLI показывает следующую ошибку:

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

Причина

В одном из проверенных пунктов нет никаких удостоверений данных.

Исправление

Используйте следующие шаги, чтобы найти отсутствующую аутентификацию и восстановить access.

Проверьте статус аутентификации

gh auth status

gh auth status

Если вы видите сообщение о том, что вы не вошли в систему, войдите с gh auth login помощью OAuth или используйте поток OAuth с copilot login.

Проверьте, установлена ли переменная среды аутентификации

Если вы используете переменную среды, проверьте, установлена COPILOT_GITHUB_TOKENли переменная , GH_TOKEN, или GITHUB_TOKEN переменная среды:

echo $COPILOT_GITHUB_TOKEN

echo $COPILOT_GITHUB_TOKEN

Если команда ничего не печатает, переменная не устанавливается. Установите переменную на допустимый токен. Для генерации токена см. Аутентификация GitHub Copilot CLI.

 export COPILOT_GITHUB_TOKEN=PERSONAL_ACCESS_TOKEN

 export COPILOT_GITHUB_TOKEN=PERSONAL_ACCESS_TOKEN

Брелок для macOS

security find-generic-password -s copilot-cli

security find-generic-password -s copilot-cli

Если предмет не найден, повторно аутентифицируйте с /login помощью или copilot login чтобы создать его. Если элемент найден, но аутентификация всё равно не удалась, удалите сохранённые учетные данные и затем снова аутентифицируйтесь с помощью /login или copilot login:

  security delete-generic-password -s copilot-cli

  security delete-generic-password -s copilot-cli

Токен истёк или аннулирован

Copilot CLI показывает следующую ошибку:

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

Причина

Токен был аннулирован, истёк или создан без необходимых разрешений.

Исправление

Проверьте статус токена и его права на GitHub. Токен должен принадлежать fine-grained personal access tokenвашему личному аккаунту (не организации) с Copilot разрешением запросов . При необходимости генерируйте новый токен с необходимыми правами.

Token (classic) отклонён

Маркер, начинающийся с ghp_ , отклоняется. Что происходит дальше, зависит от того, как работаете Copilot CLI.

В интерактивном сеансе классическая версия personal access token игнорируется, и интерфейс командной строки продолжает работать, поэтому вы можете пройти проверку подлинности другим способом, например с /loginпомощью. Copilot CLI Отображает предупреждение, как показано ниже, именование переменной среды, содержащей маркер:

Classic Personal Access Tokens (ghp_) are not supported. GITHUB_TOKEN contains a classic PAT and will be ignored. Use /login to authenticate, or replace it with a fine-grained PAT.

В неинтерактивном использовании, например copilot -p или другой автоматизации, если классическая personal access token версия является единственными доступными учетными данными, интерфейс командной строки отказывается запускать и отображает следующую ошибку, именуя переменную среды, содержащую маркер:

Error: Classic Personal Access Tokens (ghp_) are not supported by Copilot.

The GITHUB_TOKEN environment variable contains a classic PAT.
Please use a Fine-Grained Personal Access Token or another authentication method.

To fix this, you can:
  • Replace the token in GITHUB_TOKEN with a fine-grained PAT
  • Unset GITHUB_TOKEN and run 'gh auth login' to authenticate
  • Unset GITHUB_TOKEN and start 'copilot', then use the '/login' command

Причина

Классические personal access tokens не поддерживаются .Copilot CLI

Исправление

Сгенерируйте детализацию personal access token с необходимыми прицелами.

Access запрещён

Copilot CLI отображается одна из следующих ошибок:

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: 

Причина

Политика организации блокирует GitHub Copilot CLI, или учетная запись пользователя не имеет GitHub Copilot лицензии.

Исправление

• Проверьте, есть ли у вашего аккаунта активная GitHub Copilot лицензия.
• Попросите администратора вашей организации включить GitHub Copilot CLI политику организации.

Сбой keychain access

Во время входа CLI подспрашивает, что системный ключ недоступен, и спрашивает, хранить ли учетные данные в открытом тексте.

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

Причина

Системный брелок недоступен. Это может происходить на системах Linux без libsecretheadless-серверов или на системах с проблемой разрешения.

Исправление

Следуйте инструкциям вашей операционной системы для восстановления Secure Credential storage.

macOS или Windows

На macOS убедитесь, что доступно приложение Keychain Access, и вы сможете разблокировать свой брелок для входа. В Windows убедитесь, что доступен Менеджер учетных данных, и вы сможете получить доступ к хранилищу Windows. Если вы не можете access системный менеджер учетных данных, используйте открытый текст storage (если запросили) или аутентифицируйтесь с помощью токена переменной среды, затем перезапустите /login или copilot login.

Линукс

В Linux используйте системное кольцо ключей или сохраняйте учетные данные в открытом виде.

1. Проверьте, установлен secret-tool ли он:

   Bash

   command -v secret-tool
   

2. Если secret-tool не найдено или команда поиска не даёт результатов, установите libsecret и её зависимости. Например, на Debian и Ubuntu можно использовать следующую команду.»

   Bash

   sudo apt install libsecret-1-0 gnome-keyring seahorse
   

3. После secret-tool установки выполните поиск сохранённого учетного данных в кольце ключей:

   Bash

   secret-tool search copilot-cli
   

   Если команда возвращает один или несколько результатов, в брелоке существуют учетные данные. Запускайте copilot login в терминале или /login снова в Copilot CLI машине.

Неправильный аккаунт

Не тот пользователь аутентифицирован, либо токен принадлежит не той организации.

Причина

Хранится несколько аккаунтов, или переменная среды переопределяет сохранённый токен.

Исправление

Чтобы сменить аккаунт, используйте /user switch через CLI или выйдите с /logout нужным аккаунтом и запустите /login его.