Solución de problemas de la autenticación de GitHub Copilot en la CLI

Errores de autenticación

Si encuentra errores de autenticación, use la tabla siguiente para identificar la causa y la resolución.

          [No se encontró información de autenticación](#no-authentication-information-found)       |

| 401 No autorizado | Token revocado o permisos insuficientes | Generar token con permisos | Token expirado o revocado | | Token (classic) rechazado | Token (classic) (ghp_) | Usar personal access token específico | Token (classic) rechazado | | 403 Prohibido o denegado por política | Licencia de Copilot o directiva de empresa/organización | Verificar la suscripción y la configuración de la organización | Access denegado | | Cadena de claves no disponible | Falta la cadena de claves del sistema | Instalar libsecret o aceptar texto no cifrado | error de acceso al llavero | | Cuenta incorrecta | Cuentas múltiples o anulación de variables de entorno | Comprobar variables de entorno, usar /user switch | Cuenta incorrecta |

No se encontró información de autenticación

CLI de Copilot muestra el siguiente error:

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

Causa

No existen credenciales en ninguna de las ubicaciones comprobadas.

Corregir

Siga estos pasos para buscar dónde falta la autenticación y restaurar access.

Comprobación del estado de autenticación

gh auth status

gh auth status

Si ve un mensaje que indica que no ha iniciado sesión, inicie sesión con gh auth login o use el flujo de OAuth con copilot login.

Comprobación de si se ha establecido una variable de entorno de autenticación

Si usa una variable de entorno, compruebe si se establece la COPILOT_GITHUB_TOKENvariable de entorno , GH_TOKENo GITHUB_TOKEN :

echo $COPILOT_GITHUB_TOKEN

echo $COPILOT_GITHUB_TOKEN

Si el comando no imprime nada, la variable no se establece. Establezca la variable en un token válido. Para generar un token, consulte Autenticación de GitHub Copilot CLI.

 export $COPILOT_GITHUB_TOKEN=PERSONAL_ACCESS_TOKEN

 export $COPILOT_GITHUB_TOKEN=PERSONAL_ACCESS_TOKEN

Cadena de claves de macOS

security find-generic-password -s copilot-cli

security find-generic-password -s copilot-cli

Si no se encuentra ningún elemento, vuelva a autenticarse con /login o copilot login para crear uno. Si se encuentra un elemento, pero todavía se produce un error en la autenticación, quite la credencial guardada y vuelva a autenticarse con /login o copilot login:

  security delete-generic-password -s copilot-cli

  security delete-generic-password -s copilot-cli

Token expirado o revocado

CLI de Copilot muestra el siguiente error:

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

Causa

El token se revoca, ha expirado o se ha creado sin los permisos necesarios.

Corregir

Verifique el estado y los permisos del token en GitHub. El token debe tener el permiso Solicitudes de Copilot. Genere un nuevo token con los permisos necesarios si es necesario.

Token (classic) rechazado

Un token que comienza con ghp_ se ignora silenciosamente y el CLI se comporta como si no se hubiera establecido ningún token.

Causa

personal access tokens clásicos no son compatibles con CLI de Copilot.

Corregir

Genere un personal access token específico con los ámbitos necesarios.

Acceso denegado

CLI de Copilot muestra uno de los siguientes errores:

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: 

Causa

Una directiva de la organización bloquea CLI de GitHub Copilot, o la cuenta de usuario carece de una licencia de GitHub Copilot.

Corregir

• Compruebe que su cuenta tiene una licencia activa GitHub Copilot.
• Pida al administrador de la organización que habilite CLI de GitHub Copilot en la política de la organización.

Error de acceso al llavero

Durante el inicio de sesión, la CLI le pide que la cadena de claves del sistema no esté disponible y le pregunte si debe almacenar las credenciales en texto no cifrado.

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

Causa

No se puede acceder a la cadena de claves del sistema. Esto puede ocurrir en sistemas Linux sin libsecret, servidores sin encabezado o sistemas con problemas de permisos.

Corregir

Siga los pasos para que su sistema operativo restaure el almacenamiento seguro de credenciales.

macOS o Windows

En macOS, confirme que la aplicación keychain Access está disponible y puede desbloquear la cadena de claves de inicio de sesión. En Windows, confirme que el Administrador de credenciales está disponible y puede acceder a la bóveda de Windows. Si no puede acceder al administrador de credenciales del sistema, use almacenamiento de texto sin cifrar (si se le solicita) o autentique mediante un token de variable de entorno, luego ejecute nuevamente /login o copilot login.

Linux

En Linux, use el conjunto de claves del sistema o almacene las credenciales en texto no cifrado.

1. Compruebe si secret-tool está instalado:

   Bash

   command -v secret-tool
   

2. Si secret-tool no se encuentra o el comando de búsqueda no devuelve ningún resultado, instale libsecret y sus dependencias. Por ejemplo, en Debian y Ubuntu podría usar el siguiente comando".

   Bash

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

3. Una vez secret-tool instalado, busque el keyring para obtener una credencial guardada:

   Bash

   secret-tool search copilot-cli
   

   Si el comando devuelve uno o varios resultados, existen credenciales en el conjunto de claves. Vuelva a ejecutar copilot login en la terminal o /login en CLI de Copilot.

Cuenta incorrecta

El usuario incorrecto está autenticado o el token pertenece a la organización incorrecta.

Causa

Se almacenan varias cuentas o una variable de entorno reemplaza el token almacenado.

Corregir

Para cambiar de cuenta, use /user switch en la interfaz de línea de comandos (CLI) o cierre sesión con /logout y ejecute /login con la cuenta correcta.