{"meta":{"title":"GITHUB COPILOT CLI 인증 문제 해결","intro":"에 로그인 Copilot CLI할 때 인증 실패 진단","product":"GitHub Copilot","breadcrumbs":[{"href":"/ko/copilot","title":"GitHub Copilot"},{"href":"/ko/copilot/how-tos","title":"방법"},{"href":"/ko/copilot/how-tos/copilot-cli","title":"Copilot CLI"},{"href":"/ko/copilot/how-tos/copilot-cli/set-up-copilot-cli","title":"Copilot CLI 설정"},{"href":"/ko/copilot/how-tos/copilot-cli/set-up-copilot-cli/troubleshoot-copilot-cli-auth","title":"Copilot CLI 인증 문제 해결"}],"documentType":"article"},"body":"# GITHUB COPILOT CLI 인증 문제 해결\n\n에 로그인 Copilot CLI할 때 인증 실패 진단\n\n## 인증 오류\n\n인증 오류가 발생하는 경우 아래 표를 사용하여 원인과 해결 방법을 식별합니다.\n\n| 문제                                                     | 원인                            | 수정                                 | 추가 정보 |\n| ------------------------------------------------------ | ----------------------------- | ---------------------------------- | ----- |\n| 인증 정보를 찾을 수 없음                                         | 자격 증명이 저장되지 않음                |                                    |       |\n| `copilot login`을 실행합니다.                                |                               |                                    |       |\n| [인증 정보를 찾을 수 없음](#no-authentication-information-found) |                               |                                    |       |\n| 401 권한 없음                                              | 토큰이 해지되었거나 권한이 부족합니다.         | 사용 권한이 있는 토큰 생성                    |       |\n| [토큰이 만료되었거나 해지됨](#token-expired-or-revoked)            |                               |                                    |       |\n| Token (classic) 거부됨                                    |                               |                                    |       |\n| Token (classic)(`ghp_`)                                | 세분화된 personal access token 사용 |                                    |       |\n| \\[                                                     |                               |                                    |       |\n| Token (classic) 거부]\\(#token-classic-rejected)          |                               |                                    |       |\n| 403 금지 또는 정책 거부                                        |                               |                                    |       |\n| Copilot 라이선스 또는 엔터프라이즈/조직 정책                           | 구독 및 조직 설정 확인                 |                                    |       |\n| [Access 거부됨](#access-denied)                           |                               |                                    |       |\n| 키 집합을 사용할 수 없음                                         | 누락된 시스템 키체인                   |                                    |       |\n| `libsecret`을 설치하거나 일반 텍스트를 수락하십시오.                     |                               |                                    |       |\n| [키체인 접근 실패](#keychain-access-failure)                  |                               |                                    |       |\n| 잘못된 계정                                                 | 여러 계정 또는 환경 변수 재정의            | 환경 변수를 확인하고 `/user switch`를 사용하세요. |       |\n| [잘못된 계정](#wrong-account)                               |                               |                                    |       |\n\n## 인증 정보를 찾을 수 없음\n\nCopilot CLI 는 다음 오류를 표시합니다.\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### 원인\n\n선택한 위치에 자격 증명이 없습니다.\n\n### 수정\n\n다음 단계를 사용하여 인증이 누락된 위치를 찾고 access 복원합니다.\n\n#### 인증 상태 확인\n\n```bash copy\ngh auth status\n```\n\n로그인하지 않았음을 나타내는 메시지가 표시되면 `gh auth login`으로 로그인하세요. 또는 `copilot login`로 OAuth 흐름을 사용하세요.\n\n#### 인증 환경 변수가 설정되었는지 확인\n\n환경 변수를 사용하는 경우, `COPILOT_GITHUB_TOKEN`, `GH_TOKEN`, 또는 `GITHUB_TOKEN` 환경 변수가 설정되어 있는지 확인합니다.\n\n```bash copy\necho $COPILOT_GITHUB_TOKEN\n```\n\n명령이 아무 것도 인쇄하지 않으면 변수가 설정되지 않습니다. 변수를 유효한 토큰으로 설정합니다. 토큰을 생성하려면 [GitHub Copilot CLI를 인증하기](/ko/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#### macOS 키체인\n\n```bash copy\nsecurity find-generic-password -s copilot-cli\n```\n\n항목을 찾을 수 없는 경우 `/login` 또는 `copilot login`로 다시 인증하거나 새 항목을 만들 수 있습니다.\n항목을 찾았지만 인증이 여전히 실패하는 경우 저장된 자격 증명을 제거한 다음, 다음을 사용하여 `/login` 다시 인증합니다 `copilot login`.\n\n```bash copy\n  security delete-generic-password -s copilot-cli\n```\n\n## 토큰이 만료되었거나 해지됨\n\nCopilot CLI 는 다음 오류를 표시합니다.\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### 원인\n\n토큰이 해지되었거나, 만료되었거나, 필요한 권한 없이 만들어졌습니다.\n\n### 수정\n\n에 대한 토큰의 상태 및 사용 권한을 검토합니다 GitHub. 토큰은 요청 권한이 있는 fine-grained personal access token**개인 계정**(조직 아님)**Copilot** 이 소유해야 합니다. 필요한 경우 필요한 권한으로 새 토큰을 생성합니다.\n\n## Token (classic) 거부됨\n\n토큰으로 `ghp_` 시작하는 것은 자동으로 무시되고 CLI는 토큰이 설정되지 않은 것처럼 동작합니다.\n\n### 원인\n\n클래식 personal access tokens은 Copilot CLI에서 지원되지 않습니다.\n\n### 수정\n\n필요한 범위로 세분화된 personal access token 값을 생성합니다.\n\n## Access 거부됨\n\nCopilot CLI 는 다음 오류 중 하나를 표시합니다.\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### 원인\n\n조직 정책이 GitHub Copilot CLI를 차단하거나 사용자 계정에 GitHub Copilot 라이선스가 없습니다.\n\n### 수정\n\n* 계정에 활성 GitHub Copilot 라이선스가 있는지 확인합니다.\n* 조직 관리자가 조직 정책에서 GitHub Copilot CLI을(를) 사용하도록 요청하세요.\n\n## 키체인 액세스 실패\n\n로그인하는 동안 CLI는 시스템 키 집합을 사용할 수 없다는 메시지를 표시하고 자격 증명을 일반 텍스트로 저장할지 여부를 묻습니다.\n\n```text\nSystem keychain unavailable. Store token in plaintext config file? (y/N)\n```\n\n### 원인\n\n시스템 키 집합에 액세스할 수 없습니다. 이 문제는 사용 권한 문제가 있는 시스템 또는 헤드리스 서버가 없는 `libsecret`Linux 시스템에서 발생할 수 있습니다.\n\n### 수정\n\n운영 체제의 단계에 따라 보안 자격 증명 저장소를 복원하십시오.\n\n#### macOS 또는 Windows\n\nmacOS에서 키 집합 Access 앱을 사용할 수 있는지 확인하고 로그인 키 집합의 잠금을 해제할 수 있습니다.\nWindows에서 자격 증명 관리자가 사용 가능한지 확인하고, Windows 자격 증명 모음에 액세스할 수 있는지 확인하십시오.\n시스템 자격 증명 관리자에 접근할 수 없는 경우, 메시지가 표시되면 일반 텍스트 저장소를 사용하거나 환경 변수 토큰을 사용하여 인증한 다음 `/login` 또는 `copilot login`을 다시 실행합니다.\n\n#### 리눅스\n\nLinux에서 시스템 키 지정을 사용하거나 자격 증명을 일반 텍스트로 저장합니다.\n\n1. `secret-tool`이(가) 설치되어 있는지 확인합니다.\n\n   ```bash copy\n   command -v secret-tool\n   ```\n\n2. `secret-tool`를 찾을 수 없거나 검색 명령이 결과를 반환하지 않으면 `libsecret` 및 그 종속성을 설치하십시오. 예를 들어 Debian 및 Ubuntu에서는 다음 명령을 사용할 수 있습니다.\"\n\n   ```bash copy\n   sudo apt install libsecret-1-0 gnome-keyring seahorse\n   ```\n\n3. 설치되면 `secret-tool` 키링에서 저장된 자격 증명을 검색합니다.\n\n   ```bash copy\n   secret-tool search copilot-cli\n   ```\n\n   명령이 하나 이상의 결과를 반환하는 경우 자격 증명이 키링에 존재합니다. 터미널에서 `copilot login`을 실행하거나 `/login`에서 Copilot CLI을 다시 실행하세요.\n\n## 잘못된 계정\n\n잘못된 사용자가 인증되었거나 토큰이 잘못된 조직에 속합니다.\n\n### 원인\n\n여러 계정이 저장되거나 환경 변수가 저장된 토큰을 재정의합니다.\n\n### 수정\n\n계정을 전환하려면 CLI 프롬프트에서 `/user switch`을 사용하거나 `/logout`으로 로그아웃한 후 올바른 계정으로 `/login`을 실행하십시오."}