{"meta":{"title":"Solución de problemas de autenticación de la CLI de GitHub Copilot","intro":"Diagnosticar errores de autenticación al iniciar sesión en Copilot CLI.","product":"GitHub Copilot","breadcrumbs":[{"href":"/es/copilot","title":"GitHub Copilot"},{"href":"/es/copilot/how-tos","title":"Procedimientos"},{"href":"/es/copilot/how-tos/copilot-cli","title":"Copilot CLI"},{"href":"/es/copilot/how-tos/copilot-cli/set-up-copilot-cli","title":"Configuración de la CLI de Copilot"},{"href":"/es/copilot/how-tos/copilot-cli/set-up-copilot-cli/troubleshoot-copilot-cli-auth","title":"Solución de problemas de autenticación de la CLI de Copilot"}],"documentType":"article"},"body":"# Solución de problemas de autenticación de la CLI de GitHub Copilot\n\nDiagnosticar errores de autenticación al iniciar sesión en Copilot CLI.\n\n## Errores de autenticación\n\nSi encuentra errores de autenticación, use la tabla siguiente para identificar la causa y la resolución.\n\n| Cuestión                                                                            | Causa                                                          | Corregir                                            | Información adicional      |\n| ----------------------------------------------------------------------------------- | -------------------------------------------------------------- | --------------------------------------------------- | -------------------------- |\n| No se encontró información de autenticación                                         | Sin credenciales almacenadas                                   | Ejecute `copilot login`:                            |                            |\n| [No se encontró información de autenticación](#no-authentication-information-found) |                                                                |                                                     |                            |\n| 401 No autorizado                                                                   | Token revocado o permisos insuficientes                        | Generar token con permisos                          |                            |\n| [Token expirado o revocado](#token-expired-or-revoked)                              |                                                                |                                                     |                            |\n| Token (classic) rechazado                                                           |                                                                |                                                     |                            |\n| Token (classic) (`ghp_`)                                                            | Uso específico de personal access token                        |                                                     |                            |\n| \\[                                                                                  |                                                                |                                                     |                            |\n| Token (classic) rechazado]\\(#token-classic-rejected)                                |                                                                |                                                     |                            |\n| 403 Prohibido o denegado por política                                               |                                                                |                                                     |                            |\n| Copilot licencia o directiva de empresa/organización                                | Verificar la suscripción y la configuración de la organización |                                                     |                            |\n| [Access denegado](#access-denied)                                                   |                                                                |                                                     |                            |\n| Cadena de claves no disponible                                                      | Falta la cadena de claves del sistema                          | Instalar `libsecret` o aceptar texto no cifrado     | error de acceso al llavero |\n| Cuenta incorrecta                                                                   | Cuentas múltiples o anulación de variables de entorno          | Comprobar variables de entorno, usar `/user switch` |                            |\n| [Cuenta incorrecta](#wrong-account)                                                 |                                                                |                                                     |                            |\n\n## No se encontró información de autenticación\n\nCopilot CLI muestra el siguiente error:\n\n<!-- markdownlint-disable GHD005 -->\n\n```text\nError: No authentication information found\nCopilot can be authenticated with GitHub using an OAuth Token or a Fine-Grained Personal Access Token\n```\n\n<!-- markdownlint-enable GHD005 -->\n\n### Causa\n\nNo existen credenciales en ninguna de las ubicaciones comprobadas.\n\n### Corregir\n\nSiga estos pasos para buscar dónde falta la autenticación y restaurar access.\n\n#### Comprobación del estado de autenticación\n\n```bash copy\ngh auth status\n```\n\nSi 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`.\n\n#### Comprobación de si se ha establecido una variable de entorno de autenticación\n\nSi usa una variable de entorno, compruebe si se establece la `COPILOT_GITHUB_TOKEN`variable de entorno , `GH_TOKEN`o `GITHUB_TOKEN` :\n\n```bash copy\necho $COPILOT_GITHUB_TOKEN\n```\n\nSi 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 la CLI de GitHub Copilot](/es/copilot/how-tos/copilot-cli/set-up-copilot-cli/authenticate-copilot-cli#authenticating-with-environment-variables).\n\n```bash copy\n export $COPILOT_GITHUB_TOKEN=PERSONAL_ACCESS_TOKEN\n```\n\n#### Cadena de claves de macOS\n\n```bash copy\nsecurity find-generic-password -s copilot-cli\n```\n\nSi no se encuentra ningún elemento, vuelva a autenticarse con `/login` o `copilot login` para crear uno.\nSi 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`:\n\n```bash copy\n  security delete-generic-password -s copilot-cli\n```\n\n## Token expirado o revocado\n\nCopilot CLI muestra el siguiente error:\n\n<!-- markdownlint-disable GHD005 -->\n\n```text\nError: Authentication failed\n\nYour GitHub token may be invalid, expired, or lacking the required permissions.\n\nTo resolve this, try the following:\n  • Start 'copilot' and run the '${LOGIN_COMMAND}' command to re-authenticate\n  • If using a Fine-Grained PAT, ensure it has the 'Copilot Requests' permission enabled\n  • If using COPILOT_GITHUB_TOKEN, GH_TOKEN or GITHUB_TOKEN environment variable, verify the token is valid and not expired\n  • Run 'gh auth status' to check your current authentication status\n```\n\n<!-- markdownlint-enable GHD005 -->\n\n### Causa\n\nEl token se revoca, ha expirado o se ha creado sin los permisos necesarios.\n\n### Corregir\n\nRevise el estado y los permisos del token en GitHub. El token debe ser fine-grained personal access token propiedad de su **cuenta personal** (no de una organización) con el permiso de **Copilot Solicitudes**. Genere un nuevo token con los permisos necesarios si es necesario.\n\n## Token (classic) rechazado\n\nUn token que comienza con `ghp_` se ignora silenciosamente y el CLI se comporta como si no se hubiera establecido ningún token.\n\n### Causa\n\nEl clásico personal access tokens no es compatible con Copilot CLI.\n\n### Corregir\n\nGenere un personal access token específico con los ámbitos necesarios.\n\n## Acceso denegado\n\nCopilot CLI muestra uno de los siguientes errores:\n\n```text\nError: Access denied by policy settings\n\nYour Copilot CLI policy setting may be preventing access. This can happen when:\n  • Your organization has restricted Copilot access\n  • Your Copilot subscription does not include this feature\n  • Required policies have not been enabled by your administrator\n\nTo resolve this, visit your Copilot settings: \n```\n\n### Causa\n\nUna directiva de organización bloquea GitHub Copilot CLIo la cuenta de usuario carece de una GitHub Copilot licencia.\n\n### Corregir\n\n* Compruebe que su cuenta tiene una licencia activa GitHub Copilot .\n* Pida al administrador de la organización que habilite GitHub Copilot CLI en la directiva de la organización.\n\n## Error de acceso al llavero\n\nDurante 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.\n\n```text\nSystem keychain unavailable. Store token in plaintext config file? (y/N)\n```\n\n### Causa\n\nNo 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.\n\n### Corregir\n\nSiga los pasos para que su sistema operativo restaure el almacenamiento seguro de credenciales.\n\n#### macOS o Windows\n\nEn macOS, confirme que la aplicación keychain Access está disponible y puede desbloquear la cadena de claves de inicio de sesión.\nEn Windows, confirme que el Administrador de credenciales está disponible y puede acceder a la Bóveda de Windows.\nSi 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`.\n\n#### Linux\n\nEn Linux, use el conjunto de claves del sistema o almacene las credenciales en texto no cifrado.\n\n1. Compruebe si `secret-tool` está instalado:\n\n   ```bash copy\n   command -v secret-tool\n   ```\n\n2. 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\".\n\n   ```bash copy\n   sudo apt install libsecret-1-0 gnome-keyring seahorse\n   ```\n\n3. Una vez `secret-tool` instalado, busque el keyring para obtener una credencial guardada:\n\n   ```bash copy\n   secret-tool search copilot-cli\n   ```\n\n   Si el comando devuelve uno o varios resultados, existen credenciales en el conjunto de claves. Ejecute `copilot login` en la terminal o `/login` en Copilot CLI de nuevo.\n\n## Cuenta incorrecta\n\nEl usuario incorrecto está autenticado o el token pertenece a la organización incorrecta.\n\n### Causa\n\nSe almacenan varias cuentas o una variable de entorno reemplaza el token almacenado.\n\n### Corregir\n\nPara 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."}